itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField > Class Template Reference
[Finite Difference Functions]

#include <itkSymmetricForcesDemonsRegistrationFunction.h>

Inheritance diagram for itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >:

[legend]Collaboration diagram for itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >:

[legend]List of all members.

Public Types
typedef SymmetricForcesDemonsRegistrationFunction	Self
typedef PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >	Superclass
typedef SmartPointer< Self >	Pointer
typedef SmartPointer< const Self >	ConstPointer
typedef Superclass::MovingImageType	MovingImageType
typedef Superclass::MovingImagePointer	MovingImagePointer
typedef Superclass::FixedImageType	FixedImageType
typedef Superclass::FixedImagePointer	FixedImagePointer
typedef FixedImageType::IndexType	IndexType
typedef FixedImageType::SizeType	SizeType
typedef FixedImageType::SpacingType	SpacingType
typedef Superclass::DeformationFieldType	DeformationFieldType
typedef Superclass::DeformationFieldTypePointer	DeformationFieldTypePointer
typedef Superclass::PixelType	PixelType
typedef Superclass::RadiusType	RadiusType
typedef Superclass::NeighborhoodType	NeighborhoodType
typedef Superclass::FloatOffsetType	FloatOffsetType
typedef Superclass::TimeStepType	TimeStepType
typedef double	CoordRepType
typedef InterpolateImageFunction< MovingImageType, CoordRepType >	InterpolatorType
typedef InterpolatorType::Pointer	InterpolatorPointer
typedef InterpolatorType::PointType	PointType
typedef LinearInterpolateImageFunction< MovingImageType, CoordRepType >	DefaultInterpolatorType
typedef CovariantVector< double, itkGetStaticConstMacro(ImageDimension)	CovariantVectorType )
typedef CentralDifferenceImageFunction< FixedImageType >	GradientCalculatorType
typedef GradientCalculatorType::Pointer	GradientCalculatorPointer
Public Member Functions
virtual const char *	GetNameOfClass () const
	itkStaticConstMacro (ImageDimension, unsigned int, Superclass::ImageDimension)
void	SetMovingImageInterpolator (InterpolatorType *ptr)
InterpolatorType *	GetMovingImageInterpolator (void)
virtual TimeStepType	ComputeGlobalTimeStep (void *) const
virtual void	ReleaseGlobalDataPointer (void *GlobalData) const
virtual void	InitializeIteration ()
virtual PixelType	ComputeUpdate (const NeighborhoodType &neighborhood, void *globalData, const FloatOffsetType &offset=FloatOffsetType(0.0))
virtual double	GetMetric () const
virtual const double &	GetRMSChange () const
virtual void *	GetGlobalDataPointer () const
virtual void	SetIntensityDifferenceThreshold (double)
virtual double	GetIntensityDifferenceThreshold () const
Static Public Member Functions
Pointer	New ()
Protected Types
typedef ConstNeighborhoodIterator< FixedImageType >	FixedImageNeighborhoodIteratorType
Protected Member Functions
	SymmetricForcesDemonsRegistrationFunction ()
	~SymmetricForcesDemonsRegistrationFunction ()
void	PrintSelf (std::ostream &os, Indent indent) const

---

Detailed Description

template<class TFixedImage, class TMovingImage, class TDeformationField>
class itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >

This class encapsulate the PDE which drives the demons registration algorithm (formula (5) in J.-P. Thirions's paper "Fast Non-Rigid Matching of 3D MEdical Images", May 1995). It is used by SymmetricForcesDemonsRegistrationFilter to compute the output deformation field which will map a moving image onto a a fixed image.

This class was contributed by Corinne Mattmann, ETH Zurich, Switzerland. based on a variation of the DemonsRegistrationFunction. The basic modification is to use equation (5) from Thirion's paper along with the modification for avoiding large deformations when gradients have small values.

Non-integer moving image values are obtained by using interpolation. The default interpolator is of type LinearInterpolateImageFunction. The user may set other interpolators via method SetMovingImageInterpolator. Note that the input interpolator must derive from baseclass InterpolateImageFunction.

This class is templated over the fixed image type, moving image type, and the deformation field type.

Warning:

This filter assumes that the fixed image type, moving image type and deformation field type all have the same number of dimensions.

See also:

SymmetricForcesDemonsRegistrationFilter

DemonsRegistrationFilter

DemonsRegistrationFunction

Definition at line 61 of file itkSymmetricForcesDemonsRegistrationFunction.h.

---

Member Typedef Documentation

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef SmartPointer<const Self> itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::ConstPointer

Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >. Definition at line 72 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef double itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::CoordRepType

Interpolator type. Definition at line 108 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef CovariantVector<double,itkGetStaticConstMacro(ImageDimension) itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::CovariantVectorType)

Covariant vector type. Definition at line 116 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef LinearInterpolateImageFunction<MovingImageType,CoordRepType> itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::DefaultInterpolatorType

Definition at line 113 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::DeformationFieldType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::DeformationFieldType

Deformation field type. Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >. Definition at line 93 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::DeformationFieldTypePointer itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::DeformationFieldTypePointer

Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >. Definition at line 95 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef ConstNeighborhoodIterator<FixedImageType> itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::FixedImageNeighborhoodIteratorType [protected]

FixedImage image neighborhood iterator type. Definition at line 182 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::FixedImagePointer itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::FixedImagePointer

Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >. Definition at line 87 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::FixedImageType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::FixedImageType

FixedImage image type. Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >. Definition at line 86 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::FloatOffsetType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::FloatOffsetType

A floating point offset from an image grid location. Used for interpolation among grid values in a neighborhood. Reimplemented from itk::FiniteDifferenceFunction< TDeformationField >. Definition at line 104 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef GradientCalculatorType::Pointer itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::GradientCalculatorPointer

Definition at line 120 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef CentralDifferenceImageFunction<FixedImageType> itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::GradientCalculatorType

Gradient calculator type. Definition at line 119 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef FixedImageType::IndexType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::IndexType

Definition at line 88 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef InterpolatorType::Pointer itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::InterpolatorPointer

Definition at line 110 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef InterpolateImageFunction<MovingImageType,CoordRepType> itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::InterpolatorType

Definition at line 109 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::MovingImagePointer itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::MovingImagePointer

Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >. Definition at line 83 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::MovingImageType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::MovingImageType

MovingImage image type. Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >. Definition at line 82 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::NeighborhoodType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::NeighborhoodType

The type of data structure that is passed to this function object to evaluate at a pixel that does not lie on a data set boundary. Reimplemented from itk::FiniteDifferenceFunction< TDeformationField >. Definition at line 103 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::PixelType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::PixelType

Inherit some enums from the superclass. Reimplemented from itk::FiniteDifferenceFunction< TDeformationField >. Definition at line 101 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef SmartPointer<Self> itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::Pointer

Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >. Definition at line 71 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef InterpolatorType::PointType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::PointType

Definition at line 111 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::RadiusType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::RadiusType

Neighborhood radius type Reimplemented from itk::FiniteDifferenceFunction< TDeformationField >. Definition at line 102 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef SymmetricForcesDemonsRegistrationFunction itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::Self

Standard class typedefs. Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >. Definition at line 68 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef FixedImageType::SizeType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::SizeType

Definition at line 89 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef FixedImageType::SpacingType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::SpacingType

Definition at line 90 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField > itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::Superclass

Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >. Definition at line 70 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> typedef Superclass::TimeStepType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::TimeStepType

Define the TimeStepType to always be double. Reimplemented from itk::FiniteDifferenceFunction< TDeformationField >. Definition at line 105 of file itkSymmetricForcesDemonsRegistrationFunction.h.

---

Constructor & Destructor Documentation

template<class TFixedImage, class TMovingImage, class TDeformationField> itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::SymmetricForcesDemonsRegistrationFunction (   )  [protected]

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

