#include <elxDistancePreservingRigidityPenaltyTerm.h>

Detailed Description

template<class TElastix>
class elastix::DistancePreservingRigidityPenalty< TElastix >

A penalty term designed to preserve inter-voxel distances within rigid body regions.

For more information check the paper:
J. Kim, M. M. Matuszak, K. Saitou, and J. Balter, "Distance-preserving rigidity penalty on deformable image registration of multiple skeletal components in the neck" Medical Physics, vol. 40, no. 12, pp. 121907-1 - 121907-10, December 2013.

view online: http://www.ncbi.nlm.nih.gov/pubmed/24320518

The parameters used in this class are:

Parameters: Metric: Select this metric as follows:
(Metric "DistancePreservingRigidityPenalty")

Parameters

SegmentedImageName: The file name of the image to specify the rigidity index of voxels in the fixed image. The image has only non-integer values as follows: 1) background: 0, 2) rigid region1: 1, 3) rigid region2: 2, and so on.

example: (SegmentedImageName "BoneSegmentation.mhd")

Parameters

PenaltyGridSpacingInVoxels: defines the grid spacing with which the rigidity penalty is calculated. In this current version, the grid spacing is set to be constant over different resolutions.

In the publication above, the grid spacing was set as [4, 4, 1].

Author: Jihun Kim, University of Michigan, Ann Arbor; Martha M. Matuszak, University of Michigan, Ann Arbor; Kazuhiro Saitou, University of Michigan, Ann Arbor; James Balter, University of Michigan, Ann Arbor

Definition at line 64 of file elxDistancePreservingRigidityPenaltyTerm.h.

Inheritance diagram for elastix::DistancePreservingRigidityPenalty< TElastix >:

[legend]

Public Types
using	CoefficientImageType

using	ConstPointer = itk::SmartPointer<const Self>

using	ITKBaseType = typename Superclass2::ITKBaseType

using	Pointer = itk::SmartPointer<Self>

using	SegmentedImagePyramidPointer = typename SegmentedImagePyramidType::Pointer

using	SegmentedImagePyramidType = itk::MultiResolutionPyramidImageFilter<SegmentedImageType, SegmentedImageType>

using	SegmentedImageType

using	Self = DistancePreservingRigidityPenalty

using	Superclass1 = itk::DistancePreservingRigidityPenaltyTerm<typename MetricBase<TElastix>::FixedImageType, double>

using	Superclass2 = MetricBase<TElastix>

Public Types inherited from itk::DistancePreservingRigidityPenaltyTerm< TFixedImage, TScalarType >
using	BSplineKnotImagePointer = typename BSplineKnotImageType::Pointer

using	BSplineKnotImageRegionType = typename BSplineKnotImageType::RegionType

using	BSplineKnotImageType = Image<signed short, Self::MovingImageDimension>

using	BSplineTransformPointer = typename BSplineTransformType::Pointer

using	BSplineTransformType = AdvancedBSplineDeformableTransform<ScalarType, FixedImageDimension, 3>

using	CoefficientImagePointer = typename CoefficientImageType::Pointer

using	CoefficientImageSpacingType = typename CoefficientImageType::SpacingType

using	CoefficientImageType = typename BSplineTransformType::ImageType

using	CombinationTransformType = AdvancedCombinationTransform<ScalarType, FixedImageDimension>

using	ConstPointer = SmartPointer<const Self>

using	GridSpacingType = typename BSplineTransformType::SpacingType

using	PenaltyGridImagePointer = typename PenaltyGridImageType::Pointer

using	PenaltyGridImageRegionType = typename PenaltyGridImageType::RegionType

using	PenaltyGridImageType = Image<signed short, Self::MovingImageDimension>

using	Pointer = SmartPointer<Self>

using	SegmentedImagePointer = typename SegmentedImageType::Pointer

using	SegmentedImageRegionType = typename SegmentedImageType::RegionType

using	SegmentedImageType = Image<signed short, Self::MovingImageDimension>

using	Self = DistancePreservingRigidityPenaltyTerm

using	Superclass = TransformPenaltyTerm<TFixedImage, TScalarType>

Public Types inherited from itk::TransformPenaltyTerm< TFixedImage, TScalarType >
using	ConstPointer

using	InternalMatrixType

using	JacobianOfSpatialHessianType

using	JacobianOfSpatialJacobianType

using	Pointer

using	ScalarType

using	Self

using	SpatialHessianType

using	SpatialJacobianType

