Module imagingbook_plugins_book

Package Ch08_Binary_Regions

Class Region_Eccentricity_Ellipse_Demo

java.lang.Object

Ch08_Binary_Regions.Region_Eccentricity_Ellipse_Demo

All Implemented Interfaces:

PlugInFilter, JavaDocHelp

public class Region_Eccentricity_Ellipse_Demo
extends Object
implements PlugInFilter, JavaDocHelp

Performs binary region segmentation, then displays each region's major axis (scaled by eccentricity) and equivalent ellipse as a vector overlay. See Sec. 8.6.2 and 8.6.3 of [1] for additional details. This plugin expects a binary (black and white) image with background = 0 and foreground > 0. Display lookup tables (LUTs) are not considered. Eccentricity values are limited to MaxEccentricity, axes are marked red if exceeded. Axes for regions with NaN eccentricity value (single-pixel regions) are not displayed. Axis and ellipse parameters are calculated from the region's central moments. If no image is currently open, the plugin optionally loads a suitable sample image.

[1] W. Burger, M.J. Burge, Digital Image Processing – An Algorithmic Introduction, 3rd ed, Springer (2022).

Version:

2022/12/08

Field Summary

Fields

Modifier and Type	Field	Description
static Color	AxisColor	Color used for drawing the major axis.
static Color	AxisColorCLipped	Color used for drawing the major axis if maximum eccentricity exceeded.
static double	AxisEccentricityScale	Eccentricity scale factor applied to the length of the region's major axis.
static double	AxisLineWidth	Line width used for drawing the region's axes.
static Color	CenterColor	Color used for drawing the region's center.
static double	CenterLineWidth	Line width used for drawing the region's center.
static double	CenterMarkSize	Size (radius) of the region's center mark.
static Color	EllipseColor	Color used for drawing the region's equivalent ellipse.
static double	MaxEccentricity	Maximum eccentricity, greater eccentricity values are clipped.
static int	MinRegionSize	Minimum region size, smaller regions are ignored.
static NeighborhoodType2D	Neighborhood	Neighborhood type used for region segmentation (4- or 8-neighborhood).
static boolean	ShowCenterMark	Set true to show the regions's centroid.
static boolean	ShowEllipse	Set true to show the region's equivalent ellipse.
static boolean	ShowMajorAxis	Set true to show the region's major axis (length scaled by eccentricity).

Fields inherited from interface ij.plugin.filter.PlugInFilter

CONVERT_TO_FLOAT, DOES_16, DOES_32, DOES_8C, DOES_8G, DOES_ALL, DOES_RGB, DOES_STACKS, DONE, FINAL_PROCESSING, KEEP_THRESHOLD, NO_CHANGES, NO_IMAGE_REQUIRED, NO_UNDO, NO_UNDO_RESET, PARALLELIZE_IMAGES, PARALLELIZE_STACKS, ROI_REQUIRED, SNAPSHOT, STACK_REQUIRED, SUPPORTS_MASKING

Constructor Summary

Constructors

Constructor	Description
Region_Eccentricity_Ellipse_Demo()	Constructor, asks to open a predefined sample image if no other image is currently open.

Method Summary

Modifier and Type	Method	Description
void	run(ImageProcessor ip)
int	setup(String arg, ImagePlus im)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface imagingbook.core.jdoc.JavaDocHelp

getJavaDocUrl

Field Details

Neighborhood

public static NeighborhoodType2D Neighborhood

Neighborhood type used for region segmentation (4- or 8-neighborhood).

AxisEccentricityScale

public static double AxisEccentricityScale

Eccentricity scale factor applied to the length of the region's major axis.

MinRegionSize

public static int MinRegionSize

Minimum region size, smaller regions are ignored.

MaxEccentricity

public static double MaxEccentricity

Maximum eccentricity, greater eccentricity values are clipped.

AxisColor

public static Color AxisColor

Color used for drawing the major axis.

AxisColorCLipped

public static Color AxisColorCLipped

Color used for drawing the major axis if maximum eccentricity exceeded.

CenterColor

public static Color CenterColor

Color used for drawing the region's center.

EllipseColor

public static Color EllipseColor

Color used for drawing the region's equivalent ellipse.

AxisLineWidth

public static double AxisLineWidth

Line width used for drawing the region's axes.

CenterMarkSize

public static double CenterMarkSize

Size (radius) of the region's center mark.

CenterLineWidth

public static double CenterLineWidth

Line width used for drawing the region's center.

ShowCenterMark

public static boolean ShowCenterMark

Set true to show the regions's centroid.

ShowMajorAxis

public static boolean ShowMajorAxis

Set true to show the region's major axis (length scaled by eccentricity).

ShowEllipse

public static boolean ShowEllipse

Set true to show the region's equivalent ellipse.

Constructor Details

Region_Eccentricity_Ellipse_Demo

public Region_Eccentricity_Ellipse_Demo()

Constructor, asks to open a predefined sample image if no other image is currently open.

Method Details

setup

public int setup(String arg,
 ImagePlus im)

Specified by:

setup in interface PlugInFilter

run

public void run(ImageProcessor ip)

Specified by:

run in interface PlugInFilter