VTK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
vtkImageEuclideanDistance Class Reference

computes 3D Euclidean DT More...

#include <vtkImageEuclideanDistance.h>

Inheritance diagram for vtkImageEuclideanDistance:
[legend]
Collaboration diagram for vtkImageEuclideanDistance:
[legend]

Public Types

typedef vtkImageDecomposeFilter Superclass
 
- Public Types inherited from vtkImageDecomposeFilter
typedef vtkImageIterateFilter Superclass
 
- Public Types inherited from vtkImageIterateFilter
typedef vtkThreadedImageAlgorithm Superclass
 

Public Member Functions

virtual int IsA (const char *type)
 
vtkImageEuclideanDistanceNewInstance () const
 
void PrintSelf (ostream &os, vtkIndent indent)
 
virtual int IterativeRequestData (vtkInformation *, vtkInformationVector **, vtkInformationVector *)
 
int SplitExtent (int splitExt[6], int startExt[6], int num, int total)
 
virtual void SetInitialize (int)
 
virtual int GetInitialize ()
 
virtual void InitializeOn ()
 
virtual void InitializeOff ()
 
virtual void SetConsiderAnisotropy (int)
 
virtual int GetConsiderAnisotropy ()
 
virtual void ConsiderAnisotropyOn ()
 
virtual void ConsiderAnisotropyOff ()
 
virtual void SetMaximumDistance (double)
 
virtual double GetMaximumDistance ()
 
virtual void SetAlgorithm (int)
 
virtual int GetAlgorithm ()
 
void SetAlgorithmToSaito ()
 
void SetAlgorithmToSaitoCached ()
 
- Public Member Functions inherited from vtkImageDecomposeFilter
void SetDimensionality (int dim)
 
virtual int GetDimensionality ()
 
void PermuteIncrements (vtkIdType *increments, vtkIdType &inc0, vtkIdType &inc1, vtkIdType &inc2)
 
void PermuteExtent (int *extent, int &min0, int &max0, int &min1, int &max1, int &min2, int &max2)
 
vtkImageDecomposeFilterNewInstance () const
 
void PrintSelf (ostream &os, vtkIndent indent)
 
- Public Member Functions inherited from vtkImageIterateFilter
vtkImageIterateFilterNewInstance () const
 
void PrintSelf (ostream &os, vtkIndent indent)
 
virtual int GetIteration ()
 
virtual int GetNumberOfIterations ()
 

Static Public Member Functions

static vtkImageEuclideanDistanceNew ()
 
static int IsTypeOf (const char *type)
 
static vtkImageEuclideanDistanceSafeDownCast (vtkObjectBase *o)
 
- Static Public Member Functions inherited from vtkImageDecomposeFilter
static int IsTypeOf (const char *type)
 
static vtkImageDecomposeFilterSafeDownCast (vtkObjectBase *o)
 
- Static Public Member Functions inherited from vtkImageIterateFilter
static int IsTypeOf (const char *type)
 
static vtkImageIterateFilterSafeDownCast (vtkObjectBase *o)
 

Protected Member Functions

virtual vtkObjectBase * NewInstanceInternal () const
 
 vtkImageEuclideanDistance ()
 
 ~vtkImageEuclideanDistance ()
 
virtual void AllocateOutputScalars (vtkImageData *outData, int outExt[6], vtkInformation *outInfo)
 
virtual int IterativeRequestInformation (vtkInformation *in, vtkInformation *out)
 
virtual int IterativeRequestUpdateExtent (vtkInformation *in, vtkInformation *out)
 
- Protected Member Functions inherited from vtkImageDecomposeFilter
 vtkImageDecomposeFilter ()
 
 ~vtkImageDecomposeFilter ()
 
- Protected Member Functions inherited from vtkImageIterateFilter
 vtkImageIterateFilter ()
 
 ~vtkImageIterateFilter ()
 
virtual int RequestUpdateExtent (vtkInformation *, vtkInformationVector **, vtkInformationVector *)
 
virtual int RequestInformation (vtkInformation *, vtkInformationVector **, vtkInformationVector *)
 
