net.imglib2.algorithm.labeling

Class ConnectedComponents

java.lang.Object

net.imglib2.algorithm.labeling.ConnectedComponents

public final class ConnectedComponents
extends Object

Label all connected components of a binary image.

Author:

Tobias Pietzsch

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConnectedComponents.StructuringElement

Constructor Summary

Constructors

Constructor and Description
ConnectedComponents()

Method Summary

Modifier and Type	Method and Description
static <T extends net.imglib2.type.numeric.IntegerType<T>,L,I extends net.imglib2.type.numeric.IntegerType<I>> void	labelAllConnectedComponents(net.imglib2.RandomAccessible<T> input, net.imglib2.roi.labeling.ImgLabeling<L,I> labeling, Iterator<L> labelGenerator, ConnectedComponents.StructuringElement se) Label all connected components in the given input image.
static <T extends net.imglib2.type.numeric.IntegerType<T>,L,I extends net.imglib2.type.numeric.IntegerType<I>> void	labelAllConnectedComponents(net.imglib2.RandomAccessible<T> input, net.imglib2.roi.labeling.ImgLabeling<L,I> labeling, Iterator<L> labelGenerator, ConnectedComponents.StructuringElement se, ExecutorService service) Label all connected components in the given input image.
static <T extends net.imglib2.type.numeric.IntegerType<T>,L extends net.imglib2.type.numeric.IntegerType<L>> int	labelAllConnectedComponents(net.imglib2.RandomAccessible<T> input, net.imglib2.RandomAccessibleInterval<L> output, ConnectedComponents.StructuringElement se) "Label" all connected components in the given input image.
static <T extends net.imglib2.type.numeric.IntegerType<T>,L extends net.imglib2.type.numeric.IntegerType<L>> int	labelAllConnectedComponents(net.imglib2.RandomAccessible<T> input, net.imglib2.RandomAccessibleInterval<L> output, ConnectedComponents.StructuringElement se, ExecutorService service) "Label" all connected components in the given input image.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConnectedComponents

public ConnectedComponents()

Method Detail

labelAllConnectedComponents

public static <T extends net.imglib2.type.numeric.IntegerType<T>,L,I extends net.imglib2.type.numeric.IntegerType<I>> void labelAllConnectedComponents(net.imglib2.RandomAccessible<T> input,
                                                                                                                                                       net.imglib2.roi.labeling.ImgLabeling<L,I> labeling,
                                                                                                                                                       Iterator<L> labelGenerator,
                                                                                                                                                       ConnectedComponents.StructuringElement se)

Label all connected components in the given input image. In the output image, all background pixels will be labeled to {} and foreground components labeled as {1}, {2}, {3}, etc. where 1, 2, 3 are labels returned by labelGenerator.next(). labelGenerator.next() is called exactly n times if the input contains n connected components.

Parameters:

input - input image with pixels != 0 belonging to foreground.

labeling - output labeling in which the connected components will be labeled.

labelGenerator - produces labels for the connected components.

se - structuring element to use. 8-connected or 4-connected (respectively n-dimensional analog)

labelAllConnectedComponents

public static <T extends net.imglib2.type.numeric.IntegerType<T>,L,I extends net.imglib2.type.numeric.IntegerType<I>> void labelAllConnectedComponents(net.imglib2.RandomAccessible<T> input,
                                                                                                                                                       net.imglib2.roi.labeling.ImgLabeling<L,I> labeling,
                                                                                                                                                       Iterator<L> labelGenerator,
                                                                                                                                                       ConnectedComponents.StructuringElement se,
                                                                                                                                                       ExecutorService service)

Label all connected components in the given input image. In the output image, all background pixels will be labeled to {} and foreground components labeled as {1}, {2}, {3}, etc. where 1, 2, 3 are labels returned by labelGenerator.next(). labelGenerator.next() is called exactly n times if the input contains n connected components.

Parameters:

input - input image with pixels != 0 belonging to foreground.

labeling - output labeling in which the connected components will be labeled.

labelGenerator - produces labels for the connected components.

se - structuring element to use. 8-connected or 4-connected (respectively n-dimensional analog)

service - service providing threads for multi-threading

labelAllConnectedComponents

public static <T extends net.imglib2.type.numeric.IntegerType<T>,L extends net.imglib2.type.numeric.IntegerType<L>> int labelAllConnectedComponents(net.imglib2.RandomAccessible<T> input,
                                                                                                                                                    net.imglib2.RandomAccessibleInterval<L> output,
                                                                                                                                                    ConnectedComponents.StructuringElement se)

"Label" all connected components in the given input image. In the output image, all background pixels will be set to 0 and foreground components set to 1, 2, 3, etc.

Note, that the output image must be cleared to 0!

Parameters:

input - input image with pixels > 0 belonging to foreground.

output - output image, must be filled with 0.

se - structuring element to use. 8-connected or 4-connected (respectively n-dimensional analog)

Returns:

the number of connected components (that is, the highest value occurring in the output image.

labelAllConnectedComponents

public static <T extends net.imglib2.type.numeric.IntegerType<T>,L extends net.imglib2.type.numeric.IntegerType<L>> int labelAllConnectedComponents(net.imglib2.RandomAccessible<T> input,
                                                                                                                                                    net.imglib2.RandomAccessibleInterval<L> output,
                                                                                                                                                    ConnectedComponents.StructuringElement se,
                                                                                                                                                    ExecutorService service)

"Label" all connected components in the given input image. In the output image, all background pixels will be set to 0 and foreground components set to 1, 2, 3, etc.

Note, that the output image must be cleared to 0!

Parameters:

input - input image with pixels > 0 belonging to foreground.

output - output image, must be filled with 0.

se - structuring element to use. 8-connected or 4-connected (respectively n-dimensional analog)

service - service providing threads for multi-threading

Returns:

the number of connected components (that is, the highest value occurring in the output image.