itk::ActiveShapeModelCalculator< TImage > Class Template Reference
[Operators]

Base class for ActiveShapeModelCalculator object. More...

#include <itkActiveShapeModelCalculator.h>

Inheritance diagram for itk::ActiveShapeModelCalculator< TImage >:

[legend]Collaboration diagram for itk::ActiveShapeModelCalculator< TImage >:

[legend]List of all members.

Public Types
typedef ActiveShapeModelCalculator< TImage >	Self
typedef Object	Superclass
typedef SmartPointer< Self >	Pointer
typedef SmartPointer< const Self >	ConstPointer
typedef float	PixelType
typedef unsigned char	Pixel8bitsType
typedef Vector< double, 2 >	Vector2DType
typedef Vector< double, 3 >	Vector3DType
typedef Vector< unsigned int, 2 >	MeasurementVectorType
typedef std::vector< unsigned int >	VectorType
typedef vnl_vector< double >	VectorOfDoubleType
typedef vnl_matrix< double >	MatrixOfDoubleType
typedef vnl_matrix< int >	MatrixOfIntegerType
typedef TImage	Image3DType
typedef Image< PixelType, 2 >	Image2DType
typedef Image< Pixel8bitsType, 2 >	Image2D8bitsType
typedef Image< Pixel8bitsType, 3 >	Image3D8bitsType
typedef Image2D8bitsType::IndexType	IndexType
typedef Image3DType::IndexType	Index3DType
typedef Image2DType::Pointer	Image2DPointer
typedef Image3DType::ConstPointer	Image3DConstPointer
typedef PointSet< unsigned short, 2 >	PointSetType
typedef PointSetType::PointType	PointType
typedef PointSetType::PointsContainer	PointsContainer
typedef PointSetType::PointDataContainer	PointDataContainer
typedef std::list< IndexType >	List2DType
typedef Statistics::ListSample< MeasurementVectorType >	SampleType
typedef ImageLinearIteratorWithIndex< Image2DType >	LinearIteratorType
typedef ImageSliceConstIteratorWithIndex< Image3DType >	SliceIteratorType
typedef ImageRegionConstIterator< Image3D8bitsType >	ConstIteratorType
typedef ImageRegionIterator< Image2D8bitsType >	IteratorType
typedef NeighborhoodIterator< Image2D8bitsType >	NeighborIteratorType
typedef PointsContainer::Iterator	PointsIterator
typedef GradientMagnitudeImageFilter< Image3DType, Image3DType >	GradientFilterType
typedef BinaryThresholdImageFilter< Image3DType, Image3DType >	BinaryFilterType
typedef BinaryThresholdImageFilter< Image2DType, Image2D8bitsType >	BinaryFilterType1
typedef BinaryThresholdImageFilter< Image3DType, Image3D8bitsType >	BinaryFilterType2
typedef DanielssonDistanceMapImageFilter< Image3DType, Image3DType >	DistanceMapFilterType
typedef BinaryThinningImageFilter< Image2D8bitsType, Image2D8bitsType >	ThinFilterType
typedef BinaryPruningImageFilter< Image2D8bitsType, Image2D8bitsType >	PruneFilterType
Public Member Functions
virtual const char *	GetNameOfClass () const
const unsigned int &	GetNumberOfTrainingImages () const
void	GenerateData ()
VectorOfDoubleType	GetMeanShape ()
VectorOfDoubleType	GetEigenvalues ()
MatrixOfDoubleType	GetEigenvector ()
virtual void	SetImage (const Image3DType *image)
void	SetLowerThresholdGradient (const double &lt)
const double &	GetLowerThresholdGradient () const
void	SetUpperThresholdMeanDistance (const double &ut1)
const double &	GetUpperThresholdMeanDistance () const
void	SetUpperThresholdDistance (const double &ut2)
const double &	GetUpperThresholdDistance () const
void	SetTolerance (const double &t)
const double &	GetTolerance () const
void	SetPruneIteration (const unsigned int &t)
const unsigned int &	GetPruneIteration () const
Static Public Member Functions
Pointer	New ()
Protected Member Functions
	ActiveShapeModelCalculator ()
	~ActiveShapeModelCalculator ()
void	PrintSelf (std::ostream &os, Indent indent) const

---

Detailed Description

template<class TImage>
class itk::ActiveShapeModelCalculator< TImage >

Base class for ActiveShapeModelCalculator object.

