ITK  4.9.0
Insight Segmentation and Registration Toolkit
itkMultiResolutionImageRegistrationMethod.h
Go to the documentation of this file.
1 /*=========================================================================
2  *
3  * Copyright Insight Software Consortium
4  *
5  * Licensed under the Apache License, Version 2.0 (the "License");
6  * you may not use this file except in compliance with the License.
7  * You may obtain a copy of the License at
8  *
9  * http://www.apache.org/licenses/LICENSE-2.0.txt
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  *
17  *=========================================================================*/
18 #ifndef itkMultiResolutionImageRegistrationMethod_h
19 #define itkMultiResolutionImageRegistrationMethod_h
20 
21 #include "itkProcessObject.h"
22 #include "itkImageToImageMetric.h"
25 #include "itkNumericTraits.h"
26 #include "itkDataObjectDecorator.h"
27 
28 namespace itk
29 {
71 template< typename TFixedImage, typename TMovingImage >
73 {
74 public:
80 
82  itkNewMacro(Self);
83 
86 
88  typedef TFixedImage FixedImageType;
89  typedef typename FixedImageType::ConstPointer FixedImageConstPointer;
90  typedef typename FixedImageType::RegionType FixedImageRegionType;
91 
93  typedef TMovingImage MovingImageType;
94  typedef typename MovingImageType::ConstPointer MovingImageConstPointer;
95 
99 
103 
109 
113 
116 
120 
123 
127 
131 
134 
136  void StopRegistration();
137 
139  itkSetConstObjectMacro(FixedImage, FixedImageType);
140  itkGetConstObjectMacro(FixedImage, FixedImageType);
142 
144  itkSetConstObjectMacro(MovingImage, MovingImageType);
145  itkGetConstObjectMacro(MovingImage, MovingImageType);
147 
149  itkSetObjectMacro(Optimizer, OptimizerType);
150  itkGetModifiableObjectMacro(Optimizer, OptimizerType);
152 
154  itkSetObjectMacro(Metric, MetricType);
155  itkGetModifiableObjectMacro(Metric, MetricType);
157 
159  itkSetMacro(FixedImageRegion, FixedImageRegionType);
160  itkGetConstReferenceMacro(FixedImageRegion, FixedImageRegionType);
162 
164  itkSetObjectMacro(Transform, TransformType);
165  itkGetModifiableObjectMacro(Transform, TransformType);
167 
169  itkSetObjectMacro(Interpolator, InterpolatorType);
170  itkGetModifiableObjectMacro(Interpolator, InterpolatorType);
172 
174  itkSetObjectMacro(FixedImagePyramid, FixedImagePyramidType);
175  itkGetModifiableObjectMacro(FixedImagePyramid, FixedImagePyramidType);
177 
179  itkSetObjectMacro(MovingImagePyramid, MovingImagePyramidType);
180  itkGetModifiableObjectMacro(MovingImagePyramid, MovingImagePyramidType);
182 
184  void SetSchedules(const ScheduleType & fixedSchedule,
185  const ScheduleType & movingSchedule);
186 
187  itkGetConstMacro(FixedImagePyramidSchedule, ScheduleType);
188  itkGetConstMacro(MovingImagePyramidSchedule, ScheduleType);
189 
191  void SetNumberOfLevels(SizeValueType numberOfLevels);
192 
193  itkGetConstMacro(NumberOfLevels, SizeValueType);
194 
196  itkGetConstMacro(CurrentLevel, SizeValueType);
197 
199  itkSetMacro(InitialTransformParameters, ParametersType);
200  itkGetConstReferenceMacro(InitialTransformParameters, ParametersType);
202 
206  itkSetMacro(InitialTransformParametersOfNextLevel, ParametersType);
207  itkGetConstReferenceMacro(InitialTransformParametersOfNextLevel, ParametersType);
209 
212  itkGetConstReferenceMacro(LastTransformParameters, ParametersType);
213 
215  const TransformOutputType * GetOutput() const;
216 
222 
225  virtual ModifiedTimeType GetMTime() const ITK_OVERRIDE;
226 
227 #ifdef ITKV3_COMPATIBILITY
228  // StartRegistration is an old API from before
229  // this RegistrationMethod was a subclass of ProcessObject.
230  // Historically, one could call StartRegistration() instead of
231  // calling Update(). However, when called directly by the user, the
232  // inputs to the RegistrationMethod may not be up to date. This
233  // may cause an unexpected behavior.
234  //
235  // Since we cannot eliminate StartRegistration for backward
236  // compatibility reasons, we check whether StartRegistration was
237  // called directly or whether Update() (which in turn called
238  // StartRegistration()).
239  void StartRegistration(void) { this->Update(); }
240 #endif
241 
242 protected:
245  virtual void PrintSelf(std::ostream & os, Indent indent) const ITK_OVERRIDE;
246 
249  virtual void GenerateData() ITK_OVERRIDE;
250 
255  void Initialize()
256  throw ( ExceptionObject );
257 
259  void PreparePyramids();
260 
262  itkSetMacro(CurrentLevel, SizeValueType);
263 
264 private:
265  MultiResolutionImageRegistrationMethod(const Self &) ITK_DELETE_FUNCTION;
266  void operator=(const Self &) ITK_DELETE_FUNCTION;
267 
270 
273 
276 
279 
283 
286 
287  SizeValueType m_NumberOfLevels;
288  SizeValueType m_CurrentLevel;
289 
290  bool m_Stop;
291 
294 
297 };
298 } // end namespace itk
299 
300 #ifndef ITK_MANUAL_INSTANTIATION
301 #include "itkMultiResolutionImageRegistrationMethod.hxx"
302 #endif
303 
304 #endif
virtual void Update()
Bring this filter up-to-date.
Light weight base class for most itk classes.
ImageToImageMetric< FixedImageType, MovingImageType > MetricType
virtual DataObjectPointer MakeOutput(DataObjectPointerArraySizeType idx) override
Make a DataObject of the correct type to used as the specified output.
unsigned long ModifiedTimeType
Definition: itkIntTypes.h:164
This class is a base for the Optimization methods that optimize a single valued function.
MultiResolutionPyramidImageFilter< MovingImageType, MovingImageType > MovingImagePyramidType
The base class for all process objects (source, filters, mappers) in the Insight data processing pipe...
const TransformOutputType * GetOutput() const
Framework for creating images in a multi-resolution pyramid.
unsigned long SizeValueType
Definition: itkIntTypes.h:143
void SetSchedules(const ScheduleType &fixedSchedule, const ScheduleType &movingSchedule)
virtual void PrintSelf(std::ostream &os, Indent indent) const override
MultiResolutionPyramidImageFilter< FixedImageType, FixedImageType > FixedImagePyramidType
Transform points and vectors from an input space to an output space.
Definition: itkTransform.h:82
DataObjectPointerArray::size_type DataObjectPointerArraySizeType
Class to hold and manage different parameter types used during optimization.
Decorates any subclass of itkObject with a DataObject API.
Standard exception handling object.
Generic representation for an optimization method.
Definition: itkOptimizer.h:38
virtual ModifiedTimeType GetMTime() const override
virtual DataObjectPointer MakeOutput(DataObjectPointerArraySizeType idx)
Make a DataObject of the correct type to used as the specified output.
void SetNumberOfLevels(SizeValueType numberOfLevels)
Base class for multi-resolution image registration methods.
Base class for all image interpolaters.
Control indentation during Print() invocation.
Definition: itkIndent.h:49
ProcessObject::DataObjectPointerArraySizeType DataObjectPointerArraySizeType
Computes similarity between regions of two images.