Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members File Members Related Pages
vtkImageEuclideanDistance Class Reference
computes 3D Euclidean DT.
More...
#include <vtkImageEuclideanDistance.h>
Inheritance diagram for vtkImageEuclideanDistance:
[legend]Collaboration diagram for vtkImageEuclideanDistance:
[legend]List of all members.
Detailed Description
computes 3D Euclidean DT.
-
Date:
-
2001/12/07 21:10:28
-
Revision:
-
1.9
-
Thanks:
-
Olivier Cuisenaire who developed this class URL: http://ltswww.epfl.ch/~cuisenai Email: Olivier.Cuisenaire@epfl.ch
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 86 of file vtkImageEuclideanDistance.h.
Constructor & Destructor Documentation
| vtkImageEuclideanDistance::vtkImageEuclideanDistance |
( |
|
) |
[protected] |
|
| vtkImageEuclideanDistance::~vtkImageEuclideanDistance |
( |
|
) |
[inline, protected] |
|
Member Function Documentation
| vtkImageEuclideanDistance* vtkImageEuclideanDistance::New |
( |
|
) |
[static] |
|
| virtual const char* vtkImageEuclideanDistance::GetClassName |
( |
|
) |
[virtual] |
|
| int vtkImageEuclideanDistance::IsTypeOf |
( |
const char * |
type |
) |
[static] |
|
| virtual int vtkImageEuclideanDistance::IsA |
( |
const char * |
type |
) |
[virtual] |
|
| vtkImageEuclideanDistance* vtkImageEuclideanDistance::SafeDownCast |
( |
vtkObject * |
o |
) |
[static] |
|
| void vtkImageEuclideanDistance::PrintSelf |
( |
ostream & |
os, |
|
|
vtkIndent |
indent |
|
) |
[virtual] |
|
| int vtkImageEuclideanDistance::SplitExtent |
( |
int |
splitExt[6], |
|
|
int |
startExt[6], |
|
|
int |
num, |
|
|
int |
total |
|
) |
[virtual] |
|
|
|
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.
Reimplemented from vtkImageToImageFilter. |
| 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 |
( |
float |
|
) |
[virtual] |
|
|
|
Any distance bigger than this->MaximumDistance will not ne computed but set to this->MaximumDistance instead. |
| virtual float 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 134 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 136 of file vtkImageEuclideanDistance.h. |
| virtual void vtkImageEuclideanDistance::AllocateOutputScalars |
( |
vtkImageData * |
outData |
) |
[protected, virtual] |
|
| void vtkImageEuclideanDistance::ExecuteInformation |
( |
|
) |
[inline, protected, virtual] |
|
| void vtkImageEuclideanDistance::ComputeInputUpdateExtent |
( |
int |
inExt[6], |
|
|
int |
outExt[6] |
|
) |
[protected, virtual] |
|
Member Data Documentation
float vtkImageEuclideanDistance::MaximumDistance [protected]
|
|
int vtkImageEuclideanDistance::Initialize [protected]
|
|
int vtkImageEuclideanDistance::ConsiderAnisotropy [protected]
|
|
int vtkImageEuclideanDistance::Algorithm [protected]
|
|
The documentation for this class was generated from the following file:
Generated on Thu Mar 28 14:30:28 2002 for VTK by
1.2.11.1 written by Dimitri van Heesch,
© 1997-2001