de.unihalle.informatik.MiToBo.morphology

Class ImgTophat

java.lang.Object

de.unihalle.informatik.Alida.operator.ALDOperator

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

de.unihalle.informatik.MiToBo.morphology.ImgTophat

All Implemented Interfaces:

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

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

This class implements the tophat operator.

Attention: if masksize is even, errors may result due to lack of operator symmetry

Author:

moeller

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ImgTophat.tophatMode Available operating modes.

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
private int	masksize
(package private) MTBImage	mtbImg MTB input image to work on.
private ImgTophat.tophatMode	processMode
private MTBImage	resultImg

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

completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider

Constructor Summary

Constructors

Constructor and Description
ImgTophat() Default constructor.
ImgTophat(MTBImage ip, ImgTophat.tophatMode op, int msize) Constructor with parameters.

Method Summary

Modifier and Type	Method and Description
MTBImage	getInputImage() Get reference to the current input image.
int	getMasksize() Get current masksize.
ImgTophat.tophatMode	getMode() Get the desired operator mode.
MTBImage	getResultImage() Get the result image after applying the operator.
protected void	operate()
void	setResultImage(MTBImage rimage) Set the result image.
private MTBImage	tophat_concave(MTBImage img, int msize) Apply a top hat operator to the image for concavity detection.
private MTBImage	tophat_convex(MTBImage img, int msize) Apply a top hat operator to the image for convexity detection.

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

masksize

@Parameter(label="Masksize",
           required=true,
           direction=IN,
           description="Masksize")
private int masksize

inImg

@Parameter(label="Input image",
           required=true,
           direction=IN,
           description="Input image")
private transient MTBImage inImg

processMode

@Parameter(label="processMode",
           required=false,
           direction=IN,
           description="Process mode")
private ImgTophat.tophatMode processMode

resultImg

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

mtbImg

MTBImage mtbImg

MTB input image to work on.

Constructor Detail

ImgTophat

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

Default constructor.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

ImgTophat

public ImgTophat(MTBImage ip,
                 ImgTophat.tophatMode op,
                 int msize)
          throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Constructor with parameters.

Parameters:

ip - Image to work on.

op - Operator mode.

msize - Size of squared mask.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Method Detail

getInputImage

public MTBImage getInputImage()

Get reference to the current input image.

Returns:

Input image to work on.

getMode

public ImgTophat.tophatMode getMode()

Get the desired operator mode.

Returns:

Modus of operator.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

getMasksize

public int getMasksize()

Get current masksize.

Returns:

Masksize of dilation mask.

getResultImage

public MTBImage getResultImage()

Get the result image after applying the operator. Attention, reference might be null.

Returns:

Reference to result image.

setResultImage

public void setResultImage(MTBImage rimage)

Set the result image.

Parameters:

rimage - Result image.

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

tophat_convex

private MTBImage tophat_convex(MTBImage img,
                               int msize)
                        throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException,
                               de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

Apply a top hat operator to the image for convexity detection.

The operation is performed assuming a squared structural element with specified mask size and grayscale entries of 0.

Parameters:

img - Input image.

msize - Size of mask.

Returns:

Detection result (positiv answers = white).

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

tophat_concave

private MTBImage tophat_concave(MTBImage img,
                                int msize)
                         throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException,
                                de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

Apply a top hat operator to the image for concavity detection.

The operation is performed assuming a squared structural element with specified mask size and grayscale entries of 0.

Parameters:

img - Input image.

msize - Size of mask.

Returns:

Detection result (positiv answers = white).

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException