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 >:

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

Public Types
typedef SmartPointer< const Self >	ConstPointer
typedef InputImageType::ConstPointer	InputImagePointer
typedef TInputImage	InputImageType
typedef InputImageType::PixelType	InputPixelType
typedef OutputImageType::Pointer	OutputImagePointer
typedef TOutputImage	OutputImageType
typedef OutputImageType::PixelType	OutputPixelType
typedef OutputImageType::SizeType	OutputSizeType
typedef OutputSizeType::SizeValueType	OutputSizeValueType
typedef SmartPointer< Self >	Pointer
typedef ApproximateSignedDistanceMapImageFilter	Self
typedef ImageToImageFilter < TInputImage, TOutputImage >	Superclass
Public Member Functions
virtual ::itk::LightObject::Pointer	CreateAnother (void) const
virtual const char *	GetNameOfClass () const
	typedef (Concept::EqualityComparable< typename InputImageType::PixelType >) InputEqualityComparableCheck

virtual void	SetInsideValue (InputPixelType _arg)
virtual InputPixelType	GetInsideValue () const

virtual void	SetOutsideValue (InputPixelType _arg)
virtual InputPixelType	GetOutsideValue () const
Static Public Member Functions
static Pointer	New ()
Static Public Attributes
static const unsigned int	InputImageDimension = InputImageType::ImageDimension
Protected Member Functions
void	PrintSelf (std::ostream &os, Indent indent) const

	ApproximateSignedDistanceMapImageFilter ()
virtual	~ApproximateSignedDistanceMapImageFilter ()
virtual void	GenerateData ()
Private Types
typedef FastChamferDistanceImageFilter < OutputImageType, OutputImageType >	ChamferType
typedef IsoContourDistanceImageFilter < InputImageType, OutputImageType >	IsoContourType
Private Member Functions
	ApproximateSignedDistanceMapImageFilter (const Self &)
void	operator= (const Self &)
Private Attributes
ChamferType::Pointer	m_ChamferFilter
InputPixelType	m_InsideValue
IsoContourType::Pointer	m_IsoContourFilter
InputPixelType	m_OutsideValue

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

Wiki Examples:

All Examples

Compute a distance map from objects in a binary image

Definition at line 72 of file itkApproximateSignedDistanceMapImageFilter.h.