#include <elxRecursiveBSplineTransform.h>
A transform based on the itkRecursiveBSplineTransform.
This transform is a B-spline transformation, commonly used for nonrigid registration.
The parameters used in this class are:
Transform: Select this transform as follows:
(Transform "RecursiveBSplineTransform")
BSplineTransformSplineOrder: choose a B-spline order 1,2, or 3.
example: (BSplineTransformSplineOrder 3)
Default value: 3 (cubic B-splines).
FinalGridSpacingInVoxels: the grid spacing of the B-spline transform for each dimension.
example: (FinalGridSpacingInVoxels 8.0 8.0 8.0)
If only one argument is given, that factor is used for each dimension. The spacing is not in millimeters, but in "voxel size units". The default is 16.0 in every dimension.
FinalGridSpacingInPhysicalUnits: the grid spacing of the B-spline transform for each dimension.
example: (FinalGridSpacingInPhysicalUnits 8.0 8.0 8.0)
If only one argument is given, that factor is used for each dimension. The spacing is specified in millimeters. If not specified, the FinalGridSpacingInVoxels is used, or the FinalGridSpacing, to compute a FinalGridSpacingInPhysicalUnits. If those are not specified, the default value for FinalGridSpacingInVoxels is used to compute a FinalGridSpacingInPhysicalUnits. If an affine transformation is provided as initial transformation, the control grid will be scaled to cover the fixed image domain in the space defined by the initial transformation.
GridSpacingSchedule: the grid spacing downsampling factors for the B-spline transform for each dimension and each resolution.
example: (GridSpacingSchedule 4.0 4.0 2.0 2.0 1.0 1.0)
Which is an example for a 2D image, using 3 resolutions.
For convenience, you may also specify only one value for each resolution:
example: (GridSpacingSchedule 4.0 2.0 1.0 )
which is equivalent to the example above.
PassiveEdgeWidth: the width of a band of control points at the border of the B-spline coefficient image that should remain passive during optimisation.
Can be specified for each resolution.
example: (PassiveEdgeWidth 0 1 2)
The default is zero for all resolutions. A value of 4 will avoid all deformations at the edge of the image. Make sure that 2*PassiveEdgeWidth < ControlPointGridSize in each dimension.
UseCyclicTransform: use the cyclic version of the B-spline transform which ensures that the B-spline polynomials wrap around in the slowest varying dimension. This is useful for dynamic imaging data in which the motion is assumed to be cyclic, for example in ECG-gated or respiratory gated CTA. For more information see the paper: Nonrigid registration of dynamic medical imaging data using nD+t B-splines and a groupwise optimization approach, C.T. Metz, S. Klein, M. Schaap, T. van Walsum and W.J. Niessen, Medical Image Analysis, in press.
The transform parameters necessary for transformix, additionally defined by this class, are:
GridSize: stores the size of the B-spline grid.
example: (GridSize 16 16 16)
GridIndex: stores the index of the B-spline grid.
example: (GridIndex 0 0 0)
GridSpacing: stores the spacing of the B-spline grid.
example: (GridSpacing 16.0 16.0 16.0)
GridOrigin: stores the origin of the B-spline grid.
example: (GridOrigin 0.0 0.0 0.0)
GridDirection: stores the direction cosines of the B-spline grid.
example: (GridDirection 1.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 0.1)
BSplineTransformSplineOrder: stores the B-spline order 1,2, or 3.
example: (BSplineTransformSplineOrder 3)
Default value: 3 (cubic B-splines).
UseCyclicTransform: use the cyclic version of the B-spline transform which ensures that the B-spline polynomials wrap around in the slowest varying dimension. This is useful for dynamic imaging data in which the motion is assumed to be cyclic, for example in ECG-gated or respiratory gated CTA. For more information see the paper: Nonrigid registration of dynamic medical imaging data using nD+t B-splines and a groupwise optimization approach, C.T. Metz, S. Klein, M. Schaap, T. van Walsum and W.J. Niessen, Medical Image Analysis, in press.
Definition at line 109 of file elxRecursiveBSplineTransform.h.
Public Member Functions | |
int | BeforeAll () override |
void | BeforeEachResolution () override |
void | BeforeRegistration () override |
elxClassNameMacro ("RecursiveBSplineTransform") | |
virtual const char * | GetClassName () const |
virtual void | IncreaseScale () |
ITK_DISALLOW_COPY_AND_MOVE (RecursiveBSplineTransform) | |
itkStaticConstMacro (SpaceDimension, unsigned int, Superclass2::FixedImageDimension) | |
void | ReadFromFile () override |
virtual void | SetOptimizerScales (const unsigned int edgeWidth) |
Public Member Functions inherited from itk::AdvancedCombinationTransform< TScalarType, NDimensions > | |
void | EvaluateJacobianWithImageGradientProduct (const InputPointType &inputPoint, const MovingImageGradientType &movingImageGradient, DerivativeType &imageJacobian, NonZeroJacobianIndicesType &nonZeroJacobianIndices) const override |
const FixedParametersType & | GetFixedParameters () const override |
bool | GetHasNonZeroSpatialHessian () const override |
bool | GetInverse (Self *inverse) const |
void | GetJacobian (const InputPointType &inputPoint, JacobianType &j, NonZeroJacobianIndicesType &nonZeroJacobianIndices) const override |
void | GetJacobianOfSpatialHessian (const InputPointType &inputPoint, JacobianOfSpatialHessianType &jsh, NonZeroJacobianIndicesType &nonZeroJacobianIndices) const override |
void | GetJacobianOfSpatialHessian (const InputPointType &inputPoint, SpatialHessianType &sh, JacobianOfSpatialHessianType &jsh, NonZeroJacobianIndicesType &nonZeroJacobianIndices) const override |
void | GetJacobianOfSpatialJacobian (const InputPointType &inputPoint, JacobianOfSpatialJacobianType &jsj, NonZeroJacobianIndicesType &nonZeroJacobianIndices) const override |
void | GetJacobianOfSpatialJacobian (const InputPointType &inputPoint, SpatialJacobianType &sj, JacobianOfSpatialJacobianType &jsj, NonZeroJacobianIndicesType &nonZeroJacobianIndices) const override |
const TransformTypePointer | GetNthTransform (SizeValueType n) const |
NumberOfParametersType | GetNumberOfNonZeroJacobianIndices () const override |
NumberOfParametersType | GetNumberOfParameters () const override |
SizeValueType | GetNumberOfTransforms () const |
const ParametersType & | GetParameters () const override |
void | GetSpatialHessian (const InputPointType &inputPoint, SpatialHessianType &sh) const override |
void | GetSpatialJacobian (const InputPointType &inputPoint, SpatialJacobianType &sj) const override |
TransformCategoryEnum | GetTransformCategory () const override |
virtual bool | GetUseAddition () const |
virtual bool | GetUseComposition () const |
bool | HasNonZeroJacobianOfSpatialHessian () const |
bool | IsLinear () const override |
ITK_DISALLOW_COPY_AND_MOVE (AdvancedCombinationTransform) | |
itkGetModifiableObjectMacro (CurrentTransform, CurrentTransformType) | |
itkGetModifiableObjectMacro (InitialTransform, InitialTransformType) | |
itkStaticConstMacro (SpaceDimension, unsigned int, NDimensions) | |
void | SetCurrentTransform (CurrentTransformType *_arg) |
void | SetFixedParameters (const FixedParametersType &fixedParam) override |
void | SetInitialTransform (InitialTransformType *_arg) |
void | SetParameters (const ParametersType ¶m) override |
void | SetParametersByValue (const ParametersType ¶m) override |
void | SetUseAddition (bool _arg) |
void | SetUseComposition (bool _arg) |
OutputCovariantVectorType | TransformCovariantVector (const InputCovariantVectorType &) const override |
OutputPointType | TransformPoint (const InputPointType &point) const override |
OutputVectorType | TransformVector (const InputVectorType &) const override |
OutputVnlVectorType | TransformVector (const InputVnlVectorType &) const override |
Public Member Functions inherited from itk::AdvancedTransform< TScalarType, 3, 3 > | |
void | ComputeJacobianWithRespectToParameters (const InputPointType &, JacobianType &) const override |
virtual bool | GetHasNonZeroJacobianOfSpatialHessian () const |
ITK_DISALLOW_COPY_AND_MOVE (AdvancedTransform) | |
itkStaticConstMacro (InputSpaceDimension, unsigned int, NInputDimensions) | |
itkStaticConstMacro (OutputSpaceDimension, unsigned int, NOutputDimensions) | |
Public Member Functions inherited from elastix::TransformBase< TElastix > | |
int | BeforeAllTransformix () |
void | ComputeAndWriteSpatialJacobianDeterminantImage () const |
void | ComputeAndWriteSpatialJacobianMatrixImage () const |
SpatialJacobianDeterminantImageType::Pointer | ComputeSpatialJacobianDeterminantImage () const |
SpatialJacobianMatrixImageType::Pointer | ComputeSpatialJacobianMatrixImage () const |
void | CreateTransformParameterMap (const ParametersType ¶m, ParameterMapType ¶meterMap, const bool includeDerivedTransformParameters=true) const |
ITKBaseType * | GetAsITKBaseType () |
const ITKBaseType * | GetAsITKBaseType () const |
ITK_DISALLOW_COPY_AND_MOVE (TransformBase) | |
itkStaticConstMacro (FixedImageDimension, unsigned int, FixedImageType::ImageDimension) | |
itkStaticConstMacro (MovingImageDimension, unsigned int, MovingImageType::ImageDimension) | |
void | ReadInitialTransformFromFile (const std::string &transformParameterFileName) |
void | SetFinalParameters () |
void | SetInitialTransform (InitialTransformType *_arg) |
void | SetReadWriteTransformParameters (const bool _arg) |
void | SetTransformParameterFileName (const std::string &filename) |
template<typename TMesh > | |
TMesh::Pointer | TransformMesh (const TMesh &mesh) const |
void | TransformPoints () const |
void | WriteToFile (std::ostream &transformationParameterInfo, const ParametersType ¶m) const |
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 | AfterEachIterationBase () |
virtual void | AfterEachResolution () |
virtual void | AfterEachResolutionBase () |
virtual void | AfterRegistration () |
virtual void | BeforeEachResolutionBase () |
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::AdvancedCombinationTransform< TScalarType, NDimensions > | |
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 () |
Private Member Functions | |
ParameterMapType | CreateDerivedTransformParameterMap () const override |
unsigned int | InitializeBSplineTransform () |
void | InitializeTransform () |
Additional Inherited Members | |
Protected Attributes inherited from itk::AdvancedTransform< TScalarType, 3, 3 > | |
bool | m_HasNonZeroJacobianOfSpatialHessian |
bool | m_HasNonZeroSpatialHessian |
Protected Attributes inherited from elastix::BaseComponentSE< TElastix > | |
Configuration::ConstPointer | m_Configuration {} |
itk::WeakPointer< TElastix > | m_Elastix {} |
RegistrationType * | m_Registration {} |
using elastix::RecursiveBSplineTransform< TElastix >::BSplineTransformBasePointer = typename BSplineTransformBaseType::Pointer |
Definition at line 146 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::BSplineTransformBaseType |
The ITK-class that provides most of the functionality, and that is set as the "CurrentTransform" in the CombinationTransform.
Definition at line 143 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::CombinationTransformType = typename Superclass2::CombinationTransformType |
Definition at line 182 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::ConstPointer = itk::SmartPointer<const Self> |
Definition at line 123 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::ContinuousIndexType = typename BSplineTransformBaseType::ContinuousIndexType |
Definition at line 172 of file elxRecursiveBSplineTransform.h.
using elastix::TransformBase< TElastix >::CoordRepType |
Elastix typedef's.
Definition at line 156 of file elxTransformBase.h.
using elastix::RecursiveBSplineTransform< TElastix >::CyclicGridScheduleComputerType = itk::CyclicGridScheduleComputer<CoordRepType, SpaceDimension> |
Definition at line 186 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::DirectionType = typename BSplineTransformBaseType::DirectionType |
Definition at line 171 of file elxRecursiveBSplineTransform.h.
using elastix::TransformBase< TElastix >::FixedImageType |
Definition at line 157 of file elxTransformBase.h.
using elastix::RecursiveBSplineTransform< TElastix >::GridScheduleComputerPointer = typename GridScheduleComputerType::Pointer |
Definition at line 187 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::GridScheduleComputerType = itk::GridScheduleComputer<CoordRepType, SpaceDimension> |
Typedef's for the GridScheduleComputer and the UpsampleBSplineParametersFilter.
Definition at line 185 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::GridScheduleType = typename GridScheduleComputerType ::VectorGridSpacingFactorType |
Definition at line 188 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::GridUpsamplerPointer = typename GridUpsamplerType::Pointer |
Definition at line 190 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::GridUpsamplerType = itk::UpsampleBSplineParametersFilter<ParametersType, ImageType> |
Definition at line 189 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::ImagePointer = typename BSplineTransformBaseType::ImagePointer |
Definition at line 165 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::ImageType = typename BSplineTransformBaseType::ImageType |
Definition at line 164 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::IndexType = typename BSplineTransformBaseType::IndexType |
Definition at line 167 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::ITKBaseType = typename Superclass2::ITKBaseType |
Definition at line 181 of file elxRecursiveBSplineTransform.h.
using elastix::TransformBase< TElastix >::MovingImageType |
Definition at line 158 of file elxTransformBase.h.
using elastix::RecursiveBSplineTransform< TElastix >::OriginType = typename BSplineTransformBaseType::OriginType |
Definition at line 170 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::ParameterIndexArrayType = typename BSplineTransformBaseType::ParameterIndexArrayType |
Definition at line 173 of file elxRecursiveBSplineTransform.h.
using elastix::TransformBase< TElastix >::ParameterMapType |
Typedef that is used in the elastix dll version.
Definition at line 199 of file elxTransformBase.h.
using elastix::RecursiveBSplineTransform< TElastix >::Pointer = itk::SmartPointer<Self> |
Definition at line 122 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::RegionType = typename BSplineTransformBaseType::RegionType |
Definition at line 166 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::Self = RecursiveBSplineTransform |
Standard ITK-stuff.
Definition at line 118 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::SizeType = typename BSplineTransformBaseType::SizeType |
Definition at line 168 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::SpacingType = typename BSplineTransformBaseType::SpacingType |
Definition at line 169 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::Superclass1 |
Definition at line 119 of file elxRecursiveBSplineTransform.h.
using elastix::RecursiveBSplineTransform< TElastix >::Superclass2 = elx::TransformBase<TElastix> |
Definition at line 121 of file elxRecursiveBSplineTransform.h.
|
protecteddefault |
The constructor.
|
overrideprotecteddefault |
The destructor.
|
overridevirtual |
Execute stuff before anything else is done:
Reimplemented from elastix::BaseComponent.
|
overridevirtual |
Execute stuff before each new pyramid resolution:
Reimplemented from elastix::BaseComponent.
|
overridevirtual |
Execute stuff before the actual registration:
Reimplemented from elastix::BaseComponent.
|
overrideprivatevirtual |
Creates a map of the parameters specific for this (derived) transform type.
Implements elastix::TransformBase< TElastix >.
elastix::RecursiveBSplineTransform< TElastix >::elxClassNameMacro | ( | "RecursiveBSplineTransform< TElastix >" | ) |
Name of this class. Use this name in the parameter file to select this specific transform.
example: (Transform "RecursiveBSplineTransform")
|
virtual |
Run-time type information (and related methods).
Reimplemented from itk::AdvancedCombinationTransform< TScalarType, NDimensions >.
|
virtual |
Method to increase the density of the B-spline grid.
|
private |
Initialize the right B-spline transform based on the spline order and periodicity.
|
private |
Method to set the initial B-spline grid and initialize the parameters (to 0).
elastix::RecursiveBSplineTransform< TElastix >::ITK_DISALLOW_COPY_AND_MOVE | ( | RecursiveBSplineTransform< TElastix > | ) |
elastix::RecursiveBSplineTransform< TElastix >::itkStaticConstMacro | ( | SpaceDimension | , |
unsigned int | , | ||
Superclass2::FixedImageDimension | ) |
Dimension of the fixed image.
|
static |
Method for creation through the object factory.
|
protectedvirtual |
Read user-specified grid spacing and call the itkGridScheduleComputer.
|
overridevirtual |
Function to read transform-parameters from a file.
Reimplemented from elastix::TransformBase< TElastix >.
|
virtual |
Set the scales of the edge B-spline coefficients to zero.
|
private |
Definition at line 251 of file elxRecursiveBSplineTransform.h.
|
private |
Private variables.
Definition at line 266 of file elxRecursiveBSplineTransform.h.
|
private |
Definition at line 272 of file elxRecursiveBSplineTransform.h.
|
private |
Definition at line 267 of file elxRecursiveBSplineTransform.h.
|
private |
Definition at line 268 of file elxRecursiveBSplineTransform.h.
|
private |
Variables to remember order and periodicity of B-spline transform.
Definition at line 271 of file elxRecursiveBSplineTransform.h.
Generated on 2024-07-17 for elastix by 1.11.0 (9b424b03c9833626cd435af22a444888fbbb192d) |