using	Superclass

using	TransformType

Public Types inherited from itk::AdvancedImageToImageMetric< TFixedImage, TFixedImage >
using	AdvancedTransformType

using	BSplineOrder1TransformPointer

using	BSplineOrder1TransformType

using	BSplineOrder2TransformPointer

using	BSplineOrder2TransformType

using	BSplineOrder3TransformPointer

using	BSplineOrder3TransformType

using	CombinationTransformType

using	ConstPointer

using	DerivativeValueType

using	FixedImageLimiterOutputType

using	FixedImageLimiterPointer

using	FixedImageLimiterType

using	FixedImageMaskConstPointer

using	FixedImageMaskPointer

using	FixedImageMaskType

using	FixedImagePixelType

using	FixedImagePointer

using	ImageSampleContainerPointer

using	ImageSampleContainerType

using	ImageSamplerPointer

using	ImageSamplerType

using	MovingImageDerivativeScalesType

using	MovingImageLimiterOutputType

using	MovingImageLimiterPointer

using	MovingImageLimiterType

using	MovingImageMaskConstPointer

using	MovingImageMaskPointer

using	MovingImageMaskType

using	MovingImagePointer

using	MovingImageRegionType

using	NumberOfParametersType

using	Pointer

using	ScalarType

using	Self

using	Superclass

using	ThreadInfoType

Public Types inherited from elastix::MetricBase< TElastix >
using	AdvancedMetricType = itk::AdvancedImageToImageMetric<FixedImageType, MovingImageType>

using	CoordinateRepresentationType = typename ITKBaseType::ParametersValueType

using	ElastixType

using	FixedImageType = typename ElastixType::FixedImageType

using	FixedPointSetType

using	FixedPointType = typename FixedImageType::PointType

using	FixedPointValueType = typename FixedPointType::ValueType

using	ImageSamplerBaseType = typename AdvancedMetricType::ImageSamplerType

using	ITKBaseType = itk::SingleValuedCostFunction

using	MeasureType = typename ITKBaseType::MeasureType

using	MovingImageDerivativeScalesType = typename AdvancedMetricType::MovingImageDerivativeScalesType

using	MovingImageType = typename ElastixType::MovingImageType

using	MovingPointSetType

using	MovingPointType = typename MovingImageType::PointType

using	MovingPointValueType = typename MovingPointType::ValueType

using	RegistrationType

using	Self = MetricBase

using	Superclass = BaseComponentSE<TElastix>

Public Types inherited from elastix::BaseComponentSE< TElastix >
using	ElastixType = TElastix

using	RegistrationType = typename ElastixType::RegistrationBaseType

using	Self = BaseComponentSE

using	Superclass = BaseComponent

Public Member Functions
void	BeforeRegistration () override

	elxClassNameMacro ("DistancePreservingRigidityPenalty")

virtual const char *	GetClassName () const

void	Initialize () override

	ITK_DISALLOW_COPY_AND_MOVE (DistancePreservingRigidityPenalty)

	itkStaticConstMacro (FixedImageDimension, unsigned int, FixedImageType::ImageDimension)

	itkStaticConstMacro (MovingImageDimension, unsigned int, MovingImageType::ImageDimension)

Public Member Functions inherited from itk::DistancePreservingRigidityPenaltyTerm< TFixedImage, TScalarType >
void	GetDerivative (const ParametersType &parameters, DerivativeType &derivative) const override

virtual unsigned int	GetNumberOfRigidGrids () const

MeasureType	GetValue (const ParametersType &parameters) const override

void	GetValueAndDerivative (const ParametersType &parameters, MeasureType &value, DerivativeType &derivative) const override

void	Initialize () override

	ITK_DISALLOW_COPY_AND_MOVE (DistancePreservingRigidityPenaltyTerm)

	itkGetModifiableObjectMacro (SampledSegmentedImage, SegmentedImageType)

	itkGetModifiableObjectMacro (SegmentedImage, SegmentedImageType)

	itkStaticConstMacro (FixedImageDimension, unsigned int, FixedImageType::ImageDimension)

	itkStaticConstMacro (ImageDimension, unsigned int, FixedImageType::ImageDimension)

	itkStaticConstMacro (MovingImageDimension, unsigned int, FixedImageType::ImageDimension)

virtual void	SetBSplineTransform (BSplineTransformType *_arg)

virtual void	SetSampledSegmentedImage (SegmentedImageType *_arg)

virtual void	SetSegmentedImage (SegmentedImageType *_arg)

Public Member Functions inherited from itk::TransformPenaltyTerm< TFixedImage, TScalarType >
	ITK_DISALLOW_COPY_AND_MOVE (TransformPenaltyTerm)

	itkStaticConstMacro (FixedImageDimension, unsigned int, FixedImageType::ImageDimension)

Public Member Functions inherited from itk::AdvancedImageToImageMetric< TFixedImage, TFixedImage >
virtual void	BeforeThreadedGetValueAndDerivative (const TransformParametersType &parameters) const

virtual const FixedImageLimiterType *	GetFixedImageLimiter ()

const FixedImageMaskType *	GetFixedImageMask () const override

virtual double	GetFixedLimitRangeRatio () const

ImageSamplerType *	GetImageSampler () const

virtual const MovingImageDerivativeScalesType &	GetMovingImageDerivativeScales ()

virtual const MovingImageLimiterType *	GetMovingImageLimiter ()

const MovingImageMaskType *	GetMovingImageMask () const override

virtual double	GetMovingLimitRangeRatio () const

virtual double	GetRequiredRatioOfValidSamples () const

virtual bool	GetScaleGradientWithRespectToMovingImageOrientation () const

const AdvancedTransformType *	GetTransform () const override

AdvancedTransformType *	GetTransform () override

virtual bool	GetUseFixedImageLimiter () const

virtual bool	GetUseImageSampler () const

virtual const bool &	GetUseMetricSingleThreaded ()

virtual bool	GetUseMovingImageDerivativeScales () const

virtual bool	GetUseMovingImageLimiter () const

virtual const bool &	GetUseMultiThread ()

void	Initialize () override

	ITK_DISALLOW_COPY_AND_MOVE (AdvancedImageToImageMetric)

	itkStaticConstMacro (FixedImageDimension, unsigned int, TFixedImage::ImageDimension)

	itkStaticConstMacro (MovingImageDimension, unsigned int, TFixedImage::ImageDimension)

virtual void	SetFixedImageLimiter (FixedImageLimiterType *_arg)

virtual void	SetFixedImageMask (const FixedImageMaskType *const arg)

virtual void	SetFixedLimitRangeRatio (double _arg)

virtual void	SetImageSampler (ImageSamplerType *_arg)

virtual void	SetMovingImageDerivativeScales (MovingImageDerivativeScalesType _arg)

virtual void	SetMovingImageLimiter (MovingImageLimiterType *_arg)

virtual void	SetMovingImageMask (const MovingImageMaskType *const arg)

virtual void	SetMovingLimitRangeRatio (double _arg)

virtual void	SetRequiredRatioOfValidSamples (double _arg)

virtual void	SetScaleGradientWithRespectToMovingImageOrientation (bool _arg)

virtual void	SetTransform (AdvancedTransformType *arg)

virtual void	SetUseMetricSingleThreaded (bool _arg)

virtual void	SetUseMovingImageDerivativeScales (bool _arg)

virtual void	SetUseMultiThread (bool _arg)

virtual void	UseMetricSingleThreadedOff ()

virtual void	UseMetricSingleThreadedOn ()

virtual void	UseMultiThreadOff ()

virtual void	UseMultiThreadOn ()

Public Member Functions inherited from elastix::MetricBase< TElastix >
void	AfterEachIterationBase () override

void	BeforeEachResolutionBase () override

virtual ImageSamplerBaseType *	GetAdvancedMetricImageSampler () const

virtual bool	GetAdvancedMetricUseImageSampler () const

ITKBaseType *	GetAsITKBaseType ()

const ITKBaseType *	GetAsITKBaseType () const

virtual MeasureType	GetCurrentExactMetricValue () const

virtual bool	GetShowExactMetricValue () const

	ITK_DISALLOW_COPY_AND_MOVE (MetricBase)

	itkStaticConstMacro (FixedImageDimension, unsigned int, FixedImageType::ImageDimension)

	itkStaticConstMacro (MovingImageDimension, unsigned int, MovingImageType::ImageDimension)

virtual void	SelectNewSamples ()

virtual void	SetAdvancedMetricImageSampler (ImageSamplerBaseType *sampler)

Public Member Functions inherited from elastix::BaseComponentSE< TElastix >
void	AddTargetCellToIterationInfo (const char *const name)

const Configuration *	GetConfiguration () const

ElastixType *	GetElastix () const

auto &	GetIterationInfoAt (const char *const name)

