#include <itkPointSetToPointSetMetricv4.h>

Inheritance diagram for itk::PointSetToPointSetMetricv4< TFixedPointSet, TMovingPointSet, TInternalComputationValueType >:

Collaboration diagram for itk::PointSetToPointSetMetricv4< TFixedPointSet, TMovingPointSet, TInternalComputationValueType >:

Detailed Description

template<typename TFixedPointSet, typename TMovingPointSet, class TInternalComputationValueType = double>
class itk::PointSetToPointSetMetricv4< TFixedPointSet, TMovingPointSet, TInternalComputationValueType >

Computes similarity between two point sets.

This class is templated over the type of the two point-sets. It expects a Transform to be plugged in for each of fixed and moving point sets. The transforms default to IdenityTransform types. This particular class is the base class for a hierarchy of point-set to point-set metrics.

This class computes a value that measures the similarity between the fixed point-set and the moving point-set in the moving domain. The fixed point set is transformed into the virtual domain by computing the inverse of the fixed transform, then transformed into the moving domain using the moving transform.

Since the PointSet class permits each Point to be associated with a PixelType, there are potential applications which could make use of this additional information. For example, the derived LabeledPointSetToPointSetMetric class uses the PixelType as a LabelType for estimating total metric values and gradients from the individual label-wise point subset metric and derivatives

If a virtual domain is not defined by the user, one of two things happens: 1) If the moving transform is a global type, then the virtual domain is left undefined and every point is considered to be within the virtual domain. 2) If the moving transform is a local-support type, then the virtual domain is taken during initialization from the moving transform displacement field, and all fixed points are verified to be within the virtual domain after transformation by the inverse fixed transform. Points outside the virtual domain are not used. See GetNumberOfValidPoints() to verify how many fixed points were used during evaluation.

See ObjectToObjectMetric documentation for more discussion on the virutal domain.

Note: When used with an RegistrationParameterScalesEstimator estimator, a VirtualDomainPointSet must be defined and assigned to the estimator, for use in shift estimation. The virtual domain point set can be retrieved from the metric using the GetVirtualTransformedPointSet() method.

Definition at line 71 of file itkPointSetToPointSetMetricv4.h.

Public Types
using	ConstPointer = SmartPointer< const Self >

using	CoordRepType = typename PointType::CoordRepType

using	DerivativeType = typename Superclass::DerivativeType

using	DerivativeValueType = typename DerivativeType::ValueType

using	DimensionType = typename Superclass::DimensionType

using	DisplacementFieldTransformType = typename Superclass::MovingDisplacementFieldTransformType

using	FixedInputPointType = typename Superclass::FixedInputPointType

using	FixedOutputPointType = typename Superclass::FixedOutputPointType

using	FixedPixelType = typename TFixedPointSet::PixelType

using	FixedPointsContainer = typename TFixedPointSet::PointsContainer

using	FixedPointSetType = TFixedPointSet

using	FixedPointType = typename TFixedPointSet::PointType

using	FixedTransformedPointSetType = PointSet< FixedPixelType, Self::PointDimension >

using	FixedTransformJacobianType = typename Superclass::FixedTransformJacobianType

using	FixedTransformParametersType = typename Superclass::FixedTransformParametersType

using	FixedTransformPointer = typename Superclass::FixedTransformPointer

using	FixedTransformType = typename Superclass::FixedTransformType

using	JacobianType = typename Superclass::JacobianType

using	LocalDerivativeType = FixedArray< DerivativeValueType, Self::PointDimension >

using	MeasureType = typename Superclass::MeasureType

using	MovingInputPointType = typename Superclass::MovingInputPointType

using	MovingOutputPointType = typename Superclass::MovingOutputPointType

using	MovingPixelType = typename TMovingPointSet::PixelType

using	MovingPointsContainer = typename TMovingPointSet::PointsContainer

using	MovingPointSetType = TMovingPointSet

using	MovingPointType = typename TMovingPointSet::PointType

using	MovingTransformedPointSetType = PointSet< MovingPixelType, Self::PointDimension >

using	MovingTransformJacobianType = typename Superclass::MovingTransformJacobianType

using	MovingTransformParametersType = typename Superclass::MovingTransformParametersType

using	MovingTransformPointer = typename Superclass::MovingTransformPointer

using	MovingTransformType = typename Superclass::MovingTransformType

using	NeighborsIdentifierType = typename PointsLocatorType::NeighborsIdentifierType

using	NumberOfParametersType = typename Superclass::NumberOfParametersType

using	ObjectType = typename Superclass::ObjectType

using	ParametersType = typename Superclass::ParametersType

using	ParametersValueType = typename Superclass::ParametersValueType

using	PixelType = FixedPixelType

using	Pointer = SmartPointer< Self >

using	PointIdentifier = typename PointsContainer::ElementIdentifier

using	PointsConstIterator = typename PointsContainer::ConstIterator

using	PointsContainer = FixedPointsContainer

using	PointsLocatorType = PointsLocator< PointsContainer >

using	PointType = FixedPointType

using	Self = PointSetToPointSetMetricv4

using	Superclass = ObjectToObjectMetric< TFixedPointSet::PointDimension, TMovingPointSet::PointDimension, Image< TInternalComputationValueType, TFixedPointSet::PointDimension >, TInternalComputationValueType >

using	VirtualDirectionType = typename Superclass::VirtualDirectionType

using	VirtualImagePointer = typename Superclass::VirtualImagePointer

using	VirtualImageType = typename Superclass::VirtualImageType

using	VirtualIndexType = typename Superclass::VirtualIndexType

using	VirtualOriginType = typename Superclass::VirtualPointType

using	VirtualPixelType = typename Superclass::VirtualPixelType

using	VirtualPointSetPointer = typename Superclass::VirtualPointSetPointer

using	VirtualPointSetType = typename Superclass::VirtualPointSetType

using	VirtualPointType = typename Superclass::VirtualPointType

using	VirtualRadiusType = typename Superclass::VirtualSizeType

using	VirtualRegionType = typename Superclass::VirtualRegionType

using	VirtualSizeType = typename Superclass::VirtualSizeType

using	VirtualSpacingType = typename Superclass::VirtualSpacingType

Public Types inherited from itk::ObjectToObjectMetric< TFixedPointSet::PointDimension, TMovingPointSet::PointDimension, Image< TInternalComputationValueType, TFixedPointSet::PointDimension >, TInternalComputationValueType >
using	ConstPointer = SmartPointer< const Self >

using	CoordinateRepresentationType = TInternalComputationValueType

using	DerivativeType = typename Superclass::DerivativeType

using	DerivativeValueType = typename Superclass::DerivativeValueType

using	DimensionType = SizeValueType

using	FixedInputPointType = typename FixedTransformType::InputPointType

using	FixedOutputPointType = typename FixedTransformType::OutputPointType

using	FixedTransformJacobianType = typename FixedTransformType::JacobianType

using	FixedTransformParametersType = typename FixedTransformType::ParametersType

using	FixedTransformPointer = typename FixedTransformType::Pointer

using	FixedTransformType = Transform< TInternalComputationValueType, Image< TInternalComputationValueType, TFixedPointSet::PointDimension >::ImageDimension, TFixedDimension >

using	GradientSourceType = typename Superclass::GradientSourceType

using	InternalComputationValueType = TInternalComputationValueType

using	JacobianType = typename FixedTransformType::JacobianType

using	MeasureType = typename Superclass::MeasureType

using	MetricCategoryType = typename Superclass::MetricCategoryType

using	MovingDisplacementFieldTransformType = DisplacementFieldTransform< CoordinateRepresentationType, Self::MovingDimension >

using	MovingInputPointType = typename MovingTransformType::InputPointType

using	MovingOutputPointType = typename MovingTransformType::OutputPointType

using	MovingTransformJacobianType = typename MovingTransformType::JacobianType

using	MovingTransformParametersType = typename MovingTransformType::ParametersType

using	MovingTransformPointer = typename MovingTransformType::Pointer

