de.unihalle.informatik.MiToBo.features.contours

Class Contour2DConcavityCalculator

java.lang.Object

de.unihalle.informatik.Alida.operator.ALDOperator

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

de.unihalle.informatik.MiToBo.features.contours.Contour2DConcavityCalculator

All Implemented Interfaces:

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

@ALDAOperator(genericExecutionMode=ALL)
public class Contour2DConcavityCalculator
extends MTBOperator

Class for calculating concaveness of contour pixels according to the method proposed in: Fernandez, G., Kunt, M. & Zryd, J.P. (1995) A new plant image segmentation algorithm. Proceedings of the Eighth International Conference on Image Analysis and Processing, San Remo, Italy, pp. 229-234.

Author:

glass

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 Vector<double[]>	concavenessValues
private MTBContour2DSet	contours
private MTBContour2DSet	contourWorkSet
private Boolean	eightconnected
private MTBImage	inImg
private Boolean	normalizeConcavities Normalize values by scaling them to a range of [0,1].
private Integer	radius
private MTBImage	resultImg Result image with concavity values.

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

completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider

Constructor Summary

Constructors

Constructor and Description
Contour2DConcavityCalculator()
Contour2DConcavityCalculator(MTBImage inImg)
Contour2DConcavityCalculator(MTBImage inImg, int radius, boolean eightconnected)
Contour2DConcavityCalculator(MTBImage inImg, MTBContour2DSet contours, int radius, boolean eightconnected)

Method Summary

Modifier and Type	Method and Description
private int	concaveness(int x, int y)
private int[]	getConcaveness(Vector<Point2D.Double> points)
Vector<double[]>	getConcavenessValues()
MTBImage	getResultImage()
protected void	operate()
void	setContours(MTBContour2DSet cset) Specify optional input contours.
void	setNormalize(Boolean b) Enable/disable normalization.
void	setRadius(int r) Specify radius of local mask.

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, validateCustom, validateGeneric, writeHistory, writeHistory, writeHistory

Methods inherited from class java.lang.Object

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

Field Detail

inImg

@Parameter(label="input image",
           required=true,
           direction=IN,
           supplemental=false,
           description="input image")
private MTBImage inImg

contours

@Parameter(label="contours",
           required=false,
           direction=IN,
           supplemental=false,
           description="contours whose concaveness has to be calculated")
private MTBContour2DSet contours

radius

@Parameter(label="radius",
           required=false,
           direction=IN,
           supplemental=false,
           description="radius of considered neighbors")
private Integer radius

eightconnected

@Parameter(label="is foreground eightconnected",
           required=false,
           direction=IN,
           supplemental=false,
           description="are foreground pixels 8-connected or 4-connected")
private Boolean eightconnected

normalizeConcavities

@Parameter(label="Normalize values to [0,1]?",
           direction=IN,
           supplemental=false,
           description="Normalize values by radius and use local average?")
private Boolean normalizeConcavities

Normalize values by scaling them to a range of [0,1].

In the original paper the values are given by the sum of the concavity values of each three adjacent contour pixels. Each concavity value is equal to the number of pixels in the neighborhood of the contour pixel which lie inside the region. The neighborhood size is defined by the given radius.

In case of normalization the neighborhood size is used as normalization factor and the average of each three adjacent concavity values is used. Thus, the resulting values are scaled to a range of [0,1].

resultImg

@Parameter(label="result image",
           required=true,
           direction=OUT,
           supplemental=false,
           description="resulting image")
private MTBImage resultImg

Result image with concavity values.

If non-normalized concavity values are to be computed, the returned image is of type MTBImageInt, in case of normalized values it is of type MTBImageDouble.

concavenessValues

@Parameter(label="concavenessValues",
           required=true,
           direction=OUT,
           supplemental=false,
           description="resulting concaveness values for each region")
private Vector<double[]> concavenessValues

contourWorkSet

private MTBContour2DSet contourWorkSet

Constructor Detail

Contour2DConcavityCalculator

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

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Contour2DConcavityCalculator

public Contour2DConcavityCalculator(MTBImage inImg)
                             throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException,
                                    de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

Contour2DConcavityCalculator

public Contour2DConcavityCalculator(MTBImage inImg,
                                    int radius,
                                    boolean eightconnected)
                             throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException,
                                    de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

Contour2DConcavityCalculator

public Contour2DConcavityCalculator(MTBImage inImg,
                                    MTBContour2DSet contours,
                                    int radius,
                                    boolean eightconnected)
                             throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Method Detail

setContours

public void setContours(MTBContour2DSet cset)

Specify optional input contours.

Parameters:

cset - Set of contours.

setRadius

public void setRadius(int r)

Specify radius of local mask.

Parameters:

r - Radius of mask for concavity analysis.

setNormalize

public void setNormalize(Boolean b)

Enable/disable normalization.

Parameters:

b - If true, normalization is enabled.

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

getConcaveness

private int[] getConcaveness(Vector<Point2D.Double> points)

Parameters:

points - contour points

inImg - binary image

Returns:

array containing concaveness values for the given input contour points

concaveness

private int concaveness(int x,
                        int y)

Parameters:

x -

y -

img -

radius -

Returns:

getResultImage

public MTBImage getResultImage()

getConcavenessValues

public Vector<double[]> getConcavenessValues()