de.unihalle.informatik.MiToBo.segmentation.regions.filling

Class FillHoles2D

java.lang.Object

de.unihalle.informatik.Alida.operator.ALDOperator

de.unihalle.informatik.MiToBo.core.operator.MTBOperator

de.unihalle.informatik.MiToBo.segmentation.regions.filling.FillHoles2D

All Implemented Interfaces:

de.unihalle.informatik.Alida.datatypes.ALDConfigurationValidator, de.unihalle.informatik.Alida.operator.events.ALDOperatorExecutionProgressEventListener, EventListener, loci.common.StatusReporter

@ALDAOperator(genericExecutionMode=ALL,
              level=STANDARD,
              shortDescription="Fills holes in connected components of binary or label images.")
public class FillHoles2D
extends MTBOperator
implements loci.common.StatusReporter

Operator to fill holes in connected components of binary or label images.

If there is only a single grey value besides the background (of zero) the input image is assumed to be binary, otherwise a label image.

If the input image is a label image each label is assumed to constitute one connected component, i.e. one region. Otherwise the result of the operator is undefined.

If the input image is binary conncected components are detected an filled.

Author:

gress, posch

Nested Class Summary

Nested classes/interfaces inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

de.unihalle.informatik.Alida.operator.ALDOperator.HidingMode, de.unihalle.informatik.Alida.operator.ALDOperator.HistoryConstructionMode

Field Summary

Fields

Modifier and Type	Field and Description
private MTBImage	inImg Input image.
private Vector<loci.common.StatusListener>	m_statusListeners vector of installed StatusListeners
private static String	opIdentifier Identifier for outputs in verbose mode.
private MTBImage	resultImg Result image.

Fields inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider

Constructor Summary

Constructors

Constructor and Description
FillHoles2D() Default constructor.
FillHoles2D(MTBImage img) Constructor with input image.

Method Summary

Modifier and Type	Method and Description
void	addStatusListener(loci.common.StatusListener statuslistener)
String	getDocumentation()
MTBImage	getInputImage() Get reference to the current input image.
MTBImage	getResultImage() Get the resulting image.
void	notifyListeners(loci.common.StatusEvent e)
protected void	operate()
private void	paintFilledRegion(MTBRegion2D reg, MTBImage img, MTBImage outImg) Draw a region without holes to an image.
private void	paintFilledRegionsBinary(MTBImage img, MTBImage outImg, int v) Close holes in binary image.
protected Object	readResolve() Init function for deserialized objects.
void	removeStatusListener(loci.common.StatusListener statuslistener)
void	setInputImage(MTBImage inputImage) Set input image.
protected void	setResultImage(MTBImage resultImage) Set the result image.
void	validateCustom()

Methods inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

addOperatorExecutionProgressEventListener, addParameter, addParameter, addParameterUnconditioned, fieldContained, fireOperatorExecutionProgressEvent, getALDPortHashAccessKey, getConstructionMode, getHidingMode, getInactiveParameterNames, getInInoutNames, getInInoutNames, getInNames, getInOutNames, getMissingRequiredInputs, getName, getNumParameters, getOutInoutNames, getOutNames, getParameter, getParameterDescriptor, getParameterDescriptorUnconditioned, getParameterNames, getParameterUnconditioned, getSupplementalNames, getVerbose, getVersion, handleOperatorExecutionProgressEvent, hasInOutParameters, hasParameter, isAnnotatedParameter, isConfigured, print, print, print, printInterface, printInterface, readHistory, reinitializeParameterDescriptors, removeOperatorExecutionProgressEventListener, removeParameter, runOp, runOp, runOp, setConstructionMode, setConstructionMode, setConstructionMode, setHidingMode, setName, setParameter, setParameterUnconditioned, setVerbose, toStringVerbose, unconfiguredItems, validate, validateGeneric, writeHistory, writeHistory, writeHistory

Methods inherited from class java.lang.Object

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

Field Detail

opIdentifier