itkActiveShapeModelCalculator performs a principal component analysis (PCA) on a set of binary tranining images. The input is a binary volume that contains the shapes. The number of largest principal components which explain 98% of shape variance is automatically computed. The ITK pipeline mechanism sets up the storage for input images. The outputs are the mean shape, eigenvectors and eigenvalues. The user specifies the tolerance value (in pixel unit) for automatic landmark identification. The algorithm uses the VNL library to perform the eigen analysis.

The Update() function enables the calculation of the various models, creates the membership function objects and populates them.

REFERENCES

[1] Cootes T., Taylor C., et. al, Active Shape Models - Their training and application, Comput. Vis. Image Understanding, vol. 61, pp. 38-59, 1995.

[2] D. H. Douglas and T. K. Peucker, Algorithms for the reduction of the number of points required to represent a digitized line or its caricature, Canadian Cartographer 10(2), pp. 112--122, 1973.

Definition at line 77 of file itkActiveShapeModelCalculator.h.

---

Member Typedef Documentation

template<class TImage> typedef BinaryThresholdImageFilter<Image3DType, Image3DType > itk::ActiveShapeModelCalculator< TImage >::BinaryFilterType

Definition at line 149 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef BinaryThresholdImageFilter<Image2DType, Image2D8bitsType > itk::ActiveShapeModelCalculator< TImage >::BinaryFilterType1

Definition at line 150 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef BinaryThresholdImageFilter<Image3DType, Image3D8bitsType > itk::ActiveShapeModelCalculator< TImage >::BinaryFilterType2

Definition at line 151 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef ImageRegionConstIterator< Image3D8bitsType > itk::ActiveShapeModelCalculator< TImage >::ConstIteratorType

Definition at line 142 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef SmartPointer<const Self> itk::ActiveShapeModelCalculator< TImage >::ConstPointer

Reimplemented from itk::Object. Definition at line 84 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef DanielssonDistanceMapImageFilter< Image3DType, Image3DType > itk::ActiveShapeModelCalculator< TImage >::DistanceMapFilterType

Definition at line 152 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef GradientMagnitudeImageFilter< Image3DType, Image3DType > itk::ActiveShapeModelCalculator< TImage >::GradientFilterType

Standard filter type within this class. Definition at line 148 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Image< Pixel8bitsType, 2 > itk::ActiveShapeModelCalculator< TImage >::Image2D8bitsType

Definition at line 116 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Image2DType::Pointer itk::ActiveShapeModelCalculator< TImage >::Image2DPointer

Standard image type pointer within this class. Definition at line 124 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Image< PixelType, 2 > itk::ActiveShapeModelCalculator< TImage >::Image2DType

Definition at line 115 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Image< Pixel8bitsType, 3 > itk::ActiveShapeModelCalculator< TImage >::Image3D8bitsType

Definition at line 117 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Image3DType::ConstPointer itk::ActiveShapeModelCalculator< TImage >::Image3DConstPointer

Definition at line 125 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef TImage itk::ActiveShapeModelCalculator< TImage >::Image3DType

Standard image type within this class. Definition at line 114 of file itkActiveShapeModelCalculator.h. Referenced by itk::ActiveShapeModelCalculator< TImage >::SetImage().

template<class TImage> typedef Image3DType::IndexType itk::ActiveShapeModelCalculator< TImage >::Index3DType

Definition at line 121 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Image2D8bitsType::IndexType itk::ActiveShapeModelCalculator< TImage >::IndexType

Standard index type within this class. Definition at line 120 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef ImageRegionIterator< Image2D8bitsType > itk::ActiveShapeModelCalculator< TImage >::IteratorType

Definition at line 143 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef ImageLinearIteratorWithIndex< Image2DType > itk::ActiveShapeModelCalculator< TImage >::LinearIteratorType

Standard iterator type within this class. Definition at line 140 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef std::list<IndexType> itk::ActiveShapeModelCalculator< TImage >::List2DType

Standard list type within this class. Definition at line 136 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef vnl_matrix<double> itk::ActiveShapeModelCalculator< TImage >::MatrixOfDoubleType

Standard matrix type within this class. Definition at line 110 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef vnl_matrix<int> itk::ActiveShapeModelCalculator< TImage >::MatrixOfIntegerType

Definition at line 111 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Vector< unsigned int, 2 > itk::ActiveShapeModelCalculator< TImage >::MeasurementVectorType