virtual int RequestData (vtkInformation *request, vtkInformationVector **inputVector, vtkInformationVector *outputVector)
 
virtual void SetNumberOfIterations (int num)
 

Protected Attributes

double MaximumDistance
 
int Initialize
 
int ConsiderAnisotropy
 
int Algorithm
 
- Protected Attributes inherited from vtkImageDecomposeFilter
int Dimensionality
 
- Protected Attributes inherited from vtkImageIterateFilter
int NumberOfIterations
 
int Iteration
 
vtkAlgorithm ** IterationData
 
vtkInformationVector * InputVector
 
vtkInformationVector * OutputVector
 

Detailed Description

computes 3D Euclidean DT

vtkImageEuclideanDistance implements the Euclidean DT using Saito's algorithm. The distance map produced contains the square of the Euclidean distance values.

The algorithm has a o(n^(D+1)) complexity over nxnx...xn images in D dimensions. It is very efficient on relatively small images. Cuisenaire's algorithms should be used instead if n >> 500. These are not implemented yet.

For the special case of images where the slice-size is a multiple of 2^N with a large N (typically for 256x256 slices), Saito's algorithm encounters a lot of cache conflicts during the 3rd iteration which can slow it very significantly. In that case, one should use ::SetAlgorithmToSaitoCached() instead for better performance.

References:

T. Saito and J.I. Toriwaki. New algorithms for Euclidean distance transformations of an n-dimensional digitised picture with applications. Pattern Recognition, 27(11). pp. 1551–1565, 1994.

O. Cuisenaire. Distance Transformation: fast algorithms and applications to medical image processing. PhD Thesis, Universite catholique de Louvain, October 1999. http://ltswww.epfl.ch/~cuisenai/papers/oc_thesis.pdf

Tests:
vtkImageEuclideanDistance (Tests)

Definition at line 56 of file vtkImageEuclideanDistance.h.

Member Typedef Documentation

Definition at line 60 of file vtkImageEuclideanDistance.h.

Constructor & Destructor Documentation

vtkImageEuclideanDistance::vtkImageEuclideanDistance ( )
protected
vtkImageEuclideanDistance::~vtkImageEuclideanDistance ( )
inlineprotected

Definition at line 116 of file vtkImageEuclideanDistance.h.

Member Function Documentation

static vtkImageEuclideanDistance* vtkImageEuclideanDistance::New ( )
static
static int vtkImageEuclideanDistance::IsTypeOf ( const char *  type)
static
virtual int vtkImageEuclideanDistance::IsA ( const char *  type)
virtual

Construct an instance of vtkImageDecomposeFilter filter with default dimensionality 3.

Reimplemented from vtkImageDecomposeFilter.

static vtkImageEuclideanDistance* vtkImageEuclideanDistance::SafeDownCast ( vtkObjectBase *  o)
static
virtual vtkObjectBase* vtkImageEuclideanDistance::NewInstanceInternal ( ) const
protectedvirtual

Construct an instance of vtkImageDecomposeFilter filter with default dimensionality 3.

Reimplemented from vtkImageDecomposeFilter.

vtkImageEuclideanDistance* vtkImageEuclideanDistance::NewInstance ( ) const
void vtkImageEuclideanDistance::PrintSelf ( ostream &  os,
vtkIndent  indent 
)
int vtkImageEuclideanDistance::SplitExtent ( int  splitExt[6],
int  startExt[6],
int  num,
int  total 
)

Used internally for streaming and threads. Splits output update extent into num pieces. This method needs to be called num times. Results must not overlap for consistent starting extent. Subclass can override this method. This method returns the number of peices resulting from a successful split. This can be from 1 to "total". If 1 is returned, the extent cannot be split.

virtual void vtkImageEuclideanDistance::SetInitialize ( int  )
virtual

Used to set all non-zero voxels to MaximumDistance before starting the distance transformation. Setting Initialize off keeps the current value in the input image as starting point. This allows to superimpose several distance maps.

