vtkProcrustesAlignmentFilter Class Reference

#include <vtkProcrustesAlignmentFilter.h>

Inheritance diagram for vtkProcrustesAlignmentFilter:

Inheritance graph
[legend]
Collaboration diagram for vtkProcrustesAlignmentFilter:

Collaboration graph
[legend]

List of all members.


Detailed Description

aligns a set of pointsets together

vtkProcrustesAlignmentFilter is a filter that takes a set of pointsets (any object derived from vtkPointSet) and aligns them in a least-squares sense to their mutual mean. The algorithm is iterated until convergence, as the mean must be recomputed after each alignment.

Call SetNumberOfInputs(n) before calling SetInput(0) ... SetInput(n-1).

Retrieve the outputs using GetOutput(0) ... GetOutput(n-1).

The default (in vtkLandmarkTransform) is for a similarity alignment. For a rigid-body alignment (to build a 'size-and-shape' model) use:

GetLandmarkTransform()->SetModeToRigidBody().

Affine alignments are not normally used but are left in for completeness:

GetLandmarkTransform()->SetModeToAffine().

vtkProcrustesAlignmentFilter is an implementation of:

J.C. Gower (1975) Generalized Procrustes Analysis. Psychometrika, 40:33-51.

Warning:
All of the input pointsets must have the same number of points.
Thanks:
Tim Hutton and Rasmus Paulsen who developed and contributed this class
See also:
vtkLandmarkTransform
Examples:
vtkProcrustesAlignmentFilter (Examples)
Tests:
vtkProcrustesAlignmentFilter (Tests)

Definition at line 67 of file vtkProcrustesAlignmentFilter.h.


Public Types

typedef vtkPointSetAlgorithm Superclass

Public Member Functions

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
void SetNumberOfInputs (int n)
vtkPointSetGetInput (int idx)
virtual vtkLandmarkTransformGetLandmarkTransform ()
virtual vtkPointsGetMeanPoints ()
void SetInput (int idx, vtkPointSet *p)
void SetInput (int idx, vtkDataObject *input)

Static Public Member Functions

static int IsTypeOf (const char *type)
static
vtkProcrustesAlignmentFilter
SafeDownCast (vtkObject *o)
static
vtkProcrustesAlignmentFilter
New ()

Protected Member Functions

 vtkProcrustesAlignmentFilter ()
 ~vtkProcrustesAlignmentFilter ()
virtual int RequestData (vtkInformation *, vtkInformationVector **, vtkInformationVector *)
virtual int FillInputPortInformation (int port, vtkInformation *info)

Protected Attributes

vtkLandmarkTransformLandmarkTransform
vtkPointsMeanPoints

Member Typedef Documentation

Reimplemented from vtkPointSetAlgorithm.

Definition at line 70 of file vtkProcrustesAlignmentFilter.h.


Constructor & Destructor Documentation

vtkProcrustesAlignmentFilter::vtkProcrustesAlignmentFilter (  )  [protected]

vtkProcrustesAlignmentFilter::~vtkProcrustesAlignmentFilter (  )  [protected]


Member Function Documentation

virtual const char* vtkProcrustesAlignmentFilter::GetClassName (  )  [virtual]

Reimplemented from vtkPointSetAlgorithm.

static int vtkProcrustesAlignmentFilter::IsTypeOf ( const char *  name  )  [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkPointSetAlgorithm.

virtual int vtkProcrustesAlignmentFilter::IsA ( const char *  name  )  [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkPointSetAlgorithm.

static vtkProcrustesAlignmentFilter* vtkProcrustesAlignmentFilter::SafeDownCast ( vtkObject o  )  [static]

Reimplemented from vtkPointSetAlgorithm.

void vtkProcrustesAlignmentFilter::PrintSelf ( ostream &  os,
vtkIndent  indent 
) [virtual]

Prints information about the state of the filter.

Reimplemented from vtkPointSetAlgorithm.

static vtkProcrustesAlignmentFilter* vtkProcrustesAlignmentFilter::New (  )  [static]

Creates with similarity transform.

Reimplemented from vtkPointSetAlgorithm.

virtual vtkLandmarkTransform* vtkProcrustesAlignmentFilter::GetLandmarkTransform (  )  [virtual]

Get the internal landmark transform. Use it to constrain the number of degrees of freedom of the alignment (i.e. rigid body, similarity, etc.). The default is a similarity alignment.

virtual vtkPoints* vtkProcrustesAlignmentFilter::GetMeanPoints (  )  [virtual]

Get the estimated mean point cloud

void vtkProcrustesAlignmentFilter::SetNumberOfInputs ( int  n  ) 

Specify how many pointsets are going to be given as input.

void vtkProcrustesAlignmentFilter::SetInput ( int  idx,
vtkPointSet p 
)

Specify the input pointset with index idx. Call SetNumberOfInputs before calling this function.

Reimplemented from vtkPointSetAlgorithm.

void vtkProcrustesAlignmentFilter::SetInput ( int  idx,
vtkDataObject input 
)

Specify the input pointset with index idx. Call SetNumberOfInputs before calling this function.

Reimplemented from vtkPointSetAlgorithm.

vtkPointSet* vtkProcrustesAlignmentFilter::GetInput ( int  idx  ) 

Retrieve the input point set with index idx (usually only for pipeline tracing).

virtual int vtkProcrustesAlignmentFilter::RequestData ( vtkInformation ,
vtkInformationVector **  ,
vtkInformationVector  
) [protected, virtual]

Usual data generation method.

Reimplemented from vtkPointSetAlgorithm.

virtual int vtkProcrustesAlignmentFilter::FillInputPortInformation ( int  port,
vtkInformation info 
) [protected, virtual]

Fill the input port information objects for this algorithm. This is invoked by the first call to GetInputPortInformation for each port so subclasses can specify what they can handle.

Reimplemented from vtkPointSetAlgorithm.


Member Data Documentation

Definition at line 113 of file vtkProcrustesAlignmentFilter.h.

Definition at line 115 of file vtkProcrustesAlignmentFilter.h.


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

Generated on Sat Dec 27 13:44:57 2008 for VTK by  doxygen 1.5.6