private static final String opIdentifier

Identifier for outputs in verbose mode.

See Also:

Constant Field Values

inImg

@Parameter(label="Input image",
           required=true,
           direction=IN,
           mode=STANDARD,
           dataIOOrder=1,
           description="Input image, binary or label image")
private transient MTBImage inImg

Input image.

resultImg

@Parameter(label="Result image",
           required=true,
           direction=OUT,
           mode=STANDARD,
           dataIOOrder=2,
           description="Result image")
private transient MTBImage resultImg

Result image.

m_statusListeners

private transient Vector<loci.common.StatusListener> m_statusListeners

vector of installed StatusListeners

Constructor Detail

FillHoles2D

public FillHoles2D()
            throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Default constructor.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException - Thrown in case of failure.

FillHoles2D

public FillHoles2D(MTBImage img)
            throws IllegalArgumentException,
                   de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Constructor with input image.

Parameters:

img - Image to process.

Throws:

IllegalArgumentException - Thrown in case of failure.

de.unihalle.informatik.Alida.exceptions.ALDOperatorException - Thrown in case of failure.

Method Detail

validateCustom

public void validateCustom()
                    throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Overrides:

validateCustom in class de.unihalle.informatik.Alida.operator.ALDOperator

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

readResolve

protected Object readResolve()

Init function for deserialized objects.

This function is called on an instance of this class being deserialized from file, prior to handing the instance over to the user. It takes care of a proper initialization of transient member variables as they are not initialized to the default values during deserialization.

Overrides:

readResolve in class MTBOperator

Returns:

Initialized object.

getInputImage

public MTBImage getInputImage()

Get reference to the current input image.

Returns:

Current input image.

setInputImage

public void setInputImage(MTBImage inputImage)

Set input image.

Parameters:

inputImage - Input image to process.

getResultImage

public MTBImage getResultImage()

Get the resulting image.

Returns:

Result image with holes filled.

setResultImage

protected void setResultImage(MTBImage resultImage)

Set the result image.

Parameters:

resultImage - Set result image variable.

operate

protected void operate()
                throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException,
                       de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

Specified by:

operate in class de.unihalle.informatik.Alida.operator.ALDOperator

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

paintFilledRegionsBinary

private void paintFilledRegionsBinary(MTBImage img,
                                      MTBImage outImg,
                                      int v)
                               throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException,
                                      de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

Close holes in binary image.

In a binary image the foreground regions are in white, while background and holes are black. The difference between holes and background is given by the fact that holes have to be completely enclosed by a region, thus, never touch the image boundary.

The method first inverts the image and then labels the background and hole components. Afterwards all regions are checked for contact with the image boundary, and if there is no contact the region is identified as a hole region and drawn to the output image.

Parameters:

img - Binary region image with holes (in black).

outImg - Binary region image without holes (regions in white).

v - Value of foreground in input/result image.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException - Thrown in case of failure.

de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException - Thrown in case of failure.

paintFilledRegion

private void paintFilledRegion(MTBRegion2D reg,
                               MTBImage img,
                               MTBImage outImg)
                        throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException,
                               de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

Draw a region without holes to an image.

Parameters:

reg - Region to draw.

img - Original input image.

outImg - Image where to draw it.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException - Thrown in case of failure.

de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException - Thrown in case of failure.

addStatusListener

public void addStatusListener(loci.common.StatusListener statuslistener)

Specified by:

addStatusListener in interface loci.common.StatusReporter

notifyListeners

public void notifyListeners(loci.common.StatusEvent e)

Specified by:

notifyListeners in interface loci.common.StatusReporter

removeStatusListener

public void removeStatusListener(loci.common.StatusListener statuslistener)

Specified by:

removeStatusListener in interface loci.common.StatusReporter

getDocumentation

public String getDocumentation()

Overrides:

getDocumentation in class de.unihalle.informatik.Alida.operator.ALDOperator