inra.ijpb.binary.conncomp

Class FloodFillComponentsLabeling3D

java.lang.Object

inra.ijpb.algo.AlgoStub

inra.ijpb.binary.conncomp.FloodFillComponentsLabeling3D

All Implemented Interfaces:

Algo, ConnectedComponentsLabeling3D

public class FloodFillComponentsLabeling3D
extends AlgoStub
implements ConnectedComponentsLabeling3D

Computes the labels of the connected components in a 3D binary image. The type of result is controlled by the bitDepth option. Uses a Flood-fill type algorithm. The image voxels are iterated, and each time a foreground voxel not yet associated with a label is encountered, its connected component is associated with a new label. Example of use:

    int conn = 6;
    int bitDepth = 16;
    FloodFillComponentsLabeling3D algo = new FloodFillComponentsLabeling3D(conn, bitDepth);
    DefaultAlgoListener.monitor(algo);
    ImageStack labels = algo.computeLabels(image);
    // or:
    FloodFillComponentsLabeling3D.Result res = algo.computeResult(image);
    ImageStack labels = res.labelMap; 
 

Author:

dlegland

See Also:

FloodFillComponentsLabeling, FloodFill3D

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	FloodFillComponentsLabeling3D.Result Data class that stores result of connected component labeling.

Constructor Summary

Constructors

Constructor and Description
FloodFillComponentsLabeling3D() Constructor with default connectivity 6 and default output bitdepth equal to 16.
FloodFillComponentsLabeling3D(int connectivity) Constructor specifying the connectivity and using default output bitdepth equal to 16.
FloodFillComponentsLabeling3D(int connectivity, int bitDepth) Constructor specifying the connectivity and the bitdepth of result label image

Method Summary

Modifier and Type	Method and Description
ij.ImageStack	computeLabels(ij.ImageStack image) Computes labels corresponding to connected components in input image.
FloodFillComponentsLabeling3D.Result	computeResult(ij.ImageStack image) Computes connected components labeling on the input binary image, and returns the results encapsulated into a Result class together with the largest label index.

Methods inherited from class inra.ijpb.algo.AlgoStub

addAlgoListener, fireProgressChanged, fireProgressChanged, fireStatusChanged, fireStatusChanged, removeAlgoListener

Methods inherited from class java.lang.Object

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

Methods inherited from interface inra.ijpb.algo.Algo

addAlgoListener, removeAlgoListener

Constructor Detail

FloodFillComponentsLabeling3D

public FloodFillComponentsLabeling3D()

Constructor with default connectivity 6 and default output bitdepth equal to 16.

FloodFillComponentsLabeling3D

public FloodFillComponentsLabeling3D(int connectivity)

Constructor specifying the connectivity and using default output bitdepth equal to 16.

Parameters:

connectivity - the connectivity of connected components (6 or 26)

FloodFillComponentsLabeling3D

public FloodFillComponentsLabeling3D(int connectivity,
                                     int bitDepth)

Constructor specifying the connectivity and the bitdepth of result label image

Parameters:

connectivity - the connectivity of connected components (6 or 26)

bitDepth - the bit depth of the result (8, 16, or 32)

Method Detail

computeLabels

public ij.ImageStack computeLabels(ij.ImageStack image)

Description copied from interface: ConnectedComponentsLabeling3D

Computes labels corresponding to connected components in input image.

Specified by:

computeLabels in interface ConnectedComponentsLabeling3D

Parameters:

image - binary image containing components

Returns:

the label image of the components

computeResult

public FloodFillComponentsLabeling3D.Result computeResult(ij.ImageStack image)

Computes connected components labeling on the input binary image, and returns the results encapsulated into a Result class together with the largest label index.

Parameters:

image - the input binary image

Returns:

an instance of the Result class that can be used to retrieve the label map.