ITK  4.0.0
Insight Segmentation and Registration Toolkit
Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Types | Protected Member Functions | Private Member Functions | Private Attributes
itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage > Class Template Reference

LandmarkBasedTransformInitializer is a helper class intended to The class computes the transform that aligns the fixed and moving images given a set of landmarks. The class is templated over the Transform type. The transform computed gives the best fit transform that maps the fixed and moving images in a least squares sense. The indices are taken to correspond, so point 1 in the first set will get mapped close to point 1 in the second set, etc. An equal number of fixed and moving landmarks need to be specified using SetFixedLandmarks() SetMovingLandmarks(). Any number of landmarks may be specified. Call InitializeTransform() to initialize the transform. More...

#include <itkLandmarkBasedTransformInitializer.h>

Inheritance diagram for itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >:
Collaboration diagram for itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >:

List of all members.

Public Types

typedef AffineTransform
< ParameterValueType,
FixedImageType::ImageDimension > 
AffineTransformType
typedef SmartPointer< const SelfConstPointer
typedef
FixedImageType::ConstPointer 
FixedImagePointer
typedef TFixedImage FixedImageType
typedef
TransformType::InputPointType 
InputPointType
typedef std::vector
< LandmarkPointType
LandmarkPointContainer
typedef Point< double,
itkGetStaticConstMacro(ImageDimension) > 
LandmarkPointType
typedef
LandmarkWeightType::const_iterator 
LandmarkWeightConstIterator
typedef std::vector< double > LandmarkWeightType
typedef
MovingImageType::ConstPointer 
MovingImagePointer
typedef TMovingImage MovingImageType
typedef
TransformType::OutputVectorType 
OutputVectorType
typedef
TransformType::ParametersType 
ParametersType
typedef ParametersType::ValueType ParameterValueType
typedef SmartPointer< SelfPointer
typedef
LandmarkPointContainer::const_iterator 
PointsContainerConstIterator
typedef Rigid2DTransform
< ParameterValueType
Rigid2DTransformType
typedef
LandmarkBasedTransformInitializer 
Self
typedef Object Superclass
typedef TransformType::Pointer TransformPointer
typedef TTransform TransformType
typedef VersorRigid3DTransform
< ParameterValueType
VersorRigid3DTransformType

Public Member Functions

virtual ::itk::LightObject::Pointer CreateAnother (void) const
virtual const char * GetNameOfClass () const
virtual void InitializeTransform ()
void SetFixedLandmarks (const LandmarkPointContainer &fixedLandmarks)
void SetLandmarkWeight (LandmarkWeightType &landmarkWeight)
void SetMovingLandmarks (const LandmarkPointContainer &movingLandmarks)
virtual void SetTransform (TransformType *_arg)

Static Public Member Functions

static Pointer New ()

Static Public Attributes

static const unsigned int ImageDimension = FixedImageType::ImageDimension
static const unsigned int InputSpaceDimension = TransformType::InputSpaceDimension
static const unsigned int OutputSpaceDimension = TransformType::OutputSpaceDimension

Protected Types

enum  InputTransformType {
  VersorRigid3Dtransform = 1,
  Rigid2Dtransfrom,
  Else
}

Protected Member Functions

 LandmarkBasedTransformInitializer ()
void PrintSelf (std::ostream &os, Indent indent) const
 ~LandmarkBasedTransformInitializer ()

Private Member Functions

template<class TTransform2 >
void InternalInitializeTransform (TTransform *)
void InternalInitializeTransform (VersorRigid3DTransformType *)
void InternalInitializeTransform (Rigid2DTransformType *)
void InternalInitializeTransform (AffineTransformType *)
 LandmarkBasedTransformInitializer (const Self &)
void operator= (const Self &)

Private Attributes

FixedImagePointer m_FixedImage
LandmarkPointContainer m_FixedLandmarks
LandmarkWeightType m_LandmarkWeight
MovingImagePointer m_MovingImage
LandmarkPointContainer m_MovingLandmarks
TransformPointer m_Transform

Detailed Description

template<class TTransform, class TFixedImage, class TMovingImage>
class itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >

LandmarkBasedTransformInitializer is a helper class intended to The class computes the transform that aligns the fixed and moving images given a set of landmarks. The class is templated over the Transform type. The transform computed gives the best fit transform that maps the fixed and moving images in a least squares sense. The indices are taken to correspond, so point 1 in the first set will get mapped close to point 1 in the second set, etc. An equal number of fixed and moving landmarks need to be specified using SetFixedLandmarks() SetMovingLandmarks(). Any number of landmarks may be specified. Call InitializeTransform() to initialize the transform.

Currently, the following transforms are supported by the class: VersorRigid3DTransform Rigid2DTransform

The class is based in part on Hybrid/vtkLandmarkTransform originally implemented in python by David G. Gobbi.

The solution is based on Berthold K. P. Horn (1987), "Closed-form solution of absolute orientation using unit quaternions," http://people.csail.mit.edu/bkph/papers/Absolute_Orientation.pdf

The Affine Transform initializer is based on an algorithm by H Spaeth, and is described in the Insight Journal Article "Affine Transformation for Landmark Based Registration Initializer in ITK" by Kim E.Y., Johnson H., Williams N. available at http://midasjournal.com/browse/publication/825

Wiki Examples:

Definition at line 70 of file itkLandmarkBasedTransformInitializer.h.


Member Typedef Documentation

template<class TTransform , class TFixedImage , class TMovingImage >
typedef AffineTransform< ParameterValueType, FixedImageType::ImageDimension > itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::AffineTransformType

Definition at line 143 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef SmartPointer< const Self > itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::ConstPointer

Reimplemented from itk::Object.

Definition at line 78 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef FixedImageType::ConstPointer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::FixedImagePointer

Definition at line 103 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef TFixedImage itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::FixedImageType

Image Types to use in the initialization of the transform

Definition at line 96 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef TransformType::InputPointType itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::InputPointType

Convenience typedefs

Definition at line 110 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef std::vector< LandmarkPointType > itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::LandmarkPointContainer

Definition at line 113 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef Point< double, itkGetStaticConstMacro(ImageDimension) > itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::LandmarkPointType

Definition at line 112 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef LandmarkWeightType::const_iterator itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::LandmarkWeightConstIterator

Definition at line 118 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef std::vector< double > itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::LandmarkWeightType

Definition at line 117 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef MovingImageType::ConstPointer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::MovingImagePointer

Definition at line 104 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef TMovingImage itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::MovingImageType

Definition at line 100 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef TransformType::OutputVectorType itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::OutputVectorType

Definition at line 111 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef TransformType::ParametersType itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::ParametersType

Definition at line 115 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef ParametersType::ValueType itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::ParameterValueType

Definition at line 116 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef SmartPointer< Self > itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::Pointer

Reimplemented from itk::Object.

Definition at line 77 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef LandmarkPointContainer::const_iterator itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::PointsContainerConstIterator

Definition at line 114 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef Rigid2DTransform< ParameterValueType > itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::Rigid2DTransformType

Definition at line 142 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef LandmarkBasedTransformInitializer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::Self

Standard class typedefs.

Reimplemented from itk::Object.

Definition at line 75 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef Object itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::Superclass

Reimplemented from itk::Object.

Definition at line 76 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef TransformType::Pointer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::TransformPointer

Definition at line 88 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef TTransform itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::TransformType

Type of the transform to initialize

Definition at line 84 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
typedef VersorRigid3DTransform< ParameterValueType > itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::VersorRigid3DTransformType

Supported Transform typedefs

Definition at line 141 of file itkLandmarkBasedTransformInitializer.h.


Member Enumeration Documentation

template<class TTransform , class TFixedImage , class TMovingImage >
enum itk::LandmarkBasedTransformInitializer::InputTransformType [protected]
Enumerator:
VersorRigid3Dtransform 
Rigid2Dtransfrom 
Else 

Definition at line 155 of file itkLandmarkBasedTransformInitializer.h.


Constructor & Destructor Documentation