Definition at line 178 of file itkSymmetricForcesDemonsRegistrationFunction.h.

---

Member Function Documentation

template<class TFixedImage, class TMovingImage, class TDeformationField> virtual TimeStepType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::ComputeGlobalTimeStep (  void *   )  const [inline, virtual]

This class uses a constant timestep of 1. Implements itk::FiniteDifferenceFunction< TDeformationField >. Definition at line 131 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> virtual PixelType itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::ComputeUpdate (  const NeighborhoodType &  neighborhood, void *  globalData, const FloatOffsetType &  offset = FloatOffsetType(0.0) )  [virtual]

This method is called by a finite difference solver image filter at each pixel that does not lie on a data set boundary Implements itk::FiniteDifferenceFunction< TDeformationField >.

template<class TFixedImage, class TMovingImage, class TDeformationField> virtual void* itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::GetGlobalDataPointer (   )  const [inline, virtual]

Return a pointer to a global data structure that is passed to this object from the solver at each calculation. Implements itk::FiniteDifferenceFunction< TDeformationField >. Definition at line 136 of file itkSymmetricForcesDemonsRegistrationFunction.h. References itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::GlobalDataStruct::m_NumberOfPixelsProcessed, itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::GlobalDataStruct::m_SumOfSquaredChange, and itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::GlobalDataStruct::m_SumOfSquaredDifference.

template<class TFixedImage, class TMovingImage, class TDeformationField> virtual double itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::GetIntensityDifferenceThreshold (   )  const [virtual]

Set/Get the threshold below which the absolute difference of intensity yields a match. When the intensities match between a moving and fixed image pixel, the update vector (for that iteration) will be the zero vector. Default is 0.001.

template<class TFixedImage, class TMovingImage, class TDeformationField> virtual double itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::GetMetric (   )  const [inline, virtual]

Get the metric value. The metric value is the mean square difference in intensity between the fixed image and transforming moving image computed over the the overlapping region between the two images. Definition at line 161 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> InterpolatorType* itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::GetMovingImageInterpolator (  void   )  [inline]

Get the moving image interpolator. Definition at line 127 of file itkSymmetricForcesDemonsRegistrationFunction.h.

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

Run-time type information (and related methods). Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >.

template<class TFixedImage, class TMovingImage, class TDeformationField> virtual const double& itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::GetRMSChange (   )  const [inline, virtual]

Get the rms change in deformation field. Definition at line 165 of file itkSymmetricForcesDemonsRegistrationFunction.h.

template<class TFixedImage, class TMovingImage, class TDeformationField> virtual void itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::InitializeIteration (   )  [virtual]

Set the object's state before each iteration. Reimplemented from itk::FiniteDifferenceFunction< TDeformationField >.

template<class TFixedImage, class TMovingImage, class TDeformationField> itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::itkStaticConstMacro (  ImageDimension  , unsigned  int, Superclass::ImageDimension  )

Inherit some enums from the superclass.

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

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

template<class TFixedImage, class TMovingImage, class TDeformationField> void itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::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::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >.

template<class TFixedImage, class TMovingImage, class TDeformationField> virtual void itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::ReleaseGlobalDataPointer (  void *  GlobalData  )  const [virtual]

Release memory for global data structure. Implements itk::FiniteDifferenceFunction< TDeformationField >.

template<class TFixedImage, class TMovingImage, class TDeformationField> virtual void itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::SetIntensityDifferenceThreshold (  double   )  [virtual]

Set/Get the threshold below which the absolute difference of intensity yields a match. When the intensities match between a moving and fixed image pixel, the update vector (for that iteration) will be the zero vector. Default is 0.001.

template<class TFixedImage, class TMovingImage, class TDeformationField> void itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDeformationField >::SetMovingImageInterpolator (  InterpolatorType *  ptr  )  [inline]

Set the moving image interpolator. Definition at line 123 of file itkSymmetricForcesDemonsRegistrationFunction.h.

---

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

• itkSymmetricForcesDemonsRegistrationFunction.h

---