using	MovingTransformType = Transform< TInternalComputationValueType, Image< TInternalComputationValueType, TFixedPointSet::PointDimension >::ImageDimension, TMovingDimension >

using	NumberOfParametersType = typename Superclass::NumberOfParametersType

using	ObjectType = typename Superclass::Object

using	ParametersType = typename Superclass::ParametersType

using	Pointer = SmartPointer< Self >

using	Self = ObjectToObjectMetric

using	Superclass = ObjectToObjectMetricBaseTemplate< TInternalComputationValueType >

using	VirtualDirectionType = typename VirtualImageType::DirectionType

using	VirtualImageConstPointer = typename VirtualImageType::ConstPointer

using	VirtualImagePointer = typename VirtualImageType::Pointer

using	VirtualImageType = Image< TInternalComputationValueType, TFixedPointSet::PointDimension >

using	VirtualIndexType = typename VirtualImageType::IndexType

using	VirtualOriginType = typename VirtualImageType::PointType

using	VirtualPixelType = typename VirtualImageType::PixelType

using	VirtualPointSetPointer = typename VirtualPointSetType::Pointer

using	VirtualPointSetType = PointSet< VirtualPixelType, Self::VirtualDimension >

using	VirtualPointType = typename VirtualImageType::PointType

using	VirtualRadiusType = typename VirtualImageType::SizeType

using	VirtualRegionType = typename VirtualImageType::RegionType

using	VirtualSizeType = typename VirtualRegionType::SizeType

using	VirtualSpacingType = typename VirtualImageType::SpacingType

Public Types inherited from itk::ObjectToObjectMetricBaseTemplate< TInternalComputationValueType >
using	ConstPointer = SmartPointer< const Self >

using	CoordinateRepresentationType = TInternalComputationValueType

using	DerivativeType = typename Superclass::DerivativeType

using	DerivativeValueType = typename DerivativeType::ValueType

enum	GradientSourceType { GRADIENT_SOURCE_FIXED =0, GRADIENT_SOURCE_MOVING, GRADIENT_SOURCE_BOTH }

using	MeasureType = typename Superclass::MeasureType

enum	MetricCategoryType { UNKNOWN_METRIC = 0, OBJECT_METRIC = 1, IMAGE_METRIC = 2, POINT_SET_METRIC = 3, MULTI_METRIC = 4 }

using	NumberOfParametersType = unsigned int

using	ObjectConstPointer = typename ObjectType::ConstPointer

using	ObjectType = Object

using	ParametersType = typename Superclass::ParametersType

using	ParametersValueType = TInternalComputationValueType

using	Pointer = SmartPointer< Self >

using	Self = ObjectToObjectMetricBaseTemplate

using	Superclass = SingleValuedCostFunctionv4Template< TInternalComputationValueType >

Public Types inherited from itk::SingleValuedCostFunctionv4Template< TInternalComputationValueType >
using	ConstPointer = SmartPointer< const Self >

using	DerivativeType = Array< TInternalComputationValueType >

using	MeasureType = TInternalComputationValueType

using	ParametersType = typename Superclass::ParametersType

using	Pointer = SmartPointer< Self >

using	Self = SingleValuedCostFunctionv4Template

using	Superclass = CostFunctionTemplate< TInternalComputationValueType >

Public Types inherited from itk::CostFunctionTemplate< TInternalComputationValueType >
using	ConstPointer = SmartPointer< const Self >

using	ParametersType = OptimizerParameters< TInternalComputationValueType >

using	ParametersValueType = TInternalComputationValueType

using	Pointer = SmartPointer< Self >

using	Self = CostFunctionTemplate

using	Superclass = Object

Public Types inherited from itk::Object
using	ConstPointer = SmartPointer< const Self >

using	Pointer = SmartPointer< Self >

using	Self = Object

using	Superclass = LightObject

Public Types inherited from itk::LightObject
using	ConstPointer = SmartPointer< const Self >

using	Pointer = SmartPointer< Self >

using	Self = LightObject

Public Member Functions
void	GetDerivative (DerivativeType &) const override