Definition at line 103 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef NeighborhoodIterator< Image2D8bitsType > itk::ActiveShapeModelCalculator< TImage >::NeighborIteratorType

Definition at line 144 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef unsigned char itk::ActiveShapeModelCalculator< TImage >::Pixel8bitsType

Definition at line 98 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef float itk::ActiveShapeModelCalculator< TImage >::PixelType

Standard pixel type within this class. Definition at line 97 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef PointSetType::PointDataContainer itk::ActiveShapeModelCalculator< TImage >::PointDataContainer

Definition at line 133 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef SmartPointer<Self> itk::ActiveShapeModelCalculator< TImage >::Pointer

Reimplemented from itk::Object. Definition at line 83 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef PointSetType::PointsContainer itk::ActiveShapeModelCalculator< TImage >::PointsContainer

Standard container type within this class. Definition at line 132 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef PointSet< unsigned short, 2 > itk::ActiveShapeModelCalculator< TImage >::PointSetType

Standard PointSet type within this class. Definition at line 128 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef PointsContainer::Iterator itk::ActiveShapeModelCalculator< TImage >::PointsIterator

Definition at line 145 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef PointSetType::PointType itk::ActiveShapeModelCalculator< TImage >::PointType

Definition at line 129 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef BinaryPruningImageFilter< Image2D8bitsType, Image2D8bitsType > itk::ActiveShapeModelCalculator< TImage >::PruneFilterType

Definition at line 154 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Statistics::ListSample< MeasurementVectorType > itk::ActiveShapeModelCalculator< TImage >::SampleType

Definition at line 137 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef ActiveShapeModelCalculator<TImage> itk::ActiveShapeModelCalculator< TImage >::Self

Standard class typedefs. Reimplemented from itk::Object. Definition at line 81 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef ImageSliceConstIteratorWithIndex< Image3DType > itk::ActiveShapeModelCalculator< TImage >::SliceIteratorType

Definition at line 141 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Object itk::ActiveShapeModelCalculator< TImage >::Superclass

Reimplemented from itk::Object. Definition at line 82 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef BinaryThinningImageFilter< Image2D8bitsType, Image2D8bitsType > itk::ActiveShapeModelCalculator< TImage >::ThinFilterType

Definition at line 153 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Vector< double, 2 > itk::ActiveShapeModelCalculator< TImage >::Vector2DType

Standard vector type within this class. Definition at line 101 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef Vector< double, 3 > itk::ActiveShapeModelCalculator< TImage >::Vector3DType

Definition at line 102 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef vnl_vector<double> itk::ActiveShapeModelCalculator< TImage >::VectorOfDoubleType

Definition at line 105 of file itkActiveShapeModelCalculator.h.

template<class TImage> typedef std::vector< unsigned int> itk::ActiveShapeModelCalculator< TImage >::VectorType

Definition at line 104 of file itkActiveShapeModelCalculator.h.

---

Constructor & Destructor Documentation

template<class TImage> itk::ActiveShapeModelCalculator< TImage >::ActiveShapeModelCalculator (   )  [inline, protected]

Definition at line 233 of file itkActiveShapeModelCalculator.h. References NULL.

template<class TImage> itk::ActiveShapeModelCalculator< TImage >::~ActiveShapeModelCalculator (   )  [inline, protected]

Definition at line 248 of file itkActiveShapeModelCalculator.h.

---

Member Function Documentation

template<class TImage> void itk::ActiveShapeModelCalculator< TImage >::GenerateData (   )

Compute mean, eigenvectors and eigenvalues of a new or modified training set. This method computes the mean, eigenvectors and eigenvalues of the training set given as a parameter and stores them in the object. The values of these parameters can then be retrieved by using other methods of this object.

template<class TImage> VectorOfDoubleType itk::ActiveShapeModelCalculator< TImage >::GetEigenvalues (   )

Return the largest t eigenvalues [1 x t]

template<class TImage> MatrixOfDoubleType itk::ActiveShapeModelCalculator< TImage >::GetEigenvector (   )

Return the matrix where each column corresponds to a eigenvector [2n x t]

template<class TImage> const double& itk::ActiveShapeModelCalculator< TImage >::GetLowerThresholdGradient (   )  const [inline]

Set/Get the lower threshold for the binary filter applied on the gradient images. Changing this value from the default is not recommended or necessary but could be used to get thinner contours at the risk of creating an unstable solution. Definition at line 173 of file itkActiveShapeModelCalculator.h.

