de.unihalle.informatik.MiToBo.morphology

Class BasicMorphology

java.lang.Object

de.unihalle.informatik.Alida.operator.ALDOperator

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

de.unihalle.informatik.MiToBo.morphology.BasicMorphology

All Implemented Interfaces:

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

@ALDAOperator(genericExecutionMode=ALL,
              level=APPLICATION,
              shortDescription="Basic morphological operations on binary and grayscale images.")
public class BasicMorphology
extends MTBOperator

class implementing basic morphological operations (for use with grayscale as well as with binary images)

Author:

glass

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BasicMorphology.maskShape
static class	BasicMorphology.opMode

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 BasicMorphology.maskShape	currentMaskShape shape of mask if mask !
private Integer	currentMaskSize mask size of mask if mask !
private MTBImage	inImg
private MTBStructuringElement	mask
private int	maskCenterX
private int	maskCenterY
private Integer	maskSize
private int	maskSizeX
private int	maskSizeY
private BasicMorphology.opMode	mode
private MTBImage	resultImg
private BasicMorphology.maskShape	shape
private int	sizeT
private int	sizeX
private int	sizeY

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

completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider

Constructor Summary

Constructors

Constructor and Description
BasicMorphology()
BasicMorphology(Integer _maskSize, BasicMorphology.opMode _mode, BasicMorphology.maskShape _shape) Constructor to create new BasicMorphology object with mask size, mode and shape of the structuring element.
BasicMorphology(MTBImage inImg, MTBStructuringElement mask)

Method Summary

Modifier and Type	Method and Description
private MTBImage	blackTophat(MTBImage img) calculates the black tophat transform, i.e. difference of the closing of the image and the image (also called closing tophat)
private MTBImage	close(MTBImage img)
private MTBImage	dilate(MTBImage img)
private MTBImage	erode(MTBImage img)
private MTBStructuringElement	generateStructuringElement()
String	getDocumentation()
MTBImage	getResultImage()
private MTBImage	morphGradient(MTBImage img)
private MTBImage	open(MTBImage img)
void	operate()
void	setInImg(MTBImage _inImg) Set input image for morphological operation.
void	setMask(BasicMorphology.maskShape shape, int size)
void	setMask(MTBStructuringElement mask)
void	setMode(BasicMorphology.opMode mode)
private MTBImage	whiteTophat(MTBImage img) calculates the white tophat transform, i.e. difference of image and the opening of the image (also called opening tophat)

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, 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",
           dataIOOrder=0)
private transient MTBImage inImg

maskSize

@Parameter(label="mask size",
           required=false,
           direction=IN,
           supplemental=false,
           description="side length of structuring element",
           dataIOOrder=1)
private Integer maskSize

shape

@Parameter(label="mask shape",
           required=false,
           direction=IN,
           supplemental=false,
           description="shape of structuring element",
           dataIOOrder=2)
private BasicMorphology.maskShape shape

mode

@Parameter(label="mode",
           required=false,
           direction=IN,
           supplemental=false,
           description="type of operation",
           dataIOOrder=3)
private BasicMorphology.opMode mode

resultImg

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

currentMaskShape

private BasicMorphology.maskShape currentMaskShape

shape of mask if mask != null

currentMaskSize

private Integer currentMaskSize

mask size of mask if mask != null

sizeX

private int sizeX

sizeY

private int sizeY

sizeT

private int sizeT

maskSizeX

private int maskSizeX

maskSizeY

private int maskSizeY

maskCenterX

private int maskCenterX

maskCenterY

private int maskCenterY

mask

private MTBStructuringElement mask

Constructor Detail

BasicMorphology

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

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

BasicMorphology

public BasicMorphology(MTBImage inImg,
                       MTBStructuringElement mask)
                throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Parameters:

inImg - input image

mask - structuring element used for the morphological operation

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

BasicMorphology

public BasicMorphology(Integer _maskSize,
                       BasicMorphology.opMode _mode,
                       BasicMorphology.maskShape _shape)
                throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Constructor to create new BasicMorphology object with mask size, mode and shape of the structuring element.

Parameters:

_maskSize - size of structuring element used for the morphological operation

_mode - mode of morphological operation

_shape - shape of structuring element used for the morphological operation

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Method Detail

setInImg

public void setInImg(MTBImage _inImg)

Set input image for morphological operation.

operate

public 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

dilate

private MTBImage dilate(MTBImage img)

Parameters:

img -

Returns:

dilated image

erode

private MTBImage erode(MTBImage img)

Parameters:

img -

Returns:

eroded image

close

private MTBImage close(MTBImage img)

Parameters:

img -

Returns:

closed image

open

private MTBImage open(MTBImage img)

Parameters:

img -

Returns:

opened image

morphGradient

private MTBImage morphGradient(MTBImage img)
                        throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Parameters:

img -

Returns:

morphological gradient, i.e. difference of dilation and erosion of
input image

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

whiteTophat

private MTBImage whiteTophat(MTBImage img)
                      throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

calculates the white tophat transform, i.e. difference of image and the opening of the image
(also called opening tophat)

Parameters:

img -

Returns:

tophat processed image

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

blackTophat

private MTBImage blackTophat(MTBImage img)
                      throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

calculates the black tophat transform, i.e. difference of the closing of the image and the image
(also called closing tophat)

Parameters:

img -

Returns:

black tophat processed image

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

setMode

public void setMode(BasicMorphology.opMode mode)

Parameters:

mode - morphological operation to apply

setMask

public void setMask(BasicMorphology.maskShape shape,
                    int size)

setMask

public void setMask(MTBStructuringElement mask)

Parameters:

mask - structuring element to use

getResultImage

public MTBImage getResultImage()

Returns:

result image

generateStructuringElement

private MTBStructuringElement generateStructuringElement()

Returns:

structuring element used for the morphological operation

getDocumentation

public String getDocumentation()

Overrides:

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