virtual const FixedTransformedPointSetType *	GetFixedTransformedPointSet () const

virtual LocalDerivativeType	GetLocalNeighborhoodDerivative (const PointType &, const PixelType &pixel) const

virtual MeasureType	GetLocalNeighborhoodValue (const PointType &, const PixelType &pixel) const =0

virtual void	GetLocalNeighborhoodValueAndDerivative (const PointType &, MeasureType &, LocalDerivativeType &, const PixelType &pixel) const =0

virtual FixedTransformedPointSetType *	GetModifiableFixedTransformedPointSet ()

virtual MovingTransformedPointSetType *	GetModifiableMovingTransformedPointSet ()

virtual const MovingTransformedPointSetType *	GetMovingTransformedPointSet () const

virtual const char *	GetNameOfClass () const

SizeValueType	GetNumberOfComponents () const

MeasureType	GetValue () const override

void	GetValueAndDerivative (MeasureType &, DerivativeType &) const override

const VirtualPointSetType *	GetVirtualTransformedPointSet () const

void	Initialize () override

bool	SupportsArbitraryVirtualDomainSamples () const override


void	SetFixedObject (const ObjectType *object) override


void	SetMovingObject (const ObjectType *object) override


virtual void	SetFixedPointSet (const FixedPointSetType *_arg)

virtual const FixedPointSetType *	GetFixedPointSet () const


virtual void	SetMovingPointSet (const MovingPointSetType *_arg)

virtual const MovingPointSetType *	GetMovingPointSet () const


virtual void	SetStoreDerivativeAsSparseFieldForLocalSupportTransforms (bool _arg)

virtual bool	GetStoreDerivativeAsSparseFieldForLocalSupportTransforms () const

virtual void	StoreDerivativeAsSparseFieldForLocalSupportTransformsOn ()

virtual void	StoreDerivativeAsSparseFieldForLocalSupportTransformsOff ()


virtual void	SetCalculateValueAndDerivativeInTangentSpace (bool _arg)

virtual bool	GetCalculateValueAndDerivativeInTangentSpace () const

virtual void	CalculateValueAndDerivativeInTangentSpaceOn ()

virtual void	CalculateValueAndDerivativeInTangentSpaceOff ()

Public Member Functions inherited from itk::ObjectToObjectMetric< TFixedPointSet::PointDimension, TMovingPointSet::PointDimension, Image< TInternalComputationValueType, TFixedPointSet::PointDimension >, TInternalComputationValueType >
OffsetValueType	ComputeParameterOffsetFromVirtualIndex (const VirtualIndexType &index, const NumberOfParametersType &numberOfLocalParameters) const

OffsetValueType	ComputeParameterOffsetFromVirtualPoint (const VirtualPointType &point, const NumberOfParametersType &numberOfLocalParameters) const

virtual const FixedTransformType *	GetFixedTransform () const

MetricCategoryType	GetMetricCategory () const override

virtual FixedTransformType *	GetModifiableFixedTransform ()

virtual MovingTransformType *	GetModifiableMovingTransform ()

virtual VirtualImageType *	GetModifiableVirtualImage ()

virtual const MovingTransformType *	GetMovingTransform () const

NumberOfParametersType	GetNumberOfLocalParameters () const override

NumberOfParametersType	GetNumberOfParameters () const override

virtual SizeValueType	GetNumberOfValidPoints () const

const ParametersType &	GetParameters () const override

const MovingTransformType *	GetTransform ()

VirtualDirectionType	GetVirtualDirection () const

virtual const TimeStamp &	GetVirtualDomainTimeStamp () const

virtual const VirtualImageType *	GetVirtualImage () const

VirtualOriginType	GetVirtualOrigin () const

const VirtualRegionType &	GetVirtualRegion () const

VirtualSpacingType	GetVirtualSpacing () const

bool	HasLocalSupport () const override

void	Initialize () override

virtual void	SetFixedTransform (FixedTransformType *_arg)

virtual void	SetMovingTransform (MovingTransformType *_arg)

void	SetParameters (ParametersType &params) override

