ITK
6.0.0
Insight Toolkit
|
#include <itkObjectToObjectMetric.h>
Computes similarity between regions of two objects.
This class is templated over the dimensionality of the two input objects. This is the abstract templated base class for a hierarchy of similarity metrics that may, in derived classes, operate on meshes, images, etc. This class computes a value that measures the similarity between the two objects.
Derived classes must provide implementations for: GetValue GetDerivative GetValueAndDerivative SupportsArbitraryVirtualDomainSamples
Similarity is evaluated using fixed and moving transforms. Both transforms are initialized to an IdentityTransform, and can be set by the user using SetFixedTransform() and SetMovingTransform().
Virtual Domain
This class uses a virtual reference space. This space defines the resolution at which the evaluation is performed, as well as the physical coordinate system. This is useful for unbiased registration. The virtual domain is stored in the m_VirtualDomain member, but this is subject to change so the convenience methods GetVirtualSpacing(), GetVirtualDirection() and GetVirtualOrigin() should be used whenever possible to retrieve virtual domain information. The region over which metric evaluation is performed is taken from the virtual image buffered region.
The user can define a virtual domain by calling either SetVirtualDomain
or SetVirtualDomainFromImage
. See these methods for details. Derived classes may automatically assign a virtual domain if the user has not assigned one by initialization time.
If the virtual domain is left undefined by the user and by derived classes, then unit or zero values are returned for GetVirtualSpacing(), GetVirtualDirection() and GetVirtualOrigin(), as appropriate. The virtual region is left undefined and an attempt to retrieve it via GetVirtualRegion() will generate an exception. The m_VirtualImage member will be nullptr.
During evaluation, derived classes should verify that points are within the virtual domain and thus valid, as appropriate for the needs of the metric. When points are deemed invalid the number of valid points returned by GetNumberOfValidPoints() should reflect this.
Definition at line 92 of file itkObjectToObjectMetric.h.
Static Public Attributes | |
static constexpr DimensionType | FixedDimension = TFixedDimension |
static constexpr DimensionType | MovingDimension = TMovingDimension |
static constexpr DimensionType | VirtualDimension = TVirtualImage::ImageDimension |
Protected Attributes | |
FixedTransformPointer | m_FixedTransform {} |
MovingTransformPointer | m_MovingTransform {} |
SizeValueType | m_NumberOfValidPoints { 0 } |
bool | m_UserHasSetVirtualDomain {} |
VirtualImagePointer | m_VirtualImage {} |
Protected Attributes inherited from itk::ObjectToObjectMetricBaseTemplate< TParametersValueType > | |
ObjectConstPointer | m_FixedObject |
GradientSourceEnum | m_GradientSource |
ObjectConstPointer | m_MovingObject |
MeasureType | m_Value |
Protected Attributes inherited from itk::LightObject | |
std::atomic< int > | m_ReferenceCount {} |
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 val) |
Static Public Member Functions inherited from itk::LightObject | |
static void | BreakOnError () |
static Pointer | New () |
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::ConstPointer = SmartPointer<const Self> |
Definition at line 101 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::CoordinateRepresentationType = TParametersValueType |
Type used for representing object components
Definition at line 107 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::DimensionType = SizeValueType |
Dimension type
Definition at line 129 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::FixedInputPointType = typename FixedTransformType::InputPointType |
Definition at line 159 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::FixedOutputPointType = typename FixedTransformType::OutputPointType |
Definition at line 160 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::FixedTransformJacobianType = typename FixedTransformType::JacobianType |
Definition at line 170 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::FixedTransformParametersType = typename FixedTransformType::ParametersType |
Definition at line 161 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::FixedTransformPointer = typename FixedTransformType::Pointer |
Definition at line 158 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::FixedTransformType = Transform<TParametersValueType, TVirtualImage::ImageDimension, TFixedDimension> |
Definition at line 156 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::InternalComputationValueType = TParametersValueType |
Type for internal computations
Definition at line 110 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::JacobianType = typename FixedTransformType::JacobianType |
Jacobian type. This is the same for all transforms
Definition at line 169 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::MetricCategoryType = typename Superclass::MetricCategoryEnum |
Definition at line 318 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::MovingDisplacementFieldTransformType = DisplacementFieldTransform<CoordinateRepresentationType, Self::MovingDimension> |
DisplacementFieldTransform types for working with local-support transforms
Definition at line 175 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::MovingInputPointType = typename MovingTransformType::InputPointType |
Definition at line 164 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::MovingOutputPointType = typename MovingTransformType::OutputPointType |
Definition at line 165 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::MovingTransformJacobianType = typename MovingTransformType::JacobianType |
Definition at line 171 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::MovingTransformParametersType = typename MovingTransformType::ParametersType |
Definition at line 166 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::MovingTransformPointer = typename MovingTransformType::Pointer |
Definition at line 163 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::MovingTransformType = Transform<TParametersValueType, TVirtualImage::ImageDimension, TMovingDimension> |
Type of the Transform Base classes
Definition at line 155 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::ObjectType = typename Superclass::Object |
Type of object.
Definition at line 116 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::Pointer = SmartPointer<Self> |
Definition at line 100 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::Self = ObjectToObjectMetric |
Standard class type aliases.
Definition at line 98 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::Superclass = ObjectToObjectMetricBaseTemplate<TParametersValueType> |
Definition at line 99 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualDirectionType = typename VirtualImageType::DirectionType |
Definition at line 146 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualImageConstPointer = typename VirtualImageType::ConstPointer |
Definition at line 139 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualImagePointer = typename VirtualImageType::Pointer |
Definition at line 138 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualImageType = TVirtualImage |
Types for the virtual domain
Definition at line 137 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualIndexType = typename VirtualImageType::IndexType |
Definition at line 148 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualOriginType = typename VirtualImageType::PointType |
Definition at line 144 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualPixelType = typename VirtualImageType::PixelType |
Definition at line 140 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualPointSetPointer = typename VirtualPointSetType::Pointer |
Definition at line 152 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualPointSetType = PointSet<VirtualPixelType, Self::VirtualDimension> |
Point set in the virtual domain
Definition at line 151 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualPointType = typename VirtualImageType::PointType |
Definition at line 145 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualRadiusType = typename VirtualImageType::SizeType |
Definition at line 147 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualRegionType = typename VirtualImageType::RegionType |
Definition at line 141 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualSizeType = typename VirtualRegionType::SizeType |
Definition at line 142 of file itkObjectToObjectMetric.h.
using itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::VirtualSpacingType = typename VirtualImageType::SpacingType |
Definition at line 143 of file itkObjectToObjectMetric.h.
|
protected |
|
overrideprotecteddefault |
OffsetValueType itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::ComputeParameterOffsetFromVirtualIndex | ( | const VirtualIndexType & | index, |
const NumberOfParametersType & | numberOfLocalParameters | ||
) | const |
Computes an offset for accessing parameter data from a virtual domain index. Relevant for metrics with local-support transforms, to access parameter or derivative memory that is stored linearly in a 1D array. The result is the offset (1D array index) to the first of N parameters corresponding to the given virtual index, where N is the number of local parameters.
index | the virtual index to convert |
numberOfLocalParameters | corresponding to the transform |
OffsetValueType itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::ComputeParameterOffsetFromVirtualPoint | ( | const VirtualPointType & | point, |
const NumberOfParametersType & | numberOfLocalParameters | ||
) | const |
Computes an offset for accessing parameter data from a virtual domain point. Relevant for metrics with local-support transforms, to access parameter or derivative memory that is stored linearly in a 1D array. The result is the offset (1D array index) to the first of N parameters corresponding to the given virtual index, where N is the number of local parameters.
point | the virtual point to convert |
numberOfLocalParameters | corresponding to the transform |
|
inlineoverridevirtual |
Get metric category
Reimplemented from itk::ObjectToObjectMetricBaseTemplate< TParametersValueType >.
Reimplemented in itk::PointSetToPointSetMetricWithIndexv4< TPointSet, TPointSet, TInternalComputationValueType >.
Definition at line 322 of file itkObjectToObjectMetric.h.
|
virtual |
Get a pointer to the fixed transform.
|
virtual |
Get a pointer to the moving transform.
|
virtual |
|
protected |
If the moving transform is a DisplacementFieldTransform, return it. If the moving transform is a CompositeTransform, the routine will check if the first (last to be added) transform is a DisplacementFieldTransform, and if so return it. Otherwise, return nullptr.
|
overridevirtual |
|
overridevirtual |
Methods for working with the metric's 'active' transform, e.g. the transform being optimized in the case of registration. Some of these are used in non-metric classes, e.g. optimizers.
Implements itk::ObjectToObjectMetricBaseTemplate< TParametersValueType >.
|
overridevirtual |
Methods for working with the metric's 'active' transform, e.g. the transform being optimized in the case of registration. Some of these are used in non-metric classes, e.g. optimizers.
Implements itk::ObjectToObjectMetricBaseTemplate< TParametersValueType >.
|
virtual |
Get the number of valid points after a call to evaluate the metric.
|
overridevirtual |
Get a const reference to the active transform's parameters
Implements itk::ObjectToObjectMetricBaseTemplate< TParametersValueType >.
const MovingTransformType* itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::GetTransform | ( | ) |
Get the moving transform using a backwards-compatible name
VirtualDirectionType itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::GetVirtualDirection | ( | ) | const |
Accessor for virtual domain direction. Returns unit direction if a virtual domain is undefined.
|
virtual |
Return a timestamp relating to the virtual domain. This returns the greater of the metric timestamp and the virtual domain image timestamp. This allows us to capture if the virtual domain image is changed by the user after being assigned to the metric.
VirtualOriginType itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::GetVirtualOrigin | ( | ) | const |
Accessor for virtual domain origin. Returns zero origin if a virtual domain is undefined.
const VirtualRegionType& itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::GetVirtualRegion | ( | ) | const |
Return the virtual domain region, which is retrieved from the m_VirtualImage buffered region.
VirtualSpacingType itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::GetVirtualSpacing | ( | ) | const |
Accessors for the virtual domain spacing. Returns unit spacing if a virtual domain is undefined.
|
overridevirtual |
Return whether the metric's active transform has local support, e.g. whether it is dense/high-dimensional.
Implements itk::ObjectToObjectMetricBaseTemplate< TParametersValueType >.
|
overridevirtual |
Initialize the Metric by making sure that all the components are present and plugged together correctly, and initializing internal variables as required. This is for one-time initialization, e.g. before starting an optimization process.
Implements itk::ObjectToObjectMetricBaseTemplate< TParametersValueType >.
Reimplemented in itk::PointSetToPointSetMetricWithIndexv4< TPointSet, TPointSet, TInternalComputationValueType >.
bool itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::IsInsideVirtualDomain | ( | const VirtualIndexType & | index | ) | const |
Determine if a point is within the virtual domain.
bool itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::IsInsideVirtualDomain | ( | const VirtualPointType & | point | ) | const |
Determine if a point is within the virtual domain.
|
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::Object.
Reimplemented in itk::PointSetToPointSetMetricWithIndexv4< TPointSet, TPointSet, TInternalComputationValueType >.
|
virtual |
Connect the fixed transform.
Reimplemented in itk::ObjectToObjectMultiMetricv4< TFixedDimension, TMovingDimension, TVirtualImage, TInternalComputationValueType >.
|
virtual |
Connect the moving transform.
Reimplemented in itk::ObjectToObjectMultiMetricv4< TFixedDimension, TMovingDimension, TVirtualImage, TInternalComputationValueType >.
|
overridevirtual |
Set the active transform's parameters by value
Implements itk::ObjectToObjectMetricBaseTemplate< TParametersValueType >.
void itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::SetTransform | ( | MovingTransformType * | transform | ) |
Connect the moving transform using a backwards-compatible name. This assigns the input transform to the moving transform.
void itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::SetVirtualDomain | ( | const VirtualSpacingType & | spacing, |
const VirtualOriginType & | origin, | ||
const VirtualDirectionType & | direction, | ||
const VirtualRegionType & | region | ||
) |
Define the virtual reference space. This space defines the resolution at which the registration is performed as well as the physical coordinate system. Useful for unbiased registration. This method will allocate m_VirtualImage
with the passed information, with the pixel buffer left unallocated. Metric evaluation will be performed within the constraints of the virtual domain depending on implementation in derived classes. A default domain is created during initialization in derived classes according to their need.
spacing | spacing |
origin | origin |
direction | direction |
region | region is used to set all image regions. |
void itk::ObjectToObjectMetric< TFixedDimension, TMovingDimension, TVirtualImage, TParametersValueType >::SetVirtualDomainFromImage | ( | const VirtualImageType * | virtualImage | ) |
Use a virtual domain image to define the virtual reference space.
|
pure virtual |
Returns a flag. True if arbitrary virtual domain points will always correspond to data points. False if not. For example, point-set metrics return false because only some virtual domain points will correspond to points within the point sets.
Implemented in itk::ImageToImageMetricv4< TFixedImage, TMovingImage, TVirtualImage, TInternalComputationValueType, TMetricTraits >, itk::PointSetToPointSetMetricWithIndexv4< TFixedPointSet, TMovingPointSet, TInternalComputationValueType >, itk::PointSetToPointSetMetricWithIndexv4< TPointSet, TPointSet, TInternalComputationValueType >, and itk::ObjectToObjectMultiMetricv4< TFixedDimension, TMovingDimension, TVirtualImage, TInternalComputationValueType >.
|
protected |
|
protected |
|
overridevirtual |
Update the parameters of the metric's active transform. Typically this call is passed through directly to the transform. factor
is a scalar multiplier for each value in update, and defaults to 1.0 . derivative
must be the proper size, as retrieved from GetNumberOfParameters.
Implements itk::ObjectToObjectMetricBaseTemplate< TParametersValueType >.
|
protectedvirtual |
Verify that virtual domain and displacement field are the same size and in the same physical space.
|
protected |
Check that the number of valid points is above a default minimum (zero). If not, then return false, and assign to 'value' a value indicating insufficient valid points were found during evaluation, and set the derivative to zero. A warning is also output. This functionality is provided as a separate method so derived classes can use it without hardcoding the details.
|
staticconstexpr |
Object dimension accessors
Definition at line 132 of file itkObjectToObjectMetric.h.
|
protected |
Transforms
Definition at line 361 of file itkObjectToObjectMetric.h.
|
protected |
Definition at line 362 of file itkObjectToObjectMetric.h.
|
mutableprotected |
Store the number of points used during most recent value and derivative calculation.
Definition at line 373 of file itkObjectToObjectMetric.h.
|
protected |
Flag that is set when user provides a virtual domain, either via SetVirtualDomain() or SetVirtualDomainFromImage().
Definition at line 368 of file itkObjectToObjectMetric.h.
|
protected |
Definition at line 364 of file itkObjectToObjectMetric.h.
|
staticconstexpr |
Definition at line 133 of file itkObjectToObjectMetric.h.
|
staticconstexpr |
Definition at line 134 of file itkObjectToObjectMetric.h.