itk::HMinimaImageFilter< TInputImage, TOutputImage > Class Template Reference
[Image Enhancement Filters, Mathematical Morphology Image Filters]

Suppress local minima whose depth below the baseline is less than h. More...

#include <itkHMinimaImageFilter.h>

Inheritance diagram for itk::HMinimaImageFilter< TInputImage, TOutputImage >:

[legend]Collaboration diagram for itk::HMinimaImageFilter< TInputImage, TOutputImage >:

[legend]List of all members.

Public Types
typedef HMinimaImageFilter	Self
typedef ImageToImageFilter< TInputImage, TOutputImage >	Superclass
typedef SmartPointer< Self >	Pointer
typedef SmartPointer< const Self >	ConstPointer
typedef TInputImage	InputImageType
typedef TOutputImage	OutputImageType
typedef InputImageType::Pointer	InputImagePointer
typedef InputImageType::ConstPointer	InputImageConstPointer
typedef InputImageType::RegionType	InputImageRegionType
typedef InputImageType::PixelType	InputImagePixelType
typedef OutputImageType::Pointer	OutputImagePointer
typedef OutputImageType::ConstPointer	OutputImageConstPointer
typedef OutputImageType::RegionType	OutputImageRegionType
typedef OutputImageType::PixelType	OutputImagePixelType
Public Member Functions
virtual const char *	GetNameOfClass () const
	itkStaticConstMacro (InputImageDimension, unsigned int, TInputImage::ImageDimension)
	itkStaticConstMacro (OutputImageDimension, unsigned int, TOutputImage::ImageDimension)
virtual void	SetHeight (InputImagePixelType _arg)
virtual InputImagePixelType	GetHeight ()
unsigned long	GetNumberOfIterationsUsed ()
virtual void	SetFullyConnected (bool _arg)
virtual const bool &	GetFullyConnected ()
virtual void	FullyConnectedOn ()
virtual void	FullyConnectedOff ()
Static Public Member Functions
Pointer	New ()
Protected Member Functions
	HMinimaImageFilter ()
	~HMinimaImageFilter ()
void	PrintSelf (std::ostream &os, Indent indent) const
void	GenerateInputRequestedRegion ()
void	EnlargeOutputRequestedRegion (DataObject *)
void	GenerateData ()

---

Detailed Description

template<class TInputImage, class TOutputImage>
class itk::HMinimaImageFilter< TInputImage, TOutputImage >

Suppress local minima whose depth below the baseline is less than h.

HMinimaImageFilter suppresses local minima that are less than h intensity units below the (local) background. This has the effect of smoothing over the "low" parts of the noise in the image without smoothing over large changes in intensity (region boundaries). See the HMaximaImageFilter to suppress the local maxima whose height is less than h intensity units above the (local) background.

If original image is subtracted from the output of HMinimaImageFilter, the signicant "valleys" in the image can be identified. This is what the HConcaveImageFilter provides.

This filter uses the GrayscaleGeodesicErodeImageFilter. It provides its own input as the "mask" input to the geodesic dilation. The "marker" image for the geodesic dilation is the input image plus the height parameter h.

Geodesic morphology and the H-Minima algorithm is described in Chapter 6 of Pierre Soille's book "Morphological Image Analysis: Principles and Applications", Second Edition, Springer, 2003.

See also:

GrayscaleGeodesicDilateImageFilter, HMinimaImageFilter, HConvexImageFilter

MorphologyImageFilter, GrayscaleDilateImageFilter, GrayscaleFunctionDilateImageFilter, BinaryDilateImageFilter

Definition at line 53 of file itkHMinimaImageFilter.h.

---

Member Typedef Documentation

template<class TInputImage, class TOutputImage> typedef SmartPointer<const Self> itk::HMinimaImageFilter< TInputImage, TOutputImage >::ConstPointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 62 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef InputImageType::ConstPointer itk::HMinimaImageFilter< TInputImage, TOutputImage >::InputImageConstPointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 68 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef InputImageType::PixelType itk::HMinimaImageFilter< TInputImage, TOutputImage >::InputImagePixelType

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 70 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef InputImageType::Pointer itk::HMinimaImageFilter< TInputImage, TOutputImage >::InputImagePointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 67 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef InputImageType::RegionType itk::HMinimaImageFilter< TInputImage, TOutputImage >::InputImageRegionType

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 69 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef TInputImage itk::HMinimaImageFilter< TInputImage, TOutputImage >::InputImageType

Some convenient typedefs. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 65 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef OutputImageType::ConstPointer itk::HMinimaImageFilter< TInputImage, TOutputImage >::OutputImageConstPointer

Definition at line 72 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef OutputImageType::PixelType itk::HMinimaImageFilter< TInputImage, TOutputImage >::OutputImagePixelType

Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 74 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef OutputImageType::Pointer itk::HMinimaImageFilter< TInputImage, TOutputImage >::OutputImagePointer

Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 71 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef OutputImageType::RegionType itk::HMinimaImageFilter< TInputImage, TOutputImage >::OutputImageRegionType

