#include <itkPointSetToPointSetRegistrationMethod.h>
Inheritance diagram for itk::PointSetToPointSetRegistrationMethod< TFixedPointSet, TMovingPointSet >:


This Class define the generic interface for a registration method.
This class is templated over the type of the PointSet and the PointSet to be registered. A generic Transform is used by this class. That allows to select at run time the particular type of transformation that is to be applied for registering the PointSets.
This method use a generic Metric in order to compare the PointSet and the PointSet. The final goal of the registration method is to find the set of parameters of the Transformation that optimizes the metric.
The registration method also support a generic optimizer that can be selected at run-time. The only restriction for the optimizer is that it should be able to operate in single-valued cost functions given that the metrics used to compare PointSet with PointSets provide a single value as output.
The terms : FixedPointSet and MovingPointSet are used in this class to indicate that the PointSet is being mapped by the transform.
This class uses the coordinate system of the Fixed PointSet as a reference and searchs for a Transform that will map points from the space of the Fixed PointSet to the space of the Moving PointSet.
For doing so, a Metric will be continously applied to compare the Fixed PointSet with the Transformed Moving PointSet. This process also requires to interpolate values from the Moving PointSet.
Definition at line 61 of file itkPointSetToPointSetRegistrationMethod.h.
Public Types | |
| typedef SmartPointer< const Self > | ConstPointer |
| typedef DataObject::Pointer | DataObjectPointer |
| typedef std::vector< DataObjectPointer > | DataObjectPointerArray |
| typedef FixedPointSetType::ConstPointer | FixedPointSetConstPointer |
| typedef TFixedPointSet | FixedPointSetType |
| typedef MetricType::Pointer | MetricPointer |
| typedef PointSetToPointSetMetric< FixedPointSetType, MovingPointSetType > | MetricType |
| typedef MovingPointSetType::ConstPointer | MovingPointSetConstPointer |
| typedef TMovingPointSet | MovingPointSetType |
| typedef MultipleValuedNonLinearOptimizer | OptimizerType |
| typedef MetricType::TransformParametersType | ParametersType |
| typedef SmartPointer< Self > | Pointer |
| typedef PointSetToPointSetRegistrationMethod | Self |
| typedef ProcessObject | Superclass |
| typedef TransformType::Pointer | TransformPointer |
| typedef MetricType::TransformType | TransformType |
Public Member Functions | |
| virtual void | AbortGenerateDataOff () |
| virtual void | AbortGenerateDataOn () |
| virtual LightObject::Pointer | CreateAnother () const |
| virtual void | DebugOff () const |
| virtual void | DebugOn () const |
| virtual void | Delete () |
| virtual void | EnlargeOutputRequestedRegion (DataObject *) |
| virtual const bool & | GetAbortGenerateData () |
| Command * | GetCommand (unsigned long tag) |
| bool | GetDebug () const |
| virtual const FixedPointSetType * | GetFixedPointSet () |
| virtual const ParametersType & | GetInitialTransformParameters () |
| DataObjectPointerArray & | GetInputs () |
| virtual const ParametersType & | GetLastTransformParameters () |
| const MetaDataDictionary & | GetMetaDataDictionary (void) const |
| MetaDataDictionary & | GetMetaDataDictionary (void) |
| virtual MetricType * | GetMetric () |
| virtual const MovingPointSetType * | GetMovingPointSet () |
| virtual unsigned long | GetMTime () const |
| MultiThreader * | GetMultiThreader () |
| virtual const char * | GetNameOfClass () const |
| std::vector< DataObjectPointer >::size_type | GetNumberOfInputs () const |
| std::vector< DataObjectPointer >::size_type | GetNumberOfOutputs () const |
| virtual const int & | GetNumberOfThreads () |
| virtual std::vector< DataObjectPointer >::size_type | GetNumberOfValidRequiredInputs () const |
| virtual OptimizerType * | GetOptimizer () |
| Return an array with all the outputs of this process object *This is useful for tracing forward in the pipeline to contruct *graphs etc *DataObjectPointerArray & | GetOutputs () |
| virtual const float & | GetProgress () |
| virtual int | GetReferenceCount () const |
| virtual const bool & | GetReleaseDataBeforeUpdateFlag () |
| virtual bool | GetReleaseDataFlag () const |
| virtual TransformType * | GetTransform () |
| bool | HasObserver (const EventObject &event) const |
| void | Initialize () throw (ExceptionObject) |
| void | InvokeEvent (const EventObject &) const |
| void | InvokeEvent (const EventObject &) |
| virtual DataObjectPointer | MakeOutput (unsigned int idx) |
| virtual void | Modified () const |
| virtual void | PrepareOutputs () |
| void | Print (std::ostream &os, Indent indent=0) const |
| virtual void | PropagateRequestedRegion (DataObject *output) |
| virtual void | Register () const |
| virtual void | ReleaseDataBeforeUpdateFlagOff () |
| virtual void | ReleaseDataBeforeUpdateFlagOn () |
| void | ReleaseDataFlagOff () |
| void | ReleaseDataFlagOn () |
| void | RemoveAllObservers () |
| void | RemoveObserver (unsigned long tag) |
| virtual void | ResetPipeline () |
| virtual void | SetAbortGenerateData (bool _arg) |
| void | SetDebug (bool debugFlag) const |
| Set Get the Fixed PointSet *virtual void | SetFixedPointSet (const FixedPointSetType *_arg) |
| Set Get the initial transformation parameters *virtual void | SetInitialTransformParameters (const ParametersType ¶m) |
| void | SetMetaDataDictionary (const MetaDataDictionary &rhs) |
| Set Get the Metric *virtual void | SetMetric (MetricType *_arg) |
| Set Get the Moving PointSet *virtual void | SetMovingPointSet (const MovingPointSetType *_arg) |
| Get Set the number of threads to create when executing *virtual void | SetNumberOfThreads (int _arg) |
| Set Get the Optimizer *virtual void | SetOptimizer (OptimizerType *_arg) |
| virtual void | SetProgress (float _arg) |
| virtual void | SetReferenceCount (int) |
| Turn on off the flags to control whether the bulk data belonging *to the outputs of this ProcessObject are released after being *used by a downstream ProcessObject Default value is off Another *options for controlling memory utilization is the *ReleaseDataBeforeUpdateFlag *virtual void | SetReleaseDataFlag (bool flag) |
| Set Get the Transfrom *virtual void | SetTransform (TransformType *_arg) |
| void | StartRegistration (void) |
| virtual void | UnRegister () const |
| Turn on off the flags to control whether the bulk data belonging *to the outputs of this ProcessObject are released reallocated *during an a user may want *to force the elements of a pipeline to release any bulk data that *is going to be regenerated anyway during an | Update () in order to *control peak memory allocation.Note that this flag is different *from the ReleaseDataFlag.ReleaseDataFlag manages the *deallocation of a ProcessObject's bulk output data once that data *has been consumed by a downstream ProcessObject.The *ReleaseDataBeforeUpdateFlag manages the deallocation/reallocation *of bulk data during a pipeline update to control peak memory *utilization.Default value is on.*/virtual void SetReleaseDataBeforeUpdateFlag(bool _arg) |
| Turn on off the flags to control whether the bulk data belonging *to the outputs of this ProcessObject are released reallocated *during an | Update ().In limited memory scenarios |
| virtual void | Update () |
| virtual void | UpdateLargestPossibleRegion () |
| virtual void | UpdateOutputData (DataObject *output) |
| virtual void | UpdateOutputInformation () |
| void | UpdateProgress (float amount) |
Static Public Member Functions | |
| static void | BreakOnError () |
| static bool | GetGlobalWarningDisplay () |
| static void | GlobalWarningDisplayOff () |
| static void | GlobalWarningDisplayOn () |
| static Pointer | New () |
| This is a global flag that controls whether any warning *or error messages are displayed *static void | SetGlobalWarningDisplay (bool flag) |
Public Attributes | |
| Allow people to add remove invoke observers(callbacks) to any ITK *object.This is an implementation of the subject/observer design *pattern.An observer is added by specifying an event to respond to *and an itk unsigned lon | AddObserver )(const EventObject &event, Command *) const |
| This is a global flag that controls whether any | debug |
Protected Member Functions | |
| virtual void | AddInput (DataObject *input) |
| virtual void | AddOutput (DataObject *output) |
| virtual void | CacheInputReleaseDataFlags () |
| virtual void | GenerateData () |
| virtual void | GenerateInputRequestedRegion () |
| virtual void | GenerateOutputInformation () |
| virtual void | GenerateOutputRequestedRegion (DataObject *output) |
| const DataObject * | GetInput (unsigned int idx) const |
| Method used internally for getting an input *DataObject * | GetInput (unsigned int idx) |
| virtual const unsigned int & | GetNumberOfRequiredInputs () |
| virtual const unsigned int & | GetNumberOfRequiredOutputs () |
| const DataObject * | GetOutput (unsigned int idx) const |
| Method used internally for getting an output *DataObject * | GetOutput (unsigned int idx) |
| PointSetToPointSetRegistrationMethod () | |
| virtual void | PopBackInput () |
| virtual void | PopFrontInput () |
| bool | PrintObservers (std::ostream &os, Indent indent) const |
| void | PrintSelf (std::ostream &os, Indent indent) const |
| virtual void | PrintTrailer (std::ostream &os, Indent indent) const |
| virtual void | PropagateResetPipeline () |
| Push Pop an input of this process object These methods allow a *filter to model its input vector as a queue or stack These *routines may not be appropriate for all especially *filters with different types of inputs These routines follow *the semantics of STL *virtual void | PushBackInput (const DataObject *input) |
| virtual void | PushFrontInput (const DataObject *input) |
| virtual void | ReleaseInputs () |
| virtual void | RemoveInput (DataObject *input) |
| virtual void | RemoveOutput (DataObject *output) |
| virtual void | RestoreInputReleaseDataFlags () |
| Protected methods for setting inputs *Subclasses make use of them for setting input *virtual void | SetNthInput (unsigned int num, DataObject *input) |
| Protected methods for setting outputs *Subclasses make use of them for getting output *virtual void | SetNthOutput (unsigned int num, DataObject *output) |
| void | SetNumberOfInputs (unsigned int num) |
| void | SetNumberOfOutputs (unsigned int num) |
| virtual void | SetNumberOfRequiredInputs (unsigned int _arg) |
| virtual void | SetNumberOfRequiredOutputs (unsigned int _arg) |
| virtual | ~PointSetToPointSetRegistrationMethod () |
Protected Attributes | |
| Push Pop an input of this process object These methods allow a *filter to model its input vector as a queue or stack These *routines may not be appropriate for all | filters |
| TimeStamp | m_OutputInformationMTime |
| int | m_ReferenceCount |
| SimpleFastMutexLock | m_ReferenceCountLock |
| bool | m_Updating |
| Methods invoked by virtual 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.*/virtual void PrintSelf(std voi | PrintHeader )(std::ostream &os, Indent indent) const |
|
|||||
|
Reimplemented from itk::ProcessObject. Definition at line 68 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|
|
STL Array of SmartPointers to DataObjects Definition at line 103 of file itkProcessObject.h. |
|
|||||
|
Definition at line 78 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Type of the Fixed PointSet. Definition at line 74 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Definition at line 87 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Type of the metric. Definition at line 86 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Definition at line 82 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Type of the Moving PointSet. Definition at line 81 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Type of the optimizer. Definition at line 94 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Type of the Transformation parameters This is the same type used to represent the search space of the optimization algorithm Definition at line 98 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Reimplemented from itk::ProcessObject. Definition at line 67 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Standard class typedefs. Reimplemented from itk::ProcessObject. Definition at line 65 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Reimplemented from itk::ProcessObject. Definition at line 66 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Definition at line 91 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||
|
Type of the Transform . Definition at line 90 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|||||||||
|
|
|
|||||||||
|
Definition at line 142 of file itkPointSetToPointSetRegistrationMethod.h. |
|
|
|
|
|
Turn on and off the AbortGenerateData flag. |
|
|
|
|
|
|
|
|
This method is called when itkExceptionMacro executes. It allows the debugger to break on error. |
|
|
Cache the state of any ReleaseDataFlag's on the inputs. While the filter is executing, we need to set the ReleaseDataFlag's on the inputs to false in case the current filter is implemented using a mini-pipeline (which will try to release the inputs). After the filter finishes, we restore the state of the ReleaseDataFlag's before the call to ReleaseInputs(). |
|
|
Create an object from an instance, potentially deferring to a factory. This method allows you to create an instance of an object that is exactly the same type as the referring object. This is useful in cases where an object has been cast back to a base class. Reimplemented from itk::LightObject. |
|
|
Turn debugging output off. |
|
|
Turn debugging output on. |
|
|
Delete an itk object. This method should always be used to delete an object when the new operator was used to create it. Using the C delete method will not work with reference counting. |
|
|
|
|
|
|
Given one output whose requested region has been set, how should the requested regions for the remaining outputs of the process object be set? By default, all the outputs are set to the same requested region. If a filter needs to produce different requested regions for each output, for instance an image processing filter producing several outputs at different resolutions, then that filter may override this method and set the requested regions appropriatedly. Note that a filter producing multiple outputs of different types is required to override this method. The default implementation can only correctly handle multiple outputs of the same type. Reimplemented in itk::MultiResolutionPyramidImageFilter< TInputImage, TOutputImage >, itk::RecursiveMultiResolutionPyramidImageFilter< TInputImage, TOutputImage >, itk::watershed::BoundaryResolver< TPixelType, TDimension >, itk::watershed::EquivalenceRelabeler< TScalarType, TImageDimension >, itk::watershed::Relabeler< TScalarType, TImageDimension >, itk::watershed::Segmenter< TInputImage >, itk::watershed::SegmentTreeGenerator< TScalarType >, itk::watershed::Relabeler< ScalarType, itkGetStaticConstMacro(ImageDimension)>, and itk::watershed::SegmentTreeGenerator< ScalarType >. |
|
|
Get the AbortGenerateData flag for the process object. Process objects may handle premature termination of execution in different ways. |
|
|
Get the command associated with the given tag. NOTE: This returns a pointer to a Command, but it is safe to asign this to a Command::Pointer. Since Command inherits from LightObject, at this point in the code, only a pointer or a reference to the Command can be used. |
|
|
Get the value of the debug flag. |
|
|||||||||
|
|
|
|
|
|
|||||||||
|
|
|
|
|
|
|
|
Return an array with all the inputs of this process object. This is useful for tracing back in the pipeline to construct graphs etc. Definition at line 108 of file itkProcessObject.h. |
|
|||||||||
|
Get the last transformation parameters visited by the optimizer. |
|
|
|
|
|
|
|
|||||||||
|
|
|
|||||||||
|
|
|
|
|
Return the multithreader used by this class. Definition at line 281 of file itkProcessObject.h. |
|
|||||||||
|
Run-time type information (and related methods). Reimplemented from itk::ProcessObject. |
|
|
Get the size of the input vector. This is merely the size of the input vector, not the number of inputs that have valid DataObject's assigned. Use GetNumberOfValidRequiredInputs() to determine how many inputs are non-null. Definition at line 115 of file itkProcessObject.h. |
|
|
Definition at line 132 of file itkProcessObject.h. |
|
|
|
|
|
|
|
|
|
|
|
Get the number of valid inputs. This is the number of non-null entries in the input vector in the first NumberOfRequiredInputs slots. This method is used to determine whether the necessary required inputs have been set. Subclasses of ProcessObject may override this implementation if the required inputs are not the first slots in input vector. Reimplemented in itk::MultiResolutionPDEDeformableRegistration< TFixedImage, TMovingImage, TDeformationField >, and itk::PDEDeformableRegistrationFilter< TFixedImage, TMovingImage, TDeformationField >. |
|
|||||||||
|
|
|
|
|
|
|
|
Definition at line 130 of file itkProcessObject.h. |
|
|
Get the execution progress of a process object. The progress is a floating number in [0,1] with 0 meaning no progress and 1 meaning the filter has completed execution. |
|
|
Gets the reference count on this object. Definition at line 98 of file itkLightObject.h. |
|
|
|
|
|
|
|
|||||||||
|
|
|
|
Definition at line 100 of file itkObject.h. References itk::Object::SetGlobalWarningDisplay(). |
|
|
Definition at line 98 of file itkObject.h. References itk::Object::SetGlobalWarningDisplay(). |
|
|
Return true if an observer is registered for this event. |
|
|||||||||
|
Initialize by setting the interconnects between the components. |
|
|
Call Execute on all the Commands observing this event id. The actions triggered by this call doesn't modify this object. |
|
|
Call Execute on all the Commands observing this event id. |
|
|
|
|||||||||
|
Method for creation through the object factory. Reimplemented from itk::Object. |
|
|
|
|
An opportunity to deallocate a ProcessObject's bulk data storage. Some filters may wish to reuse existing bulk data storage to avoid unnecessary deallocation/allocation sequences. The default implementation calls Initialize() on each output. DataObject::Initialize() frees its bulk data by default. Reimplemented in itk::WatershedImageFilter< TInputImage >. |
|
||||||||||||
|
Cause the object to print itself out. |
|
||||||||||||
|
|
|
||||||||||||||||
|
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::ProcessObject. |
|
||||||||||||
|
|
|
|
Send the requested region information back up the pipeline (to the filters that preceed this one). Reimplemented in itk::VTKImageImport< TOutputImage >. |
|
|
Propagate a call to ResetPipeline() up the pipeline. Called only from DataObject. |
|
|
|
|
Increase the reference count (mark as used by another object). Reimplemented from itk::LightObject. |
|
|
|
|
|
|
|
|
Definition at line 254 of file itkProcessObject.h. |
|
|
Definition at line 253 of file itkProcessObject.h. |
|
|
|
Remove all observers . |
|
|
|
|
|
Remove the observer with this tag value. |
|
|
|
|
|
Reset the pipeline. If an exception is thrown during an Update(), the pipeline may be in an inconsistent state. This method clears the internal state of the pipeline so Update() can be called. |
|
|
Restore the cached input ReleaseDataFlags. |
|
|
Set the AbortGenerateData flag for the process object. Process objects may handle premature termination of execution in different ways. |
|
|
Set the value of the debug flag. A non-zero value turns debugging on. |
|
||||||||||
|
|
|
|
Referenced by itk::Object::GlobalWarningDisplayOff(), and itk::Object::GlobalWarningDisplayOn(). |
|
||||||||||
|
|
|
|
|
|
||||||||||
|
|
|
||||||||||
|
|
|
||||||||||||
|
||||||||||||
|
|
Called to allocate the input array. Copies old inputs. |
|
|
Called to allocate the output array. Copies old outputs. |
|
|
|
|
|
|
|
|
|
|
||||||||||
|
|
|
|
Set the execution progress of a process object. The progress is a floating number in [0,1] with 0 meaning no progress and 1 meaning the filter has completed execution. The ProgressEvent is NOT invoked. |
|
|
Sets the reference count (use with care) Reimplemented from itk::LightObject. |
|
|
|
|
||||||||||
|
|
|
||||||||||
|
Method that initiates the registration. |
|
|
Decrease the reference count (release by another object). Reimplemented from itk::LightObject. |
|
|
|
|
|
Like Update(), but sets the output requested region to the largest possible region for the output. This is the method users should call if they want the entire dataset to be processed. If a user wants to update the same output region as a previous call to Update() or a previous call to UpdateLargestPossibleRegion(), then they should call the method Update(). |
|
|
Actually generate new output Reimplemented in itk::StreamingImageFilter< TInputImage, TOutputImage >. |
|
|
Update the information decribing the output data. This method transverses up the pipeline gathering modified time information. On the way back down the pipeline, this method calls GenerateOutputInformation() to set any necessary information about the output data objects. For instance, a filter that shrinks an image will need to provide an implementation for GenerateOutputInformation() that changes the spacing of the pixels. Such filters should call their superclass' implementation of GenerateOutputInformation prior to changing the information values they need (i.e. GenerateOutputInformation() should call Superclass::GenerateOutputInformation() prior to changing the information. Reimplemented in itk::watershed::Segmenter< TInputImage >, and itk::VTKImageImport< TOutputImage >. |
|
|
Update the progress of the process object. Sets the Progress ivar to amount and invokes any observers for the ProgressEvent. The parameter amount should be in [0,1] and is the cumulative (not incremental) progress. |
|
|
|
|
|
Definition at line 94 of file itkObject.h. |
|
|
|
Time when GenerateOutputInformation was last called. Definition at line 428 of file itkProcessObject.h. |
|
|
Number of uses of this object by other objects. Definition at line 119 of file itkLightObject.h. |
|
|
Mutex lock to protect modification to the reference count Definition at line 122 of file itkLightObject.h. |
|
|
This flag indicates when the pipeline is executing. It prevents infinite recursion when pipelines have loops. Definition at line 425 of file itkProcessObject.h. |
|
|
|
1.4.2 written by Dimitri van Heesch,
© 1997-2000