RegistrationType *	GetRegistration () const

	ITK_DISALLOW_COPY_AND_MOVE (BaseComponentSE)

void	RemoveTargetCellFromIterationInfo (const char *const name)

void	SetConfiguration (const Configuration *_arg)

void	SetElastix (ElastixType *_arg)

Public Member Functions inherited from elastix::BaseComponent
virtual void	AfterEachIteration ()

virtual void	AfterEachResolution ()

virtual void	AfterEachResolutionBase ()

virtual void	AfterRegistration ()

virtual void	AfterRegistrationBase ()

virtual int	BeforeAll ()

virtual int	BeforeAllBase ()

virtual void	BeforeEachResolution ()

virtual void	BeforeRegistrationBase ()

virtual const char *	elxGetClassName () const

const char *	GetComponentLabel () const

	ITK_DISALLOW_COPY_AND_MOVE (BaseComponent)

	itkTypeMacroNoParent (BaseComponent)

void	SetComponentLabel (const char *label, unsigned int idx)

Static Public Member Functions
static Pointer	New ()

Static Public Member Functions inherited from itk::DistancePreservingRigidityPenaltyTerm< TFixedImage, TScalarType >
static Pointer	New ()

Static Public Member Functions inherited from elastix::BaseComponent
template<typename TBaseComponent >
static auto	AsITKBaseType (TBaseComponent *const baseComponent) -> decltype(baseComponent->GetAsITKBaseType())

static void	InitializeElastixExecutable ()

static bool	IsElastixLibrary ()

Protected Member Functions
	DistancePreservingRigidityPenalty ()=default

	~DistancePreservingRigidityPenalty () override=default

Protected Member Functions inherited from itk::DistancePreservingRigidityPenaltyTerm< TFixedImage, TScalarType >
	DistancePreservingRigidityPenaltyTerm ()

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

	~DistancePreservingRigidityPenaltyTerm () override=default

Protected Member Functions inherited from itk::TransformPenaltyTerm< TFixedImage, TScalarType >
virtual bool	CheckForBSplineTransform2 (BSplineOrder3TransformPointer &bspline) const

	TransformPenaltyTerm ()=default

	~TransformPenaltyTerm () override=default

Protected Member Functions inherited from itk::AdvancedImageToImageMetric< TFixedImage, TFixedImage >
	AdvancedImageToImageMetric ()

virtual void	AfterThreadedGetValue (MeasureType &) const

virtual void	AfterThreadedGetValueAndDerivative (MeasureType &, DerivativeType &) const

void	CheckForAdvancedTransform ()

void	CheckForBSplineInterpolator ()

void	CheckForBSplineTransform () const

void	CheckNumberOfSamples (unsigned long wanted, unsigned long found) const

virtual bool	EvaluateMovingImageValueAndDerivative (const MovingImagePointType &mappedPoint, RealType &movingImageValue, MovingImageDerivativeType *gradient) const

bool	EvaluateTransformJacobian (const FixedImagePointType &fixedImagePoint, TransformJacobianType &jacobian, NonZeroJacobianIndicesType &nzji) const

virtual void	EvaluateTransformJacobianInnerProduct (const TransformJacobianType &jacobian, const MovingImageDerivativeType &movingImageDerivative, DerivativeType &imageJacobian) const

bool	FastEvaluateMovingImageValueAndDerivative (const MovingImagePointType &mappedPoint, RealType &movingImageValue, MovingImageDerivativeType *gradient, const ThreadIdType threadId) const

virtual void	InitializeImageSampler ()

void	InitializeLimiters ()

virtual void	InitializeThreadingParameters () const

virtual bool	IsInsideMovingMask (const MovingImagePointType &point) const

	itkAlignedTypedef (ITK_CACHE_LINE_ALIGNMENT, PaddedGetValueAndDerivativePerThreadStruct, AlignedGetValueAndDerivativePerThreadStruct)

	itkPadStruct (ITK_CACHE_LINE_ALIGNMENT, GetValueAndDerivativePerThreadStruct, PaddedGetValueAndDerivativePerThreadStruct)

void	LaunchGetValueAndDerivativeThreaderCallback () const

void	LaunchGetValueThreaderCallback () const

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

void	SetFixedImageMask (const typename Superclass::FixedImageMaskType *) final

void	SetFixedImageMask (typename Superclass::FixedImageMaskType *) final

void	SetMovingImageMask (const typename Superclass::MovingImageMaskType *) final