void	SetTransform (MovingTransformType *transform)

void	SetVirtualDomain (const VirtualSpacingType &spacing, const VirtualOriginType &origin, const VirtualDirectionType &direction, const VirtualRegionType &region)

void	SetVirtualDomainFromImage (const VirtualImageType *virtualImage)

void	UpdateTransformParameters (const DerivativeType &derivative, TInternalComputationValueTypefactor) override

bool	IsInsideVirtualDomain (const VirtualPointType &point) const

bool	IsInsideVirtualDomain (const VirtualIndexType &index) const

Public Member Functions inherited from itk::ObjectToObjectMetricBaseTemplate< TInternalComputationValueType >
MeasureType	GetCurrentValue () const

virtual GradientSourceType	GetGradientSource () const

bool	GetGradientSourceIncludesFixed () const

bool	GetGradientSourceIncludesMoving () const

virtual void	SetGradientSource (GradientSourceType _arg)

virtual const ObjectType *	GetFixedObject () const

virtual const ObjectType *	GetMovingObject () const

Public Member Functions inherited from itk::SingleValuedCostFunctionv4Template< TInternalComputationValueType >
virtual void	GetValueAndDerivative (MeasureType &value, DerivativeType &derivative) const =0

Public Member Functions inherited from itk::Object
unsigned long	AddObserver (const EventObject &event, Command *)

unsigned long	AddObserver (const EventObject &event, Command *) const

LightObject::Pointer	CreateAnother () const override

virtual void	DebugOff () const

virtual void	DebugOn () const

Command *	GetCommand (unsigned long tag)

bool	GetDebug () const

MetaDataDictionary &	GetMetaDataDictionary ()

const MetaDataDictionary &	GetMetaDataDictionary () const

virtual ModifiedTimeType	GetMTime () const

virtual const TimeStamp &	GetTimeStamp () const

bool	HasObserver (const EventObject &event) const

void	InvokeEvent (const EventObject &)

void	InvokeEvent (const EventObject &) const

virtual void	Modified () const

void	Register () const override

void	RemoveAllObservers ()

void	RemoveObserver (unsigned long tag)

void	SetDebug (bool debugFlag) const

void	SetReferenceCount (int) override

void	UnRegister () const noexceptoverride

void	SetMetaDataDictionary (const MetaDataDictionary &rhs)

void	SetMetaDataDictionary (MetaDataDictionary &&rrhs)

virtual void	SetObjectName (std::string _arg)

virtual const std::string &	GetObjectName () const

Public Member Functions inherited from itk::LightObject
virtual void	Delete ()

virtual int	GetReferenceCount () const

	itkCloneMacro (Self)

void	Print (std::ostream &os, Indent indent=0) const

Static Public Attributes
static constexpr DimensionType	FixedPointDimension = Superclass::FixedDimension

static constexpr DimensionType	MovingPointDimension = Superclass::MovingDimension

static constexpr DimensionType	PointDimension = Superclass::FixedDimension

Static Public Attributes inherited from itk::ObjectToObjectMetric< TFixedPointSet::PointDimension, TMovingPointSet::PointDimension, Image< TInternalComputationValueType, TFixedPointSet::PointDimension >, TInternalComputationValueType >
static constexpr DimensionType	FixedDimension

static constexpr DimensionType	MovingDimension

static constexpr DimensionType	VirtualDimension

Protected Types
using	MetricCategoryType = typename Superclass::MetricCategoryType

Protected Member Functions
virtual SizeValueType	CalculateNumberOfValidFixedPoints () const

void	CalculateValueAndDerivative (MeasureType &value, DerivativeType &derivative, bool calculateValue) const

MetricCategoryType	GetMetricCategory () const override

virtual void	InitializeForIteration () const

virtual void	InitializePointSets () const

void	InitializePointsLocators () const

	PointSetToPointSetMetricv4 ()

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

void	StorePointDerivative (const VirtualPointType &, const DerivativeType &, DerivativeType &) const

void	TransformFixedAndCreateVirtualPointSet () const

void	TransformMovingPointSet () const

	~PointSetToPointSetMetricv4 () override=default

