de.unihalle.informatik.MiToBo.morphology

Class HDomeTransform3D

java.lang.Object

de.unihalle.informatik.Alida.operator.ALDOperator

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

de.unihalle.informatik.MiToBo.morphology.HDomeTransform3D

All Implemented Interfaces:

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

@ALDAOperator(genericExecutionMode=ALL,
              level=STANDARD)
public class HDomeTransform3D
extends MTBOperator

H-dome transform in 3D (straightforward use with 2D-images). The h-dome transform finds regional maxima, which means connected components D of an image I with following properties: - every pixel p neighbor of D satisfies: I(p) < min{ I(q) | q element of D} - max{ I(q) | q element of D} - min{ I(q) | q element of D} < h [Vincent93] The implementation follows the work of Luc Vincent: [Vincent93] Luc Vincent "Morphological Grayscale Reconstruction in Image Analysis: Applications and Efficient Algorithms" in IEEE Transactions on Image Processing, Vol. 2, No. 2, pp. 176-201, April 1993

Author:

gress

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 Double	h
private MTBImage	inputImage
private MTBImage	resultImage

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

completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider

Constructor Summary

Constructors

Constructor and Description
HDomeTransform3D() Constructor
HDomeTransform3D(MTBImage img, double h) Constructor

Method Summary

Modifier and Type	Method and Description
double	getH() Get current h-parameter (max height of the h-domes).
MTBImage	getInputImage() Get reference to the current input image.
MTBImage	getResultImage() Get the resulting h-dome image.
protected void	hybridGrayscaleReconstruct(MTBImage mask, MTBImage marker) Implements the fast hybrid grayscale reconstruction algo of [Vincent93].
protected void	operate()
void	setH(double h) Set current h-parameter (max height of the h-domes).
void	setInputImage(MTBImage img) Set input image
protected void	setResultImage(MTBImage resultImage) Set the result image.
protected MTBImage	transform(MTBImage img, double h) Compute the h-dome transform
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

h

@Parameter(label="h",
           required=true,
           direction=IN,
           mode=STANDARD,
           dataIOOrder=2,
           description="Dome height parameter")
private Double h

inputImage

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

resultImage

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

Constructor Detail

HDomeTransform3D

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

Constructor

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

HDomeTransform3D

public HDomeTransform3D(MTBImage img,
                        double h)
                 throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Constructor

Parameters:

img - input image

h - max size of h-domes

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Method Detail

getInputImage

public MTBImage getInputImage()

Get reference to the current input image.

setInputImage

public void setInputImage(MTBImage img)

Set input image

getH

public double getH()

Get current h-parameter (max height of the h-domes).

setH

public void setH(double h)

Set current h-parameter (max height of the h-domes).

getResultImage

public MTBImage getResultImage()

Get the resulting h-dome image.

setResultImage

protected void setResultImage(MTBImage resultImage)

Set the result image.

operate

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

Specified by:

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

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

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

transform

protected MTBImage transform(MTBImage img,
                             double h)

Compute the h-dome transform

Parameters:

img - input image

h - max height of h-domes

Returns:

h-dome image

hybridGrayscaleReconstruct

protected void hybridGrayscaleReconstruct(MTBImage mask,
                                          MTBImage marker)

Implements the fast hybrid grayscale reconstruction algo of [Vincent93]. Mask image (I) corresponds to the input image, marker image determines the marker (J). Remember that J <= I everywhere in the image. Result is stored in marker!!

Parameters:

mask -

marker -