itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage > Class Template Reference

Create a map of the approximate signed distance from the boundaries of a binary image. More...

#include <itkApproximateSignedDistanceMapImageFilter.h>

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

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

[legend]List of all members.

Public Types
typedef ApproximateSignedDistanceMapImageFilter	Self
typedef ImageToImageFilter< TInputImage, TOutputImage >	Superclass
typedef SmartPointer< Self >	Pointer
typedef SmartPointer< const Self >	ConstPointer
typedef TInputImage	InputImageType
typedef TOutputImage	OutputImageType
typedef InputImageType::PixelType	InputPixelType
typedef OutputImageType::PixelType	OutputPixelType
typedef OutputImageType::SizeType	OutputSizeType
typedef OutputSizeType::SizeValueType	OutputSizeValueType
typedef InputImageType::ConstPointer	InputImagePointer
typedef OutputImageType::Pointer	OutputImagePointer
Public Member Functions
virtual const char *	GetNameOfClass () const
	itkStaticConstMacro (InputImageDimension, unsigned int, InputImageType::ImageDimension)
virtual void	SetInsideValue (InputPixelType _arg)
virtual InputPixelType	GetInsideValue ()
virtual void	SetOutsideValue (InputPixelType _arg)
virtual InputPixelType	GetOutsideValue ()
Static Public Member Functions
Pointer	New ()
Protected Member Functions
	ApproximateSignedDistanceMapImageFilter ()
virtual	~ApproximateSignedDistanceMapImageFilter ()
virtual void	GenerateData ()
void	PrintSelf (std::ostream &os, Indent indent) const

---

Detailed Description

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

Create a map of the approximate signed distance from the boundaries of a binary image.

The ApproximateSignedDistanceMapImageFilter takes as input a binary image and produces a signed distance map. Each pixel value in the output contains the approximate distance from that pixel to the nearest "object" in the binary image. This filter differs from the DanielssonDistanceMapImageFilter in that it calculates the distance to the "object edge" for pixels within the object.

Negative values in the output indicate that the pixel at that position is within an object in the input image. The absolute value of a negative pixel represents the approximate distance to the nearest object boundary pixel.

WARNING: This filter requires that the output type be floating-point. Otherwise internal calculations will not be performed to the appropriate precision, resulting in completely incorrect (read: zero-valued) output.

The distances computed by this filter are Chamfer distances, which are only an approximation to Euclidian distances, and are not as exact approximations as those calculated by the DanielssonDistanceMapImageFilter. On the other hand, this filter is faster.

This filter requires that an "inside value" and "outside value" be set as parameters. The "inside value" is the intensity value of the binary image which corresponds to objects, and the "outside value" is the intensity of the background. (A typical binary image often repesents objects as black (0) and background as white (usually 255), or vice-versa.) Note that this filter is slightly faster if the inside value is less than the outside value. Otherwise an extra iteration through the image is required.

This filter uses the FastChamferDistanceImageFilter and the IsoContourDistanceImageFilter inernally to perform the distance calculations.

See also:

DanielssonDistanceMapImageFilter, SignedDanielssonDistanceMapImageFilter

FastChamferDistanceImageFilter, IsoContourDistanceImageFilter

Author:

Zach Pincus

Definition at line 67 of file itkApproximateSignedDistanceMapImageFilter.h.

---

Member Typedef Documentation

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

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

template<class TInputImage, class TOutputImage> typedef InputImageType::ConstPointer itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::InputImagePointer

Pointer Type for input image. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 103 of file itkApproximateSignedDistanceMapImageFilter.h.

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

Type for input image. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 83 of file itkApproximateSignedDistanceMapImageFilter.h.

template<class TInputImage, class TOutputImage> typedef InputImageType::PixelType itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::InputPixelType

Type for the pixels of the input image. Definition at line 89 of file itkApproximateSignedDistanceMapImageFilter.h. Referenced by itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::~ApproximateSignedDistanceMapImageFilter().

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

Pointer Type for the output image. Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 106 of file itkApproximateSignedDistanceMapImageFilter.h.

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

Type for the output image. Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 86 of file itkApproximateSignedDistanceMapImageFilter.h.

template<class TInputImage, class TOutputImage> typedef OutputImageType::PixelType itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::OutputPixelType

Type for the pixels of the output image. Definition at line 92 of file itkApproximateSignedDistanceMapImageFilter.h.

template<class TInputImage, class TOutputImage> typedef OutputImageType::SizeType itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::OutputSizeType

Type of input image size and size value Definition at line 95 of file itkApproximateSignedDistanceMapImageFilter.h.

template<class TInputImage, class TOutputImage> typedef OutputSizeType::SizeValueType itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::OutputSizeValueType

Definition at line 96 of file itkApproximateSignedDistanceMapImageFilter.h.

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

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

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

Standard typedefs Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 71 of file itkApproximateSignedDistanceMapImageFilter.h. Referenced by itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::~ApproximateSignedDistanceMapImageFilter().

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

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

---

Constructor & Destructor Documentation

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

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

Definition at line 120 of file itkApproximateSignedDistanceMapImageFilter.h. References itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::InputPixelType, and itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::Self.

---

Member Function Documentation

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

A version of GenerateData() specific for image processing filters. This implementation will split the processing across multiple threads. The buffer is allocated by this method. Then the BeforeThreadedGenerateData() method is called (if provided). Then, a series of threads are spawned each calling ThreadedGenerateData(). After all the threads have completed processing, the AfterThreadedGenerateData() method is called (if provided). If an image processing filter cannot be threaded, the filter should provide an implementation of GenerateData(). That implementation is responsible for allocating the output buffer. If a filter an be threaded, it should NOT provide a GenerateData() method but should provide a ThreadedGenerateData() instead. See also: ThreadedGenerateData() Reimplemented from itk::ImageSource< TOutputImage >.

template<class TInputImage, class TOutputImage> virtual InputPixelType itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::GetInsideValue (   )  [virtual]

Set/Get intensity value representing the interior of objects in the mask

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

Run-time type information (and related methods). Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage> virtual InputPixelType itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::GetOutsideValue (   )  [virtual]

Set/Get intensity value representing non-objects in the mask

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

The dimension of the input image.

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

standard New() method support Reimplemented from itk::Object.

template<class TInputImage, class TOutputImage> void itk::ApproximateSignedDistanceMapImageFilter< 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::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::SetInsideValue (  InputPixelType  _arg  )  [virtual]

Set/Get intensity value representing the interior of objects in the mask

template<class TInputImage, class TOutputImage> virtual void itk::ApproximateSignedDistanceMapImageFilter< TInputImage, TOutputImage >::SetOutsideValue (  InputPixelType  _arg  )  [virtual]

Set/Get intensity value representing non-objects in the mask

---

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

• itkApproximateSignedDistanceMapImageFilter.h

---