Package org.itk.simple
Class GrayscaleGeodesicDilateImageFilter
java.lang.Object
org.itk.simple.ProcessObject
org.itk.simple.ImageFilter
org.itk.simple.GrayscaleGeodesicDilateImageFilter
Geodesic grayscale dilation of an image.
Geodesic dilation operates on a "marker" image and a "mask" image.
The marker image is dilated using an elementary structuring element
(neighborhood of radius one using only the face connected neighbors).
The resulting image is then compared with the mask image. The output
image is the pixelwise minimum of the dilated marker image and the
mask image.
Geodesic dilation is run either one iteration or until convergence. In
the convergence case, the filter is equivalent to "reconstruction by
dilation". This filter is implemented to handle both scenarios. The
one iteration case is multi-threaded. The convergence case is
delegated to another instance of the same filter (but configured to
run a single iteration).
The marker image must be less than or equal to the mask image (on a
pixel by pixel basis).
Geodesic morphology is described in Chapter 6 of Pierre Soille's book
"Morphological Image Analysis: Principles and Applications", Second
Edition, Springer, 2003.
A noniterative version of this algorithm can be found in the ReconstructionByDilationImageFilter . This noniterative solution is much faster than the implementation
provided here. All ITK filters that previously used GrayscaleGeodesicDilateImageFilter as part of their implementation have been converted to use the ReconstructionByDilationImageFilter . The GrayscaleGeodesicDilateImageFilter is maintained for backward compatibility.
See:
MorphologyImageFilter , GrayscaleDilateImageFilter , GrayscaleFunctionDilateImageFilter , BinaryDilateImageFilter , ReconstructionByDilationImageFilter
itk::simple::GrayscaleGeodesicDilate for the procedural interface
itk::GrayscaleGeodesicDilateImageFilter for the Doxygen on the original ITK class.
C++ includes: sitkGrayscaleGeodesicDilateImageFilter.h
-
Field Summary
Fields inherited from class org.itk.simple.ProcessObject
swigCMemOwn
-
Constructor Summary
ConstructorsModifierConstructorDescriptionitk::simple::GrayscaleGeodesicDilateImageFilter::GrayscaleGeodesicDilateImageFilter() Default Constructor that takes no arguments and initializes default parametersprotected
GrayscaleGeodesicDilateImageFilter
(long cPtr, boolean cMemoryOwn) -
Method Summary
Modifier and TypeMethodDescriptionvoid
delete()
virtual itk::simple::GrayscaleGeodesicDilateImageFilter::~GrayscaleGeodesicDilateImageFilter() DestructorImage itk::simple::GrayscaleGeodesicDilateImageFilter::Execute(const Image &image1, const Image &image2) Execute the filter on the input imagesprotected void
finalize()
void
Self& itk::simple::GrayscaleGeodesicDilateImageFilter::FullyConnectedOff()void
Self& itk::simple::GrayscaleGeodesicDilateImageFilter::FullyConnectedOn() Set the value of FullyConnected to true or false respectfully.protected static long
boolean
bool itk::simple::GrayscaleGeodesicDilateImageFilter::GetFullyConnected() const Set/Get whether the connected components are defined strictly by face connectivity or by face+edge+vertex connectivity.getName()
std::string itk::simple::GrayscaleGeodesicDilateImageFilter::GetName() const Name of this classboolean
bool itk::simple::GrayscaleGeodesicDilateImageFilter::GetRunOneIteration() const Set/Get whether the filter should run one iteration or until convergence.void
Self& itk::simple::GrayscaleGeodesicDilateImageFilter::RunOneIterationOff()void
Self& itk::simple::GrayscaleGeodesicDilateImageFilter::RunOneIterationOn() Set the value of RunOneIteration to true or false respectfully.void
setFullyConnected
(boolean FullyConnected) Self& itk::simple::GrayscaleGeodesicDilateImageFilter::SetFullyConnected(bool FullyConnected) Set/Get whether the connected components are defined strictly by face connectivity or by face+edge+vertex connectivity.void
setRunOneIteration
(boolean RunOneIteration) Self& itk::simple::GrayscaleGeodesicDilateImageFilter::SetRunOneIteration(bool RunOneIteration) Set/Get whether the filter should run one iteration or until convergence.protected static long
toString()
std::string itk::simple::GrayscaleGeodesicDilateImageFilter::ToString() const Print ourselves outMethods inherited from class org.itk.simple.ImageFilter
getCPtr, swigRelease
Methods inherited from class org.itk.simple.ProcessObject
abort, addCommand, debugOff, debugOn, getCPtr, getDebug, getGlobalDefaultCoordinateTolerance, getGlobalDefaultDebug, getGlobalDefaultDirectionTolerance, getGlobalDefaultNumberOfThreads, getGlobalDefaultThreader, getGlobalWarningDisplay, getNumberOfThreads, getNumberOfWorkUnits, getProgress, globalDefaultDebugOff, globalDefaultDebugOn, globalWarningDisplayOff, globalWarningDisplayOn, hasCommand, removeAllCommands, setDebug, setGlobalDefaultCoordinateTolerance, setGlobalDefaultDebug, setGlobalDefaultDirectionTolerance, setGlobalDefaultNumberOfThreads, setGlobalDefaultThreader, setGlobalWarningDisplay, setNumberOfThreads, setNumberOfWorkUnits, swigRelease
-
Constructor Details
-
GrayscaleGeodesicDilateImageFilter
protected GrayscaleGeodesicDilateImageFilter(long cPtr, boolean cMemoryOwn) -
GrayscaleGeodesicDilateImageFilter
public GrayscaleGeodesicDilateImageFilter()itk::simple::GrayscaleGeodesicDilateImageFilter::GrayscaleGeodesicDilateImageFilter() Default Constructor that takes no arguments and initializes default parameters
-
-
Method Details
-
getCPtr
-
swigRelease
-
finalize
protected void finalize()- Overrides:
finalize
in classImageFilter
-
delete
public void delete()virtual itk::simple::GrayscaleGeodesicDilateImageFilter::~GrayscaleGeodesicDilateImageFilter() Destructor- Overrides:
delete
in classImageFilter
-
setRunOneIteration
public void setRunOneIteration(boolean RunOneIteration) Self& itk::simple::GrayscaleGeodesicDilateImageFilter::SetRunOneIteration(bool RunOneIteration) Set/Get whether the filter should run one iteration or until convergence. When run to convergence, this filter is equivalent to "reconstruction by dilation". Default is off. -
runOneIterationOn
public void runOneIterationOn()Self& itk::simple::GrayscaleGeodesicDilateImageFilter::RunOneIterationOn() Set the value of RunOneIteration to true or false respectfully. -
runOneIterationOff
public void runOneIterationOff()Self& itk::simple::GrayscaleGeodesicDilateImageFilter::RunOneIterationOff() -
getRunOneIteration
public boolean getRunOneIteration()bool itk::simple::GrayscaleGeodesicDilateImageFilter::GetRunOneIteration() const Set/Get whether the filter should run one iteration or until convergence. When run to convergence, this filter is equivalent to "reconstruction by dilation". Default is off. -
setFullyConnected
public void setFullyConnected(boolean FullyConnected) Self& itk::simple::GrayscaleGeodesicDilateImageFilter::SetFullyConnected(bool FullyConnected) Set/Get whether the connected components are defined strictly by face connectivity or by face+edge+vertex connectivity. Default is FullyConnectedOff. For objects that are 1 pixel wide, use FullyConnectedOn. -
fullyConnectedOn
public void fullyConnectedOn()Self& itk::simple::GrayscaleGeodesicDilateImageFilter::FullyConnectedOn() Set the value of FullyConnected to true or false respectfully. -
fullyConnectedOff
public void fullyConnectedOff()Self& itk::simple::GrayscaleGeodesicDilateImageFilter::FullyConnectedOff() -
getFullyConnected
public boolean getFullyConnected()bool itk::simple::GrayscaleGeodesicDilateImageFilter::GetFullyConnected() const Set/Get whether the connected components are defined strictly by face connectivity or by face+edge+vertex connectivity. Default is FullyConnectedOff. For objects that are 1 pixel wide, use FullyConnectedOn. -
getName
std::string itk::simple::GrayscaleGeodesicDilateImageFilter::GetName() const Name of this class- Overrides:
getName
in classProcessObject
-
toString
std::string itk::simple::GrayscaleGeodesicDilateImageFilter::ToString() const Print ourselves out- Overrides:
toString
in classProcessObject
-
execute
Image itk::simple::GrayscaleGeodesicDilateImageFilter::Execute(const Image &image1, const Image &image2) Execute the filter on the input images
-