de.unihalle.informatik.MiToBo.segmentation.contours.extraction

Class BordersOnLabeledComponents

java.lang.Object

de.unihalle.informatik.Alida.operator.ALDOperator

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

de.unihalle.informatik.MiToBo.segmentation.contours.extraction.BordersOnLabeledComponents

All Implemented Interfaces:

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

@ALDAOperator(genericExecutionMode=ALL,
              level=APPLICATION)
public class BordersOnLabeledComponents
extends MTBOperator

Class to extract borders from connected components.

Contrary to contours, for example extracted by the operator ContourOnLabeledComponents, the borders extracted by this operator contain unordered sets of pixels, i.e. the border elements are neither clockwise nor counter-clockwise sorted. The main advantage of this operator is that it is faster than the counterpart, and very often there is no need for ordered contours, but unordered contours are sufficient for the task at hand.

The operator allows to extract outer borders, inner borders or both. If only inner borders are to be extracted a border set is returned which contains empty outer dummy borders which contain the inner borders. This way the inner borders are grouped according to the regions they belong to. But, note that this behavior is different from the ContourOnLabeledComponents operator.

This operator takes a label image as input interpreting all pixels with values larger than zero as foreground pixels. Alternatively you can supply a region set. If both are given, the operator assumes that label image and region set are consistent.

Author:

moeller

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BordersOnLabeledComponents.BorderType Possible types of borders to be extracted.

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 BordersOnLabeledComponents.BorderType	borderType Type of borders to be extracted.
private MTBBorder2D.BorderConnectivity	connectivity Connectivity within resulting borders.
private int	height Image height.
private MTBImage	inputImage (Optional) input image where the borders should be extracted from.
private MTBRegion2DSet	inputRegions (Optional) region set where the borders should be extracted from.
private int	minimalBorderLength Lower threshold for border length.
private MTBBorder2DSet	resultBorders Set of extracted borders.
private MTBImageShort	resultImage Image of extracted borders.
private int	width Image width.

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

completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider

Constructor Summary

Constructors

Constructor and Description
BordersOnLabeledComponents() Standard constructor.
BordersOnLabeledComponents(MTBImage inImg, MTBRegion2DSet inRegions, MTBBorder2D.BorderConnectivity con, BordersOnLabeledComponents.BorderType type, int minLength) Constructor.

Method Summary

Modifier and Type	Method and Description
protected void	drawBordersToImage() Draws result contours to an image.
protected void	extractBorders() Extract requested borders for given input data.
MTBBorder2DSet	getResultBorders() Get result borders.
MTBImageShort	getResultImage() Get result image with extracted borders.
protected void	operate()
void	setBorderType(BordersOnLabeledComponents.BorderType type) Set border type to be extracted.
void	setConnectivity(MTBBorder2D.BorderConnectivity bc) Specify connectivity for extracted border pixels.
void	setInputImage(MTBImage inImg) Set input image.
void	setInputRegions(MTBRegion2DSet inRegions) Set input regions.
void	setMinimalBorderLength(int length) Set the minimal border length.
void	validateCustom()

Methods inherited from class de.unihalle.informatik.MiToBo.core.operator.MTBOperator

readResolve

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

addOperatorExecutionProgressEventListener, addParameter, addParameter, addParameterUnconditioned, fieldContained, fireOperatorExecutionProgressEvent, getALDPortHashAccessKey, getConstructionMode, getDocumentation, 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

borderType

@Parameter(label="Border Type",
           required=true,
           dataIOOrder=0,
           direction=IN,
           description="Border type.")
private BordersOnLabeledComponents.BorderType borderType

Type of borders to be extracted.

inputImage

@Parameter(label="Input Image",
           required=false,
           dataIOOrder=0,
           direction=IN,
           description="Input image.")
private transient MTBImage inputImage

(Optional) input image where the borders should be extracted from.

inputRegions

@Parameter(label="Input Regions",
           required=false,
           dataIOOrder=1,
           direction=IN,
           description="Input regions.")
private transient MTBRegion2DSet inputRegions

(Optional) region set where the borders should be extracted from.

connectivity

@Parameter(label="Desired connectivity of border pixels",
           required=false,
           dataIOOrder=2,
           direction=IN,
           description="Desired connectivity of border pixels.")
private MTBBorder2D.BorderConnectivity connectivity

Connectivity within resulting borders.

Default is 8-neighborhood.

minimalBorderLength

@Parameter(label="Minimal Length",
           required=false,
           dataIOOrder=3,
           direction=IN,
           description="Minimum length of borders.")
private int minimalBorderLength

Lower threshold for border length.

Allows to exclude too short borders from the result set, result only contains borders with length greater or equal threshold.

resultImage

@Parameter(label="Result Image",
           dataIOOrder=0,
           direction=OUT,
           description="Result image with extracted borders.")
private transient MTBImageShort resultImage

Image of extracted borders.

Outer borders are labeled sequentially, inner borders are marked gray.

resultBorders

@Parameter(label="Result Borders",
           dataIOOrder=1,
           direction=OUT,
           description="Resulting set of borders.")
private transient MTBBorder2DSet resultBorders

Set of extracted borders.

A border can include additional inner borders.

width

private transient int width

Image width.

height

private transient int height

Image height.

Constructor Detail

BordersOnLabeledComponents

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

Standard constructor.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

BordersOnLabeledComponents

public BordersOnLabeledComponents(MTBImage inImg,
                                  MTBRegion2DSet inRegions,
                                  MTBBorder2D.BorderConnectivity con,
                                  BordersOnLabeledComponents.BorderType type,
                                  int minLength)
                           throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Constructor.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Method Detail

setInputImage

public void setInputImage(MTBImage inImg)

Set input image.

Parameters:

Image - to process.

setInputRegions

public void setInputRegions(MTBRegion2DSet inRegions)

Set input regions.

Parameters:

Regions - to process.

setConnectivity

public void setConnectivity(MTBBorder2D.BorderConnectivity bc)

Specify connectivity for extracted border pixels.

Parameters:

bc - Connectivity.

setBorderType

public void setBorderType(BordersOnLabeledComponents.BorderType type)

Set border type to be extracted.

Parameters:

Type - of borders to be extracted.

setMinimalBorderLength

public void setMinimalBorderLength(int length)

Set the minimal border length.

Parameters:

length - Minimal length of borders to be extracted.

getResultImage

public MTBImageShort getResultImage()

Get result image with extracted borders.

Returns:

Image with borders.

getResultBorders

public MTBBorder2DSet getResultBorders()

Get result borders.

Returns:

Set of extracted borders.

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

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

extractBorders

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

Extract requested borders for given input data.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

drawBordersToImage

protected void drawBordersToImage()

Draws result contours to an image.