de.unihalle.informatik.MiToBo.segmentation.regions.mser
Class DetectMSERs

java.lang.Object
  extended by de.unihalle.informatik.Alida.operator.ALDOperator
      extended by de.unihalle.informatik.MiToBo.core.operator.MTBOperator
          extended by de.unihalle.informatik.MiToBo.segmentation.regions.mser.DetectMSERs
All Implemented Interfaces:
de.unihalle.informatik.Alida.datatypes.ALDConfigurationValidator, de.unihalle.informatik.Alida.operator.events.ALDOperatorExecutionProgressEventListener, EventListener

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

Implementation of maximally stable extremal regions based on ImgLib2.

For details about the implementation and its parameters please refer to the corresponding documentation pages in the ImgLib2 Javadoc API.

Please note that currently only gray-scale images are supported. The implementation handles data up to 3D, i.e. x/y/z. Multiple channels and time steps are ignored, i.e. only the first channel and the first time step of an image is taken into account.

Related paper: Matas et al., Robust wide-baseline stereo from maximally stable extremal regions, Image and Vision Computing, vol. 22, no. 10, pp. 761-767, 2004.

Author:
moeller
See Also:
ImgLib2 Javadoc API for MserTree

Nested Class Summary
static class DetectMSERs.Thresholding_Direction
          Modes for direction of intensity thresholding.
 
Nested classes/interfaces inherited from class de.unihalle.informatik.Alida.operator.ALDOperator
de.unihalle.informatik.Alida.operator.ALDOperator.HidingMode
 
Field Summary
 
Fields inherited from class de.unihalle.informatik.Alida.operator.ALDOperator
completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider
 
Constructor Summary
DetectMSERs()
          Default constructor.
 
Method Summary
 MTBRegionSetInterface getMSERs()
          Returns set of detected MSERs.
 int getNumberOfMSERs()
          Returns number of detected MSERs.
protected  void operate()
          This method does the actual work.
 void setCreateBinaryMasks(boolean b)
          Enable/disable creation of binary masks.
 void setDelta(double d)
          Set distance between threshold images to be compared.
 void setInputImage(MTBImage img)
          Set input image to process.
 void setMaximalInstabilityScore(double ms)
          Set maximal instability score.
 void setMaximalSize(long ms)
          Set maximal size of valid regions.
 void setMinimalDiversity(double md)
          Set minimal diversity.
 void setMinimalSize(long ms)
          Set minimal size of valid regions.
 void setThresholdingDirection(DetectMSERs.Thresholding_Direction td)
          Set direction of threshold compuations.
 
Methods inherited from class de.unihalle.informatik.MiToBo.core.operator.MTBOperator
readResolve
 
Methods inherited from class de.unihalle.informatik.Alida.operator.ALDOperator
addOperatorExecutionProgressEventListener, fieldContained, fireOperatorExecutionProgressEvent, getALDPortHashAccessKey, getConstructionMode, getHidingMode, getInInoutNames, getInInoutNames, getInNames, getInOutNames, getMissingRequiredInputs, getName, getNumParameters, getOutInoutNames, getOutNames, getParameter, getParameterDescriptor, getParameterNames, getSupplementalNames, getVerbose, getVersion, handleOperatorExecutionProgressEvent, isConfigured, print, print, print, printInterface, printInterface, readHistory, reinitializeParameterDescriptors, removeOperatorExecutionProgressEventListener, runOp, runOp, runOp, setConstructionMode, setHidingMode, setName, setParameter, 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
 

Constructor Detail

DetectMSERs

public DetectMSERs()
            throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException
Default constructor.

Throws:
de.unihalle.informatik.Alida.exceptions.ALDOperatorException
Method Detail

setInputImage

public void setInputImage(MTBImage img)
Set input image to process.

Parameters:
img - Image to process.

setDelta

public void setDelta(double d)
Set distance between threshold images to be compared.

Parameters:
d - Distance to be applied.

setMinimalSize

public void setMinimalSize(long ms)
Set minimal size of valid regions.

Regions smaller than the given threshold are discarded.

Parameters:
ms - Minimal region size.

setMaximalSize

public void setMaximalSize(long ms)
Set maximal size of valid regions.

Regions larger than the given threshold are discarded.

Parameters:
ms - Maximal region size.

setMaximalInstabilityScore

public void setMaximalInstabilityScore(double ms)
Set maximal instability score.

Parameters:
ms - Maximal instability score.

setMinimalDiversity

public void setMinimalDiversity(double md)
Set minimal diversity.

Parameters:
ms - Minimal diversity allowed for valid regions.

setThresholdingDirection

public void setThresholdingDirection(DetectMSERs.Thresholding_Direction td)
Set direction of threshold compuations.

Parameters:
ms - Direction of thresholding.

setCreateBinaryMasks

public void setCreateBinaryMasks(boolean b)
Enable/disable creation of binary masks.

Parameters:
b - If true, masks are created, otherwise not.

getNumberOfMSERs

public int getNumberOfMSERs()
Returns number of detected MSERs.


getMSERs

public MTBRegionSetInterface getMSERs()
Returns set of detected MSERs.

Depending on the dimension of the input image either a set of 2D or 3D regions is returned, i.e. the object is either of type MTBRegion2DSet or MTBRegion3DSet.


operate

protected void operate()
                throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException
This method does the actual work.

Specified by:
operate in class de.unihalle.informatik.Alida.operator.ALDOperator
Throws:
de.unihalle.informatik.Alida.exceptions.ALDOperatorException


Copyright © 2010–2015 Martin Luther University Halle-Wittenberg. All rights reserved.