ITK
4.8.0
Insight Segmentation and Registration Toolkit
|
#include <itkESMDemonsRegistrationFunction.h>
Fast implementation of the symmetric demons registration force.
This class provides a substantially faster implementation of the symmetric demons registration force. Speed is improved by keeping a deformed copy of the moving image for gradient evaluation.
Symmetric forces simply means using the mean of the gradient of the fixed image and the gradient of the warped moving image.
Note that this class also enables the use of fixed, mapped moving and warped moving images forces by using a call to SetUseGradientType
The moving image should not be saturated. We indeed use NumericTraits<MovingPixelType>::Max() as a special value.
This implementation was taken from the Insight Journal paper: http://hdl.handle.net/1926/510
Definition at line 60 of file itkESMDemonsRegistrationFunction.h.
Classes | |
struct | GlobalDataStruct |
Static Public Member Functions | |
static Pointer | New () |
Static Public Member Functions inherited from itk::LightObject | |
static void | BreakOnError () |
static Pointer | New () |
Static Public Attributes | |
static const unsigned int | ImageDimension = Superclass::ImageDimension |
Static Public Attributes inherited from itk::FiniteDifferenceFunction< TDisplacementField > | |
static const unsigned int | ImageDimension |
Protected Types | |
typedef ConstNeighborhoodIterator < FixedImageType > | FixedImageNeighborhoodIteratorType |
Protected Member Functions | |
ESMDemonsRegistrationFunction () | |
void | PrintSelf (std::ostream &os, Indent indent) const override |
~ESMDemonsRegistrationFunction () | |
Protected Member Functions inherited from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField > | |
PDEDeformableRegistrationFunction () | |
~PDEDeformableRegistrationFunction () | |
Protected Member Functions inherited from itk::FiniteDifferenceFunction< TDisplacementField > | |
FiniteDifferenceFunction () | |
~FiniteDifferenceFunction () | |
Protected Member Functions inherited from itk::LightObject | |
virtual LightObject::Pointer | InternalClone () const |
LightObject () | |
virtual void | PrintHeader (std::ostream &os, Indent indent) const |
virtual void | PrintTrailer (std::ostream &os, Indent indent) const |
virtual | ~LightObject () |
Private Member Functions | |
ESMDemonsRegistrationFunction (const Self &) | |
void | operator= (const Self &) |
Additional Inherited Members | |
Protected Attributes inherited from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField > | |
DisplacementFieldTypePointer | m_DisplacementField |
double | m_Energy |
FixedImagePointer | m_FixedImage |
double | m_GradientStep |
MovingImagePointer | m_MovingImage |
bool | m_NormalizeGradient |
Protected Attributes inherited from itk::FiniteDifferenceFunction< TDisplacementField > | |
RadiusType | m_Radius |
PixelRealType | m_ScaleCoefficients [ImageDimension] |
Protected Attributes inherited from itk::LightObject | |
AtomicInt< int > | m_ReferenceCount |
typedef SmartPointer< const Self > itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::ConstPointer |
Definition at line 72 of file itkESMDemonsRegistrationFunction.h.
typedef double itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::CoordRepType |
Interpolator type.
Definition at line 110 of file itkESMDemonsRegistrationFunction.h.
typedef CovariantVector< double, itkGetStaticConstMacro(ImageDimension) > itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::CovariantVectorType |
Covariant vector type.
Definition at line 126 of file itkESMDemonsRegistrationFunction.h.
typedef LinearInterpolateImageFunction< MovingImageType, CoordRepType > itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::DefaultInterpolatorType |
Definition at line 116 of file itkESMDemonsRegistrationFunction.h.
typedef FixedImageType::DirectionType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::DirectionType |
Definition at line 92 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::DisplacementFieldType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::DisplacementFieldType |
Deformation field type.
Definition at line 95 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::DisplacementFieldTypePointer itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::DisplacementFieldTypePointer |
Definition at line 97 of file itkESMDemonsRegistrationFunction.h.
|
protected |
FixedImage image neighborhood iterator type.
Definition at line 226 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::FixedImagePointer itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::FixedImagePointer |
Definition at line 88 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::FixedImageType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::FixedImageType |
FixedImage image type.
Definition at line 87 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::FloatOffsetType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::FloatOffsetType |
Definition at line 106 of file itkESMDemonsRegistrationFunction.h.
typedef GradientCalculatorType::Pointer itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::GradientCalculatorPointer |
Definition at line 130 of file itkESMDemonsRegistrationFunction.h.
typedef CentralDifferenceImageFunction< FixedImageType > itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::GradientCalculatorType |
Fixed image gradient calculator type.
Definition at line 129 of file itkESMDemonsRegistrationFunction.h.
typedef FixedImageType::IndexType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::IndexType |
Definition at line 89 of file itkESMDemonsRegistrationFunction.h.
typedef InterpolatorType::Pointer itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::InterpolatorPointer |
Definition at line 113 of file itkESMDemonsRegistrationFunction.h.
typedef InterpolateImageFunction< MovingImageType, CoordRepType > itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::InterpolatorType |
Definition at line 112 of file itkESMDemonsRegistrationFunction.h.
typedef MovingImageGradientCalculatorType::Pointer itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::MovingImageGradientCalculatorPointer |
Definition at line 136 of file itkESMDemonsRegistrationFunction.h.
typedef CentralDifferenceImageFunction< MovingImageType, CoordRepType > itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::MovingImageGradientCalculatorType |
Moving image gradient (unwarped) calculator type.
Definition at line 134 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::MovingImagePointer itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::MovingImagePointer |
Definition at line 83 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::MovingImageType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::MovingImageType |
MovingImage image type.
Definition at line 79 of file itkESMDemonsRegistrationFunction.h.
typedef MovingImageType::PixelType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::MovingPixelType |
Definition at line 84 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::NeighborhoodType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::NeighborhoodType |
Definition at line 105 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::PixelType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::PixelType |
Inherit some enums from the superclass.
Definition at line 103 of file itkESMDemonsRegistrationFunction.h.
typedef SmartPointer< Self > itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::Pointer |
Definition at line 71 of file itkESMDemonsRegistrationFunction.h.
typedef InterpolatorType::PointType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::PointType |
Definition at line 114 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::RadiusType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::RadiusType |
Definition at line 104 of file itkESMDemonsRegistrationFunction.h.
typedef ESMDemonsRegistrationFunction itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::Self |
Standard class typedefs.
Definition at line 67 of file itkESMDemonsRegistrationFunction.h.
typedef FixedImageType::SizeType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::SizeType |
Definition at line 90 of file itkESMDemonsRegistrationFunction.h.
typedef FixedImageType::SpacingType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::SpacingType |
Definition at line 91 of file itkESMDemonsRegistrationFunction.h.
typedef PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField > itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::Superclass |
Definition at line 69 of file itkESMDemonsRegistrationFunction.h.
typedef Superclass::TimeStepType itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::TimeStepType |
Definition at line 107 of file itkESMDemonsRegistrationFunction.h.
typedef WarperType::Pointer itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::WarperPointer |
Definition at line 123 of file itkESMDemonsRegistrationFunction.h.
typedef WarpImageFilter< MovingImageType, MovingImageType, DisplacementFieldType > itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::WarperType |
Warper type
Definition at line 121 of file itkESMDemonsRegistrationFunction.h.
enum itk::ESMDemonsRegistrationFunction::GradientType |
Type of available image forces
Enumerator | |
---|---|
Symmetric | |
Fixed | |
WarpedMoving | |
MappedMoving |
Definition at line 206 of file itkESMDemonsRegistrationFunction.h.
|
protected |
|
inlineprotected |
Definition at line 222 of file itkESMDemonsRegistrationFunction.h.
|
private |
|
inlineoverridevirtual |
This class uses a constant timestep of 1.
Implements itk::FiniteDifferenceFunction< TDisplacementField >.
Definition at line 147 of file itkESMDemonsRegistrationFunction.h.
References itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::m_TimeStep.
|
overridevirtual |
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< TDisplacementField >.
|
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::LightObject.
|
inlineoverridevirtual |
Return a pointer to a global data structure that is passed to this object from the solver at each calculation.
Implements itk::FiniteDifferenceFunction< TDisplacementField >.
Definition at line 152 of file itkESMDemonsRegistrationFunction.h.
References itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::GlobalDataStruct::m_NumberOfPixelsProcessed, itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::GlobalDataStruct::m_SumOfSquaredChange, and itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::GlobalDataStruct::m_SumOfSquaredDifference.
|
virtual |
|
inlinevirtual |
Definition at line 200 of file itkESMDemonsRegistrationFunction.h.
|
inlinevirtual |
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 177 of file itkESMDemonsRegistrationFunction.h.
References itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::m_Metric.
|
inline |
Get the moving image interpolator.
Definition at line 143 of file itkESMDemonsRegistrationFunction.h.
|
virtual |
Run-time type information (and related methods).
Reimplemented from itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >.
|
inlinevirtual |
Get the rms change in deformation field.
Definition at line 181 of file itkESMDemonsRegistrationFunction.h.
References itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::m_RMSChange.
|
inlinevirtual |
Set/Get the type of used image forces
Definition at line 216 of file itkESMDemonsRegistrationFunction.h.
References itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::m_UseGradientType.
|
overridevirtual |
Set the object's state before each iteration.
Reimplemented from itk::FiniteDifferenceFunction< TDisplacementField >.
|
static |
Method for creation through the object factory.
|
private |
|
overrideprotectedvirtual |
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, TDisplacementField >.
|
overridevirtual |
Release memory for global data structure.
Implements itk::FiniteDifferenceFunction< TDisplacementField >.
|
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.
|
inlinevirtual |
Set/Get the maximum update step length. In Thirion this is 0.5. Setting it to 0 implies no restriction (beware of numerical instability in this case.
Definition at line 195 of file itkESMDemonsRegistrationFunction.h.
|
inline |
Set the moving image interpolator.
Definition at line 139 of file itkESMDemonsRegistrationFunction.h.
References itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::m_MovingImageInterpolator, and itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::m_MovingImageWarper.
|
inlinevirtual |
Set/Get the type of used image forces
Definition at line 214 of file itkESMDemonsRegistrationFunction.h.
References itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::m_UseGradientType.
|
static |
Inherit some enums from the superclass.
Definition at line 100 of file itkESMDemonsRegistrationFunction.h.
|
private |
Threshold below which the denominator term is considered zero.
Definition at line 266 of file itkESMDemonsRegistrationFunction.h.
|
private |
Definition at line 243 of file itkESMDemonsRegistrationFunction.h.
|
private |
Function to compute derivatives of the fixed image.
Definition at line 247 of file itkESMDemonsRegistrationFunction.h.
|
private |
Cache fixed image information.
Definition at line 241 of file itkESMDemonsRegistrationFunction.h.
|
private |
Definition at line 242 of file itkESMDemonsRegistrationFunction.h.
|
private |
Threshold below which two intensity value are assumed to match.
Definition at line 269 of file itkESMDemonsRegistrationFunction.h.
|
private |
Function to compute derivatives of the moving image (unwarped).
Definition at line 250 of file itkESMDemonsRegistrationFunction.h.
|
private |
Maximum update step length in pixels (default is 0.5 as in Thirion).
Definition at line 272 of file itkESMDemonsRegistrationFunction.h.
Referenced by itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::GetMaximumUpdateStepLength(), and itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::SetMaximumUpdateStepLength().
|
mutableprivate |
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 277 of file itkESMDemonsRegistrationFunction.h.
Referenced by itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::GetMetric().
|
mutableprivate |
Mutex lock to protect modification to metric.
Definition at line 284 of file itkESMDemonsRegistrationFunction.h.
|
private |
Function to interpolate the moving image.
Definition at line 255 of file itkESMDemonsRegistrationFunction.h.
Referenced by itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::GetMovingImageInterpolator(), and itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::SetMovingImageInterpolator().
|
private |
Filter to warp moving image for fast gradient computation.
Definition at line 258 of file itkESMDemonsRegistrationFunction.h.
Referenced by itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::SetMovingImageInterpolator().
|
private |
Definition at line 260 of file itkESMDemonsRegistrationFunction.h.
|
private |
Definition at line 244 of file itkESMDemonsRegistrationFunction.h.
|
mutableprivate |
Definition at line 279 of file itkESMDemonsRegistrationFunction.h.
|
mutableprivate |
Definition at line 280 of file itkESMDemonsRegistrationFunction.h.
Referenced by itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::GetRMSChange().
|
mutableprivate |
Definition at line 281 of file itkESMDemonsRegistrationFunction.h.
|
mutableprivate |
Definition at line 278 of file itkESMDemonsRegistrationFunction.h.
|
private |
The global timestep.
Definition at line 263 of file itkESMDemonsRegistrationFunction.h.
Referenced by itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >::ComputeGlobalTimeStep().
|
private |