itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage > Class Template Reference
[Image Feature Extraction Filters]

Base class for ImagePCAShapeModelEstimator object. More...

#include <itkImagePCAShapeModelEstimator.h>

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

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

[legend]List of all members.

Public Types
typedef ImagePCAShapeModelEstimator	Self
typedef ImageShapeModelEstimatorBase< TInputImage, TOutputImage >	Superclass
typedef SmartPointer< Self >	Pointer
typedef SmartPointer< const Self >	ConstPointer
typedef TInputImage	InputImageType
typedef TInputImage::Pointer	InputImagePointer
typedef TInputImage::ConstPointer	InputImageConstPointer
typedef TInputImage::PixelType	InputImagePixelType
typedef ImageRegionIterator< TInputImage >	InputImageIterator
typedef ImageRegionConstIterator< TInputImage >	InputImageConstIterator
typedef TOutputImage	OutputImageType
typedef TOutputImage::Pointer	OutputImagePointer
typedef ImageRegionIterator< TOutputImage >	OutputImageIterator
typedef vnl_matrix< double >	MatrixOfDoubleType
typedef vnl_matrix< int >	MatrixOfIntegerType
typedef vnl_vector< double >	VectorOfDoubleType
Public Member Functions
virtual const char *	GetNameOfClass () const
	itkStaticConstMacro (InputImageDimension, unsigned int, TInputImage::ImageDimension)
virtual VectorOfDoubleType	GetEigenValues ()
virtual void	SetNumberOfPrincipalComponentsRequired (unsigned int n)
virtual unsigned int	GetNumberOfPrincipalComponentsRequired ()
virtual void	SetNumberOfTrainingImages (unsigned int n)
virtual unsigned int	GetNumberOfTrainingImages ()
Static Public Member Functions
Pointer	New ()
Protected Member Functions
	ImagePCAShapeModelEstimator ()
	~ImagePCAShapeModelEstimator ()
virtual void	PrintSelf (std::ostream &os, Indent indent) const
virtual void	EnlargeOutputRequestedRegion (DataObject *)
virtual void	GenerateInputRequestedRegion ()
void	GenerateData ()

---

Detailed Description

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>>
class itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >

Base class for ImagePCAShapeModelEstimator object.

itkImagePCAShapeModelEstimator performs a principal component analysis (PCA) on a set of images. The user specifies the number of training images and also the number of desired largest principal components needed. The ITK pipeline mechanism sets up the storage for both input and output images. The number of output images are the user specified number of desired largest principal components plus 1 (for the mean image).

The algorithm uses the VNL library to perform the eigen analysis. To speed the computation of the instead of performing the eigen analysis of the covariance vector A*A' where A is a matrix with p x t, p = number of pixels or voxels in each images and t = number of training images, we calculate the eigen vectors of the inner product matrix A'*A. The resulting eigen vectors (E) are then multiplied with the the matrix A to get the principal compoenets. The covariance matrix has a dimension of p x p. Since number of pixels in any image being typically very high the eigen decomposition becomes computationally expensive. The inner product on the other hand has the dimension of t x t, where t is typically much smaller that p. Hence the eigen decomposition (most compute intensive part) is an orders of magnitude faster.

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

Definition at line 72 of file itkImagePCAShapeModelEstimator.h.

---

Member Typedef Documentation

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef SmartPointer<const Self> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::ConstPointer

Reimplemented from itk::ImageShapeModelEstimatorBase< TInputImage, TOutputImage >. Definition at line 80 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef ImageRegionConstIterator<TInputImage> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::InputImageConstIterator

Definition at line 101 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef TInputImage::ConstPointer itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::InputImageConstPointer

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

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef ImageRegionIterator<TInputImage> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::InputImageIterator

Type definition for the input image iterator type. Definition at line 98 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef TInputImage::PixelType itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::InputImagePixelType

Type definition for the input image pixel type. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 94 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef TInputImage::Pointer itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::InputImagePointer