Protected Member Functions inherited from itk::ObjectToObjectMetric< TFixedPointSet::PointDimension, TMovingPointSet::PointDimension, Image< TInternalComputationValueType, TFixedPointSet::PointDimension >, TInternalComputationValueType >
const MovingDisplacementFieldTransformType *	GetMovingDisplacementFieldTransform () const

	ObjectToObjectMetric ()

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

bool	TransformPhysicalPointToVirtualIndex (const VirtualPointType &, VirtualIndexType &) const

void	TransformVirtualIndexToPhysicalPoint (const VirtualIndexType &, VirtualPointType &) const

virtual void	VerifyDisplacementFieldSizeAndPhysicalSpace ()

bool	VerifyNumberOfValidPoints (MeasureType &value, DerivativeType &derivative) const

	~ObjectToObjectMetric () override=default

Protected Member Functions inherited from itk::ObjectToObjectMetricBaseTemplate< TInternalComputationValueType >
	ObjectToObjectMetricBaseTemplate ()

	~ObjectToObjectMetricBaseTemplate () override=default

Protected Member Functions inherited from itk::SingleValuedCostFunctionv4Template< TInternalComputationValueType >
	SingleValuedCostFunctionv4Template ()=default

	~SingleValuedCostFunctionv4Template () override=default

Protected Member Functions inherited from itk::CostFunctionTemplate< TInternalComputationValueType >
	CostFunctionTemplate ()=default

	~CostFunctionTemplate () override=default

Protected Member Functions inherited from itk::Object
	Object ()

bool	PrintObservers (std::ostream &os, Indent indent) const

virtual void	SetTimeStamp (const TimeStamp &time)

	~Object () override

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 ()

Protected Attributes
bool	m_CalculateValueAndDerivativeInTangentSpace

FixedPointSetType::ConstPointer	m_FixedPointSet

FixedTransformedPointSetType::Pointer	m_FixedTransformedPointSet

PointsLocatorType::Pointer	m_FixedTransformedPointsLocator

MovingPointSetType::ConstPointer	m_MovingPointSet

MovingTransformedPointSetType::Pointer	m_MovingTransformedPointSet

PointsLocatorType::Pointer	m_MovingTransformedPointsLocator

bool	m_UsePointSetData

VirtualPointSetPointer	m_VirtualTransformedPointSet

Protected Attributes inherited from itk::ObjectToObjectMetric< TFixedPointSet::PointDimension, TMovingPointSet::PointDimension, Image< TInternalComputationValueType, TFixedPointSet::PointDimension >, TInternalComputationValueType >
FixedTransformPointer	m_FixedTransform

MovingTransformPointer	m_MovingTransform

SizeValueType	m_NumberOfValidPoints

bool	m_UserHasSetVirtualDomain

VirtualImagePointer	m_VirtualImage

Protected Attributes inherited from itk::ObjectToObjectMetricBaseTemplate< TInternalComputationValueType >
ObjectConstPointer	m_FixedObject

GradientSourceType	m_GradientSource

ObjectConstPointer	m_MovingObject

MeasureType	m_Value

Protected Attributes inherited from itk::LightObject
std::atomic< int >	m_ReferenceCount

Private Attributes
ModifiedTimeType	m_FixedTransformedPointSetTime

bool	m_FixedTransformPointLocatorsNeedInitialization

bool	m_HaveWarnedAboutNumberOfValidPoints

ModifiedTimeType	m_MovingTransformedPointSetTime

bool	m_MovingTransformPointLocatorsNeedInitialization

bool	m_StoreDerivativeAsSparseFieldForLocalSupportTransforms

Additional Inherited Members
Static Public Member Functions inherited from itk::Object
static bool	GetGlobalWarningDisplay ()

static void	GlobalWarningDisplayOff ()

static void	GlobalWarningDisplayOn ()

static Pointer	New ()

static void	SetGlobalWarningDisplay (bool flag)

Static Public Member Functions inherited from itk::LightObject
static void	BreakOnError ()

static Pointer	New ()