Module imagingbook_plugins_book

Package Ch08_Binary_Regions

Class Region_Segmentation_Demo

java.lang.Object

Ch08_Binary_Regions.Region_Segmentation_Demo

All Implemented Interfaces:

PlugInFilter, JavaDocHelp

public class Region_Segmentation_Demo
extends Object
implements PlugInFilter, JavaDocHelp

This ImageJ plugin demonstrates the use of various region labeling techniques provided by the imagingbook "regions" package:

• BreadthFirstSegmentation,
• DepthFirstSegmentation,
• RecursiveSegmentation,
• RegionContourSegmentation,
• SequentialSegmentation.

See Sec. 8.1 of [1] for additional details. One of four labeling types can be selected (see the run(ImageProcessor) method). All methods should produce the same results (except RegionContourSegmentation, which may run out of memory easily). Requires a binary image. Zero-value pixels are considered background, all other pixels are foreground. Display lookup tables (LUTs) are not considered. The plugin creates a new image with connected components either randomly-colored or region labels shown as gray values. The original image is not modified. 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:

2020/12/20, 2022/09/28 revised

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	Region_Segmentation_Demo.SegmentationMethod	Enum type for various region labeling methods.

Field Summary

Fields

Modifier and Type	Field	Description
static boolean	ColorComponents	Set true to randomly color segmented regions.
static boolean	ListRegions	Set true to to list segmented regions to the console.
static Region_Segmentation_Demo.SegmentationMethod	Method	The region labeling method to be used.
static NeighborhoodType2D	Neighborhood	Neighborhood type used for region segmentation (4- or 8-neighborhood).
static int	RandomSeed

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_Segmentation_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

Method

public static Region_Segmentation_Demo.SegmentationMethod Method

The region labeling method to be used.

Neighborhood

public static NeighborhoodType2D Neighborhood

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

ColorComponents

public static boolean ColorComponents

Set true to randomly color segmented regions.

ListRegions

public static boolean ListRegions

Set true to to list segmented regions to the console.

RandomSeed

public static int RandomSeed

Constructor Details

Region_Segmentation_Demo

public Region_Segmentation_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