Reimplemented from itk::ImageShapeModelEstimatorBase< TInputImage, TOutputImage >. Definition at line 90 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef TInputImage itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::InputImageType

Type definition for the input image. Reimplemented from itk::ImageShapeModelEstimatorBase< TInputImage, TOutputImage >. Definition at line 89 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef vnl_matrix<double> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::MatrixOfDoubleType

Type definition for a double matrix. Definition at line 116 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef vnl_matrix<int> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::MatrixOfIntegerType

Type definition for an integer vector. Definition at line 119 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef ImageRegionIterator<TOutputImage> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::OutputImageIterator

Type definition for the input image iterator type. Definition at line 113 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef TOutputImage::Pointer itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::OutputImagePointer

Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 109 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef TOutputImage itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::OutputImageType

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

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef SmartPointer<Self> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::Pointer

Reimplemented from itk::ImageShapeModelEstimatorBase< TInputImage, TOutputImage >. Definition at line 79 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef ImagePCAShapeModelEstimator itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::Self

Standard class typedefs. Reimplemented from itk::ImageShapeModelEstimatorBase< TInputImage, TOutputImage >. Definition at line 77 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef ImageShapeModelEstimatorBase<TInputImage, TOutputImage> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::Superclass

Reimplemented from itk::ImageShapeModelEstimatorBase< TInputImage, TOutputImage >. Definition at line 78 of file itkImagePCAShapeModelEstimator.h.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> typedef vnl_vector<double> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::VectorOfDoubleType

Type definition for a double vector. Definition at line 122 of file itkImagePCAShapeModelEstimator.h.

---

Constructor & Destructor Documentation

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::ImagePCAShapeModelEstimator (   )  [protected]

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::~ImagePCAShapeModelEstimator (   )  [protected]

---

Member Function Documentation

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> virtual void itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::EnlargeOutputRequestedRegion (  DataObject *   )  [protected, virtual]

This filter must produce all of the outputs at once, as such it must override the EnlargeOutputRequestedRegion method to enlarge the output request region. Reimplemented from itk::ProcessObject.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> void itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::GenerateData (   )  [protected, virtual]

Starts the image modelling process Reimplemented from itk::ImageShapeModelEstimatorBase< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> virtual void itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::GenerateInputRequestedRegion (   )  [protected, virtual]

This filter requires all the input image at once, as such it must override the GenerateInputRequestedRegion method. Additionally, this filter assumes that the input images are at least the size as the first input image. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> virtual VectorOfDoubleType itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::GetEigenValues (   )  [virtual]

Get the eigen values

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> virtual const char* itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::GetNameOfClass (   )  const [virtual]

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

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> virtual unsigned int itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::GetNumberOfPrincipalComponentsRequired (   )  [virtual]

Set/Get the number of required largest principal components. The filter produces the required number of principal components plus one outputs. Output index 0 represents the mean image and the remaining outputs the requested principal components.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> virtual unsigned int itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::GetNumberOfTrainingImages (   )  [virtual]

Set/Get the number of training images in the input.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::itkStaticConstMacro (  InputImageDimension  , unsigned  int, TInputImage::ImageDimension  )

Input Image dimension Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> Pointer itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::New (   )  [static]

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

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> virtual void itk::ImagePCAShapeModelEstimator< 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::ImageShapeModelEstimatorBase< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> virtual void itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::SetNumberOfPrincipalComponentsRequired (  unsigned int  n  )  [virtual]

Set/Get the number of required largest principal components. The filter produces the required number of principal components plus one outputs. Output index 0 represents the mean image and the remaining outputs the requested principal components.

template<class TInputImage, class TOutputImage = Image<double, ::itk::GetImageDimension<TInputImage>::ImageDimension>> virtual void itk::ImagePCAShapeModelEstimator< TInputImage, TOutputImage >::SetNumberOfTrainingImages (  unsigned int  n  )  [virtual]

Set/Get the number of training images in the input.

---

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

• itkImagePCAShapeModelEstimator.h

---