template<class TImage> VectorOfDoubleType itk::ActiveShapeModelCalculator< TImage >::GetMeanShape (   )

Return the mean Shape of the model (x1 y1 x2 y2 ... xn yn), where n = n. of landmarks

template<class TImage> virtual const char* itk::ActiveShapeModelCalculator< TImage >::GetNameOfClass (   )  const [virtual]

Run-time type information (and related methods). Reimplemented from itk::Object.

template<class TImage> const unsigned int& itk::ActiveShapeModelCalculator< TImage >::GetNumberOfTrainingImages (   )  const [inline]

Get the number of training images. Definition at line 210 of file itkActiveShapeModelCalculator.h.

template<class TImage> const unsigned int& itk::ActiveShapeModelCalculator< TImage >::GetPruneIteration (   )  const [inline]

Set/Get the number of iteration for Prunig filter Definition at line 205 of file itkActiveShapeModelCalculator.h.

template<class TImage> const double& itk::ActiveShapeModelCalculator< TImage >::GetTolerance (   )  const [inline]

Set/Get the tolerance threshold (in pixels unit) for the automatic landmarks. Definition at line 198 of file itkActiveShapeModelCalculator.h.

template<class TImage> const double& itk::ActiveShapeModelCalculator< TImage >::GetUpperThresholdDistance (   )  const [inline]

Set/Get the distance threshold for the binary filter applied on the distance images Changing this value from the default is not recommended or necessary but could be used to get thicker contours at the risk of creating an unstable solution. Definition at line 191 of file itkActiveShapeModelCalculator.h.

template<class TImage> const double& itk::ActiveShapeModelCalculator< TImage >::GetUpperThresholdMeanDistance (   )  const [inline]

Set/Get the distance threshold for the binary filter applied on the mean of the distance images. Changing this value from the default is not recommended or necessary but could be used to get thicker contours at the risk of creating an unstable solution. Definition at line 182 of file itkActiveShapeModelCalculator.h.

template<class TImage> Pointer itk::ActiveShapeModelCalculator< TImage >::New (   )  [static]

Method for creation through the object factory. Reimplemented from itk::Object.

template<class TImage> void itk::ActiveShapeModelCalculator< TImage >::PrintSelf (  std::ostream &  os, Indent  indent )  const [inline, 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::Object. Definition at line 250 of file itkActiveShapeModelCalculator.h.

template<class TImage> virtual void itk::ActiveShapeModelCalculator< TImage >::SetImage (  const Image3DType *  image  )  [inline, virtual]

Set the input binary image (values in {0,255}) . Definition at line 157 of file itkActiveShapeModelCalculator.h. References itk::ActiveShapeModelCalculator< TImage >::Image3DType.

template<class TImage> void itk::ActiveShapeModelCalculator< TImage >::SetLowerThresholdGradient (  const double &  lt  )  [inline]

Set/Get the lower threshold for the binary filter applied on the gradient images. Changing this value from the default is not recommended or necessary but could be used to get thinner contours at the risk of creating an unstable solution. Definition at line 171 of file itkActiveShapeModelCalculator.h.

template<class TImage> void itk::ActiveShapeModelCalculator< TImage >::SetPruneIteration (  const unsigned int &  t  )  [inline]

Set/Get the number of iteration for Prunig filter Definition at line 203 of file itkActiveShapeModelCalculator.h.

template<class TImage> void itk::ActiveShapeModelCalculator< TImage >::SetTolerance (  const double &  t  )  [inline]

Set/Get the tolerance threshold (in pixels unit) for the automatic landmarks. Definition at line 196 of file itkActiveShapeModelCalculator.h.

template<class TImage> void itk::ActiveShapeModelCalculator< TImage >::SetUpperThresholdDistance (  const double &  ut2  )  [inline]

Set/Get the distance threshold for the binary filter applied on the distance images Changing this value from the default is not recommended or necessary but could be used to get thicker contours at the risk of creating an unstable solution. Definition at line 189 of file itkActiveShapeModelCalculator.h.

template<class TImage> void itk::ActiveShapeModelCalculator< TImage >::SetUpperThresholdMeanDistance (  const double &  ut1  )  [inline]

Set/Get the distance threshold for the binary filter applied on the mean of the distance images. Changing this value from the default is not recommended or necessary but could be used to get thicker contours at the risk of creating an unstable solution. Definition at line 180 of file itkActiveShapeModelCalculator.h.

---

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

• itkActiveShapeModelCalculator.h

---