Superclass typedefs. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 73 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef TOutputImage itk::HMinimaImageFilter< TInputImage, TOutputImage >::OutputImageType

Some convenient typedefs. Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 66 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef SmartPointer<Self> itk::HMinimaImageFilter< TInputImage, TOutputImage >::Pointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 61 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef HMinimaImageFilter itk::HMinimaImageFilter< TInputImage, TOutputImage >::Self

Standard class typedefs. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 58 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> typedef ImageToImageFilter<TInputImage, TOutputImage> itk::HMinimaImageFilter< TInputImage, TOutputImage >::Superclass

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 60 of file itkHMinimaImageFilter.h.

---

Constructor & Destructor Documentation

template<class TInputImage, class TOutputImage> itk::HMinimaImageFilter< TInputImage, TOutputImage >::HMinimaImageFilter (   )  [protected]

template<class TInputImage, class TOutputImage> itk::HMinimaImageFilter< TInputImage, TOutputImage >::~HMinimaImageFilter (   )  [inline, protected]

Definition at line 120 of file itkHMinimaImageFilter.h.

---

Member Function Documentation

template<class TInputImage, class TOutputImage> void itk::HMinimaImageFilter< TInputImage, TOutputImage >::EnlargeOutputRequestedRegion (  DataObject *   )  [protected, virtual]

HMinimaImageFilter will produce the entire output. Reimplemented from itk::ProcessObject.

template<class TInputImage, class TOutputImage> virtual void itk::HMinimaImageFilter< TInputImage, TOutputImage >::FullyConnectedOff (   )  [virtual]

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.

template<class TInputImage, class TOutputImage> virtual void itk::HMinimaImageFilter< TInputImage, TOutputImage >::FullyConnectedOn (   )  [virtual]

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.

template<class TInputImage, class TOutputImage> void itk::HMinimaImageFilter< TInputImage, TOutputImage >::GenerateData (   )  [protected, virtual]

Single-threaded version of GenerateData. This filter delegates to GrayscaleGeodesicErodeImageFilter. Reimplemented from itk::ImageSource< TOutputImage >.

template<class TInputImage, class TOutputImage> void itk::HMinimaImageFilter< TInputImage, TOutputImage >::GenerateInputRequestedRegion (   )  [protected, virtual]

HMinimaImageFilter needs the entire input be available. Thus, it needs to provide an implementation of GenerateInputRequestedRegion(). Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage> virtual const bool& itk::HMinimaImageFilter< TInputImage, TOutputImage >::GetFullyConnected (   )  [virtual]

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.

template<class TInputImage, class TOutputImage> virtual InputImagePixelType itk::HMinimaImageFilter< TInputImage, TOutputImage >::GetHeight (   )  [virtual]

Set/Get the height that a local maximum must be above the local background (local contrast) in order to survive the processing. Local maxima below this value are replaced with an estimate of the local background.

template<class TInputImage, class TOutputImage> virtual const char* itk::HMinimaImageFilter< TInputImage, TOutputImage >::GetNameOfClass (   )  const [virtual]

Runtime information support. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage> unsigned long itk::HMinimaImageFilter< TInputImage, TOutputImage >::GetNumberOfIterationsUsed (   )  [inline]

Deprecated: Get the number of iterations used to produce the current output. This method is scheduled for removal since the implementation now uses a noniterative solution. Definition at line 102 of file itkHMinimaImageFilter.h.

template<class TInputImage, class TOutputImage> itk::HMinimaImageFilter< TInputImage, TOutputImage >::itkStaticConstMacro (  OutputImageDimension  , unsigned  int, TOutputImage::ImageDimension  )

ImageDimension constants Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage> itk::HMinimaImageFilter< TInputImage, TOutputImage >::itkStaticConstMacro (  InputImageDimension  , unsigned  int, TInputImage::ImageDimension  )

ImageDimension constants Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage> Pointer itk::HMinimaImageFilter< TInputImage, TOutputImage >::New (   )  [static]

Standard New method. Reimplemented from itk::Object.

template<class TInputImage, class TOutputImage> void itk::HMinimaImageFilter< TInputImage, TOutputImage >::PrintSelf (  std::ostream &  os, Indent  indent )  const [protected, virtual]

Methods invoked by Print() to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage> virtual void itk::HMinimaImageFilter< TInputImage, TOutputImage >::SetFullyConnected (  bool  _arg  )  [virtual]

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.

template<class TInputImage, class TOutputImage> virtual void itk::HMinimaImageFilter< TInputImage, TOutputImage >::SetHeight (  InputImagePixelType  _arg  )  [virtual]

Set/Get the height that a local maximum must be above the local background (local contrast) in order to survive the processing. Local maxima below this value are replaced with an estimate of the local background.

---

The documentation for this class was generated from the following file:

• itkHMinimaImageFilter.h

---