void	SetMovingImageMask (typename Superclass::MovingImageMaskType *) final

virtual void	SetUseFixedImageLimiter (bool _arg)

virtual void	SetUseImageSampler (bool _arg)

virtual void	SetUseMovingImageLimiter (bool _arg)

virtual void	ThreadedGetValue (ThreadIdType) const

virtual void	ThreadedGetValueAndDerivative (ThreadIdType) const

MovingImagePointType	TransformPoint (const FixedImagePointType &fixedImagePoint) const

	~AdvancedImageToImageMetric () override=default

Protected Member Functions inherited from elastix::MetricBase< TElastix >
virtual MeasureType	GetExactValue (const ParametersType &parameters)

	MetricBase ()=default

	~MetricBase () override=default

Protected Member Functions inherited from elastix::BaseComponentSE< TElastix >
	BaseComponentSE ()=default

	~BaseComponentSE () override=default

Protected Member Functions inherited from elastix::BaseComponent
	BaseComponent ()=default

virtual	~BaseComponent ()=default

Private Attributes
	elxOverrideGetSelfMacro

Additional Inherited Members
Protected Types inherited from itk::AdvancedImageToImageMetric< TFixedImage, TFixedImage >
using	BSplineInterpolatorFloatPointer

using	BSplineInterpolatorFloatType

using	BSplineInterpolatorPointer

using	BSplineInterpolatorType

using	FixedImageIndexType

using	FixedImageIndexValueType

using	FixedImagePointType

using	LinearInterpolatorPointer

using	LinearInterpolatorType

using	MovingImageContinuousIndexType

using	MovingImageDerivativeType

using	MovingImageIndexType

using	MovingImagePointType

using	NonZeroJacobianIndicesType

using	ReducedBSplineInterpolatorPointer

using	ReducedBSplineInterpolatorType

Protected Types inherited from elastix::MetricBase< TElastix >
using	ExactMetricImageSamplerPointer = typename ExactMetricImageSamplerType::Pointer

using	ExactMetricImageSamplerType = itk::ImageGridSampler<FixedImageType>

using	ExactMetricSampleGridSpacingType = typename ExactMetricImageSamplerType::SampleGridSpacingType

using	ParametersType = typename ITKBaseType::ParametersType

Static Protected Member Functions inherited from itk::AdvancedImageToImageMetric< TFixedImage, TFixedImage >
static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION	AccumulateDerivativesThreaderCallback (void *arg)

static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION	GetValueAndDerivativeThreaderCallback (void *arg)

static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION	GetValueThreaderCallback (void *arg)

Protected Attributes inherited from itk::AdvancedImageToImageMetric< TFixedImage, TFixedImage >
AdvancedTransformType::Pointer	m_AdvancedTransform

FixedImageLimiterOutputType	m_FixedImageMaxLimit

FixedImageLimiterOutputType	m_FixedImageMinLimit

FixedImagePixelType	m_FixedImageTrueMax

FixedImagePixelType	m_FixedImageTrueMin

double	m_FixedLimitRangeRatio

std::unique_ptr< AlignedGetValueAndDerivativePerThreadStruct[]>	m_GetValueAndDerivativePerThreadVariables

ThreadIdType	m_GetValueAndDerivativePerThreadVariablesSize

ImageSamplerPointer	m_ImageSampler

MovingImageLimiterOutputType	m_MovingImageMaxLimit

MovingImageLimiterOutputType	m_MovingImageMinLimit

MovingImagePixelType	m_MovingImageTrueMax

MovingImagePixelType	m_MovingImageTrueMin

double	m_MovingLimitRangeRatio

MultiThreaderParameterType	m_ThreaderMetricParameters

bool	m_TransformIsBSpline

bool	m_UseMetricSingleThreaded

bool	m_UseMultiThread

Protected Attributes inherited from elastix::MetricBase< TElastix >
MeasureType	m_CurrentExactMetricValue { 0.0 }

unsigned int	m_ExactMetricEachXNumberOfIterations { 1 }

ExactMetricSampleGridSpacingType	m_ExactMetricSampleGridSpacing

ExactMetricImageSamplerPointer	m_ExactMetricSampler { nullptr }

bool	m_ShowExactMetricValue { false }

Protected Attributes inherited from elastix::BaseComponentSE< TElastix >
Configuration::ConstPointer	m_Configuration {}

itk::WeakPointer< TElastix >	m_Elastix {}

RegistrationType *	m_Registration {}