File: itkDeformationFieldInterpolatingTransform.h

package info (click to toggle)
elastix 5.2.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 42,480 kB
  • sloc: cpp: 68,403; lisp: 4,118; python: 1,013; xml: 182; sh: 177; makefile: 33
file content (271 lines) | stat: -rw-r--r-- 9,726 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
/*=========================================================================
 *
 *  Copyright UMC Utrecht and contributors
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0.txt
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *
 *=========================================================================*/
#ifndef itkDeformationFieldInterpolatingTransform_h
#define itkDeformationFieldInterpolatingTransform_h

#include <iostream>
#include "itkAdvancedTransform.h"
#include "itkMacro.h"
#include "itkImage.h"
#include "itkVectorInterpolateImageFunction.h"
#include "itkVectorNearestNeighborInterpolateImageFunction.h"

namespace itk
{

/** \brief Transform that interpolates a given deformation field
 *
 * A simple transform that allows the user to set a deformation field.
 * TransformPoint adds the displacement to the input point.
 * This transform does not support optimizers. Its Set/GetParameters
 * is not implemented. DO NOT USE IT FOR REGISTRATION.
 * You may set your own interpolator!
 *
 * \ingroup Transforms
 */

template <class TScalarType = double,   // Data type for scalars (float or double)
          unsigned int NDimensions = 3, // Number of input dimensions
          class TComponentType = double>
// ComponentType of the deformation field
class ITK_TEMPLATE_EXPORT DeformationFieldInterpolatingTransform
  : public AdvancedTransform<TScalarType, NDimensions, NDimensions>
{
public:
  ITK_DISALLOW_COPY_AND_MOVE(DeformationFieldInterpolatingTransform);

  /** Standard class typedefs. */
  using Self = DeformationFieldInterpolatingTransform;
  using Superclass = AdvancedTransform<TScalarType, NDimensions, NDimensions>;
  using Pointer = SmartPointer<Self>;
  using ConstPointer = SmartPointer<const Self>;

  /** New macro for creation of through the object factory.*/
  itkNewMacro(Self);

  /** Run-time type information (and related methods). */
  itkTypeMacro(DeformationFieldInterpolatingTransform, AdvancedTransform);

  /** Dimension of the domain spaces. */
  itkStaticConstMacro(InputSpaceDimension, unsigned int, Superclass::InputSpaceDimension);
  itkStaticConstMacro(OutputSpaceDimension, unsigned int, Superclass::OutputSpaceDimension);

  /** Superclass typedefs */
  using typename Superclass::ScalarType;
  using typename Superclass::ParametersType;
  using typename Superclass::NumberOfParametersType;
  using typename Superclass::JacobianType;
  using typename Superclass::InputVectorType;
  using typename Superclass::OutputVectorType;
  using typename Superclass::InputCovariantVectorType;
  using typename Superclass::OutputCovariantVectorType;
  using typename Superclass::InputVnlVectorType;
  using typename Superclass::OutputVnlVectorType;
  using typename Superclass::InputPointType;
  using typename Superclass::OutputPointType;
  using typename Superclass::NonZeroJacobianIndicesType;
  using typename Superclass::SpatialHessianType;
  using typename Superclass::SpatialJacobianType;
  using typename Superclass::JacobianOfSpatialHessianType;
  using typename Superclass::JacobianOfSpatialJacobianType;

  using typename Superclass::InternalMatrixType;

  using DeformationFieldComponentType = TComponentType;
  using DeformationFieldVectorType = Vector<DeformationFieldComponentType, Self::OutputSpaceDimension>;
  using DeformationFieldType = Image<DeformationFieldVectorType, Self::InputSpaceDimension>;
  using DeformationFieldPointer = typename DeformationFieldType::Pointer;

  using DeformationFieldInterpolatorType = VectorInterpolateImageFunction<DeformationFieldType, ScalarType>;
  using DeformationFieldInterpolatorPointer = typename DeformationFieldInterpolatorType::Pointer;
  using DefaultDeformationFieldInterpolatorType =
    VectorNearestNeighborInterpolateImageFunction<DeformationFieldType, ScalarType>;

  /** Set the transformation parameters is not supported.
   * Use SetDeformationField() instead
   */
  void
  SetParameters(const ParametersType &) override
  {
    itkExceptionMacro("ERROR: SetParameters() is not implemented for DeformationFieldInterpolatingTransform.\n"
                      << "Use SetDeformationField() instead.\n"
                      << "Note that this transform is NOT suited for image registration.\n"
                      << "Just use it as an (initial) fixed transform that is not optimized.");
  }


  /** Set the fixed parameters. */
  void
  SetFixedParameters(const ParametersType &) override
  {
    // This transform has no fixed parameters.
  }


  /** Get the Fixed Parameters. */
  const ParametersType &
  GetFixedParameters() const override
  {
    // This transform has no fixed parameters.
    return this->m_FixedParameters;
  }


  /** Transform a point. This method adds a displacement to a given point,
   * returning the transformed point.
   */
  OutputPointType
  TransformPoint(const InputPointType & point) const override;

  /** These vector transforms are not implemented for this transform. */
  OutputVectorType
  TransformVector(const InputVectorType &) const override
  {
    itkExceptionMacro(
      "TransformVector(const InputVectorType &) is not implemented for DeformationFieldInterpolatingTransform");
  }


  OutputVnlVectorType
  TransformVector(const InputVnlVectorType &) const override
  {
    itkExceptionMacro(
      "TransformVector(const InputVnlVectorType &) is not implemented for DeformationFieldInterpolatingTransform");
  }


  OutputCovariantVectorType
  TransformCovariantVector(const InputCovariantVectorType &) const override
  {
    itkExceptionMacro("TransformCovariantVector(const InputCovariantVectorType &) is not implemented for "
                      "DeformationFieldInterpolatingTransform");
  }


  /** Make this an identity transform ( the deformation field is replaced
   * by a zero deformation field */
  void
  SetIdentity();

  /** Set/Get the deformation field that defines the displacements */
  virtual void
  SetDeformationField(DeformationFieldType * _arg);

  itkGetModifiableObjectMacro(DeformationField, DeformationFieldType);

  /** Set/Get the deformation field interpolator */
  virtual void
  SetDeformationFieldInterpolator(DeformationFieldInterpolatorType * _arg);

  itkGetModifiableObjectMacro(DeformationFieldInterpolator, DeformationFieldInterpolatorType);

  bool
  IsLinear() const override
  {
    return false;
  }

  /** Must be provided. */
  void
  GetJacobian(const InputPointType &, JacobianType &, NonZeroJacobianIndicesType &) const override
  {
    itkExceptionMacro("Not implemented for DeformationFieldInterpolatingTransform");
  }


  void
  GetSpatialJacobian(const InputPointType &, SpatialJacobianType &) const override
  {
    itkExceptionMacro("Not implemented for DeformationFieldInterpolatingTransform");
  }


  void
  GetSpatialHessian(const InputPointType &, SpatialHessianType &) const override
  {
    itkExceptionMacro("Not implemented for DeformationFieldInterpolatingTransform");
  }


  void
  GetJacobianOfSpatialJacobian(const InputPointType &,
                               JacobianOfSpatialJacobianType &,
                               NonZeroJacobianIndicesType &) const override
  {
    itkExceptionMacro("Not implemented for DeformationFieldInterpolatingTransform");
  }


  void
  GetJacobianOfSpatialJacobian(const InputPointType &,
                               SpatialJacobianType &,
                               JacobianOfSpatialJacobianType &,
                               NonZeroJacobianIndicesType &) const override
  {
    itkExceptionMacro("Not implemented for DeformationFieldInterpolatingTransform");
  }


  void
  GetJacobianOfSpatialHessian(const InputPointType &,
                              JacobianOfSpatialHessianType &,
                              NonZeroJacobianIndicesType &) const override
  {
    itkExceptionMacro("Not implemented for DeformationFieldInterpolatingTransform");
  }


  void
  GetJacobianOfSpatialHessian(const InputPointType &,
                              SpatialHessianType &,
                              JacobianOfSpatialHessianType &,
                              NonZeroJacobianIndicesType &) const override
  {
    itkExceptionMacro("Not implemented for DeformationFieldInterpolatingTransform");
  }


protected:
  DeformationFieldInterpolatingTransform();
  ~DeformationFieldInterpolatingTransform() override = default;

  /** Typedef which is used internally */
  using InputContinuousIndexType = typename DeformationFieldInterpolatorType::ContinuousIndexType;
  using InterpolatorOutputType = typename DeformationFieldInterpolatorType::OutputType;

  /** Print contents of an DeformationFieldInterpolatingTransform. */
  void
  PrintSelf(std::ostream & os, Indent indent) const override;

  DeformationFieldPointer             m_DeformationField{};
  DeformationFieldPointer             m_ZeroDeformationField{};
  DeformationFieldInterpolatorPointer m_DeformationFieldInterpolator{};

private:
  // Private using-declarations, to avoid `-Woverloaded-virtual` warnings from GCC (GCC 11.4).
  using Superclass::TransformCovariantVector;
  using Superclass::TransformVector;
};

} // namespace itk

#ifndef ITK_MANUAL_INSTANTIATION
#  include "itkDeformationFieldInterpolatingTransform.hxx"
#endif

#endif /* itkDeformationFieldInterpolatingTransform_h */