virtual int vtkImageEuclideanDistance::GetInitialize ( )
virtual

Used to set all non-zero voxels to MaximumDistance before starting the distance transformation. Setting Initialize off keeps the current value in the input image as starting point. This allows to superimpose several distance maps.

virtual void vtkImageEuclideanDistance::InitializeOn ( )
virtual

Used to set all non-zero voxels to MaximumDistance before starting the distance transformation. Setting Initialize off keeps the current value in the input image as starting point. This allows to superimpose several distance maps.

virtual void vtkImageEuclideanDistance::InitializeOff ( )
virtual

Used to set all non-zero voxels to MaximumDistance before starting the distance transformation. Setting Initialize off keeps the current value in the input image as starting point. This allows to superimpose several distance maps.

virtual void vtkImageEuclideanDistance::SetConsiderAnisotropy ( int  )
virtual

Used to define whether Spacing should be used in the computation of the distances

virtual int vtkImageEuclideanDistance::GetConsiderAnisotropy ( )
virtual

Used to define whether Spacing should be used in the computation of the distances

virtual void vtkImageEuclideanDistance::ConsiderAnisotropyOn ( )
virtual

Used to define whether Spacing should be used in the computation of the distances

virtual void vtkImageEuclideanDistance::ConsiderAnisotropyOff ( )
virtual

Used to define whether Spacing should be used in the computation of the distances

virtual void vtkImageEuclideanDistance::SetMaximumDistance ( double  )
virtual

Any distance bigger than this->MaximumDistance will not ne computed but set to this->MaximumDistance instead.

virtual double vtkImageEuclideanDistance::GetMaximumDistance ( )
virtual

Any distance bigger than this->MaximumDistance will not ne computed but set to this->MaximumDistance instead.

virtual void vtkImageEuclideanDistance::SetAlgorithm ( int  )
virtual

Selects a Euclidean DT algorithm. 1. Saito 2. Saito-cached More algorithms will be added later on.

virtual int vtkImageEuclideanDistance::GetAlgorithm ( )
virtual

Selects a Euclidean DT algorithm. 1. Saito 2. Saito-cached More algorithms will be added later on.

void vtkImageEuclideanDistance::SetAlgorithmToSaito ( )
inline

Selects a Euclidean DT algorithm. 1. Saito 2. Saito-cached More algorithms will be added later on.

Definition at line 104 of file vtkImageEuclideanDistance.h.

void vtkImageEuclideanDistance::SetAlgorithmToSaitoCached ( )
inline

Selects a Euclidean DT algorithm. 1. Saito 2. Saito-cached More algorithms will be added later on.

Definition at line 106 of file vtkImageEuclideanDistance.h.

virtual int vtkImageEuclideanDistance::IterativeRequestData ( vtkInformation *  ,
vtkInformationVector **  ,
vtkInformationVector *   
)
virtual

Reimplemented from vtkImageIterateFilter.

virtual void vtkImageEuclideanDistance::AllocateOutputScalars ( vtkImageData *  outData,
int  outExt[6],
vtkInformation *  outInfo 
)
protectedvirtual
virtual int vtkImageEuclideanDistance::IterativeRequestInformation ( vtkInformation *  in,
vtkInformation *  out 
)
protectedvirtual

Reimplemented from vtkImageIterateFilter.

virtual int vtkImageEuclideanDistance::IterativeRequestUpdateExtent ( vtkInformation *  in,
vtkInformation *  out 
)
protectedvirtual

Reimplemented from vtkImageIterateFilter.

Member Data Documentation

double vtkImageEuclideanDistance::MaximumDistance
protected

Definition at line 118 of file vtkImageEuclideanDistance.h.

int vtkImageEuclideanDistance::Initialize
protected

Definition at line 119 of file vtkImageEuclideanDistance.h.

int vtkImageEuclideanDistance::ConsiderAnisotropy
protected

Definition at line 120 of file vtkImageEuclideanDistance.h.

int vtkImageEuclideanDistance::Algorithm
protected

Definition at line 121 of file vtkImageEuclideanDistance.h.


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