template<class TTransform , class TFixedImage , class TMovingImage >
itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::LandmarkBasedTransformInitializer ( ) [protected]
template<class TTransform , class TFixedImage , class TMovingImage >
itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::~LandmarkBasedTransformInitializer ( ) [inline, protected]

Definition at line 150 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::LandmarkBasedTransformInitializer ( const Self ) [private]

Member Function Documentation

template<class TTransform , class TFixedImage , class TMovingImage >
virtual::itk::LightObject::Pointer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::CreateAnother ( void  ) const [virtual]

Create an object from an instance, potentially deferring to a factory. This method allows you to create an instance of an object that is exactly the same type as the referring object. This is useful in cases where an object has been cast back to a base class.

Reimplemented from itk::Object.

template<class TTransform , class TFixedImage , class TMovingImage >
virtual const char* itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::GetNameOfClass ( ) const [virtual]

Run-time type information (and related methods).

Reimplemented from itk::Object.

template<class TTransform , class TFixedImage , class TMovingImage >
virtual void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::InitializeTransform ( ) [virtual]

Initialize the transform from the landmarks

template<class TTransform , class TFixedImage , class TMovingImage >
template<class TTransform2 >
void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::InternalInitializeTransform ( TTransform *  ) [private]

fallback Initializer just sets transform to identity

template<class TTransform , class TFixedImage , class TMovingImage >
void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::InternalInitializeTransform ( VersorRigid3DTransformType ) [private]

Initializer for VersorRigid3D

template<class TTransform , class TFixedImage , class TMovingImage >
void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::InternalInitializeTransform ( Rigid2DTransformType ) [private]

Initializer for Rigid2DTransform

template<class TTransform , class TFixedImage , class TMovingImage >
void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::InternalInitializeTransform ( AffineTransformType ) [private]

Initializer for AffineTransform

template<class TTransform , class TFixedImage , class TMovingImage >
static Pointer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::New ( ) [static]

New macro for creation of through a Smart Pointer.

Reimplemented from itk::Object.

template<class TTransform , class TFixedImage , class TMovingImage >
void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::operator= ( const Self ) [private]

Mutex lock to protect modification to the reference count

Reimplemented from itk::Object.

template<class TTransform , class TFixedImage , class TMovingImage >
void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::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::Object.

template<class TTransform , class TFixedImage , class TMovingImage >
void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::SetFixedLandmarks ( const LandmarkPointContainer fixedLandmarks) [inline]

Set the Fixed landmark point containers

Definition at line 121 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::SetLandmarkWeight ( LandmarkWeightType landmarkWeight) [inline]

Set the landmark weight point containers Weight includes diagonal elements of weight matrix

Definition at line 135 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::SetMovingLandmarks ( const LandmarkPointContainer movingLandmarks) [inline]

Set the Moving landmark point containers

Definition at line 127 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
virtual void itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::SetTransform ( TransformType _arg) [virtual]

Set the transform to be initialized


Member Data Documentation

template<class TTransform , class TFixedImage , class TMovingImage >
const unsigned int itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::ImageDimension = FixedImageType::ImageDimension [static]

Determine the image dimension.

Definition at line 107 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
const unsigned int itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::InputSpaceDimension = TransformType::InputSpaceDimension [static]

Dimension of parameters.

Definition at line 91 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
FixedImagePointer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::m_FixedImage [private]

Definition at line 178 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
LandmarkPointContainer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::m_FixedLandmarks [private]

Definition at line 181 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
LandmarkWeightType itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::m_LandmarkWeight [private]

weights for affine landmarks

Definition at line 186 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
MovingImagePointer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::m_MovingImage [private]

Definition at line 179 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
LandmarkPointContainer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::m_MovingLandmarks [private]

Definition at line 182 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
TransformPointer itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::m_Transform [private]

Definition at line 184 of file itkLandmarkBasedTransformInitializer.h.

template<class TTransform , class TFixedImage , class TMovingImage >
const unsigned int itk::LandmarkBasedTransformInitializer< TTransform, TFixedImage, TMovingImage >::OutputSpaceDimension = TransformType::OutputSpaceDimension [static]

Dimension of parameters.

Definition at line 92 of file itkLandmarkBasedTransformInitializer.h.


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