ITK
4.4.0
Insight Segmentation and Registration Toolkit
|
#include <itkFiniteDifferenceFunction.h>
This class is a component object of the finite difference solver hierarchy (see FiniteDifferenceImageFilter). It defines a generic interface for a function object that computes a single scalar value from a neighborhood of values. Examples of the application of this class are the various flavors of AnisotropicDiffusionFunction and LevelSetFunction objects.
These functions calculate the incremental change at a pixel in the solution image from one iteration of the Partial Differential Equation (PDE) solver to the next.
Definition at line 66 of file itkFiniteDifferenceFunction.h.
Public Types | |
typedef SmartPointer< const Self > | ConstPointer |
typedef ZeroFluxNeumannBoundaryCondition < ImageType > | DefaultBoundaryConditionType |
typedef Vector< float, itkGetStaticConstMacro(ImageDimension) > | FloatOffsetType |
typedef TImageType | ImageType |
typedef Vector< PixelRealType, itkGetStaticConstMacro(ImageDimension) > | NeighborhoodScalesType |
typedef ConstNeighborhoodIterator < TImageType, DefaultBoundaryConditionType > | NeighborhoodType |
typedef double | PixelRealType |
typedef ImageType::PixelType | PixelType |
typedef SmartPointer< Self > | Pointer |
typedef ConstNeighborhoodIterator < TImageType >::RadiusType | RadiusType |
typedef FiniteDifferenceFunction | Self |
typedef LightObject | Superclass |
typedef double | TimeStepType |
Public Types inherited from itk::LightObject | |
typedef SmartPointer< const Self > | ConstPointer |
typedef SmartPointer< Self > | Pointer |
typedef LightObject | Self |
Public Member Functions | |
virtual TimeStepType | ComputeGlobalTimeStep (void *GlobalData) const =0 |
const NeighborhoodScalesType | ComputeNeighborhoodScales () const |
virtual PixelType | ComputeUpdate (const NeighborhoodType &neighborhood, void *globalData, const FloatOffsetType &offset=FloatOffsetType(0.0))=0 |
virtual void * | GetGlobalDataPointer () const =0 |
virtual const char * | GetNameOfClass () const |
const RadiusType & | GetRadius () const |
void | GetScaleCoefficients (PixelRealType vals[ImageDimension]) const |
virtual void | InitializeIteration () |
virtual void | ReleaseGlobalDataPointer (void *GlobalData) const =0 |
void | SetRadius (const RadiusType &r) |
void | SetScaleCoefficients (PixelRealType vals[ImageDimension]) |
Public Member Functions inherited from itk::LightObject | |
virtual Pointer | CreateAnother () const |
virtual void | Delete () |
virtual int | GetReferenceCount () const |
itkCloneMacro (Self) | |
void | Print (std::ostream &os, Indent indent=0) const |
virtual void | Register () const |
virtual void | SetReferenceCount (int) |
virtual void | UnRegister () const |
Static Public Attributes | |
static const unsigned int | ImageDimension = ImageType::ImageDimension |
Protected Member Functions | |
FiniteDifferenceFunction () | |
void | PrintSelf (std::ostream &os, Indent indent) const |
~FiniteDifferenceFunction () | |
Protected Member Functions inherited from itk::LightObject | |
virtual LightObject::Pointer | InternalClone () const |
LightObject () | |
virtual void | PrintHeader (std::ostream &os, Indent indent) const |
virtual void | PrintTrailer (std::ostream &os, Indent indent) const |
virtual | ~LightObject () |
Protected Attributes | |
RadiusType | m_Radius |
PixelRealType | m_ScaleCoefficients [ImageDimension] |
Protected Attributes inherited from itk::LightObject | |
InternalReferenceCountType | m_ReferenceCount |
SimpleFastMutexLock | m_ReferenceCountLock |
Private Member Functions | |
FiniteDifferenceFunction (const Self &) | |
void | operator= (const Self &) |
Additional Inherited Members | |
Static Public Member Functions inherited from itk::LightObject | |
static void | BreakOnError () |
static Pointer | New () |
Protected Types inherited from itk::LightObject | |
typedef int | InternalReferenceCountType |
typedef SmartPointer< const Self > itk::FiniteDifferenceFunction< TImageType >::ConstPointer |
Definition at line 74 of file itkFiniteDifferenceFunction.h.
typedef ZeroFluxNeumannBoundaryCondition< ImageType > itk::FiniteDifferenceFunction< TImageType >::DefaultBoundaryConditionType |
The default boundary condition for finite difference functions that is used unless overridden in the Evaluate() method.
Definition at line 93 of file itkFiniteDifferenceFunction.h.
typedef Vector< float, itkGetStaticConstMacro(ImageDimension) > itk::FiniteDifferenceFunction< TImageType >::FloatOffsetType |
A floating point offset from an image grid location. Used for interpolation among grid values in a neighborhood.
Definition at line 108 of file itkFiniteDifferenceFunction.h.
typedef TImageType itk::FiniteDifferenceFunction< TImageType >::ImageType |
Extract some parameters from the image type
Definition at line 77 of file itkFiniteDifferenceFunction.h.
typedef Vector< PixelRealType, itkGetStaticConstMacro(ImageDimension) > itk::FiniteDifferenceFunction< TImageType >::NeighborhoodScalesType |
The type of data structure that holds the scales with which the neighborhood is weighted to properly account for spacing and neighborhood radius.
Definition at line 104 of file itkFiniteDifferenceFunction.h.
typedef ConstNeighborhoodIterator< TImageType, DefaultBoundaryConditionType > itk::FiniteDifferenceFunction< TImageType >::NeighborhoodType |
The type of data structure that is passed to this function object to evaluate at a pixel that does not lie on a data set boundary.
Definition at line 100 of file itkFiniteDifferenceFunction.h.
typedef double itk::FiniteDifferenceFunction< TImageType >::PixelRealType |
Definition at line 82 of file itkFiniteDifferenceFunction.h.
typedef ImageType::PixelType itk::FiniteDifferenceFunction< TImageType >::PixelType |
Definition at line 81 of file itkFiniteDifferenceFunction.h.
typedef SmartPointer< Self > itk::FiniteDifferenceFunction< TImageType >::Pointer |
Definition at line 73 of file itkFiniteDifferenceFunction.h.
typedef ConstNeighborhoodIterator< TImageType >::RadiusType itk::FiniteDifferenceFunction< TImageType >::RadiusType |
Neighborhood radius type
Definition at line 96 of file itkFiniteDifferenceFunction.h.
typedef FiniteDifferenceFunction itk::FiniteDifferenceFunction< TImageType >::Self |
Standard class typedefs.
Definition at line 71 of file itkFiniteDifferenceFunction.h.
typedef LightObject itk::FiniteDifferenceFunction< TImageType >::Superclass |
Definition at line 72 of file itkFiniteDifferenceFunction.h.
typedef double itk::FiniteDifferenceFunction< TImageType >::TimeStepType |
Define the TimeStepType to always be double.
Definition at line 88 of file itkFiniteDifferenceFunction.h.
|
protected |
|
inlineprotected |
Definition at line 188 of file itkFiniteDifferenceFunction.h.
|
private |
|
pure virtual |
Computes the time step for an update given a global data structure. The data used in the computation may take different forms depending on the nature of the equations. This global data cannot be kept in the instance of the equation object itself since the equation object must remain stateless for thread safety. The global data is therefore managed for each thread by the finite difference solver filters.
Implemented in itk::AnisotropicDiffusionFunction< TImage >, itk::LevelSetFunction< TImageType >, itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >, itk::RegionBasedLevelSetFunction< TInputImage, TFeatureImage, TSharedData >, itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::GPUDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::DemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::LevelSetMotionRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::FastSymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::NCCRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MeanSquareRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MIRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >, itk::ShapePriorSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::GPUAnisotropicDiffusionFunction< TImage >, itk::NormalVectorFunctionBase< TSparseImageType >, and itk::CurvatureFlowFunction< TImage >.
const NeighborhoodScalesType itk::FiniteDifferenceFunction< TImageType >::ComputeNeighborhoodScales | ( | ) | const |
Compute the scales that weight the neighborhood during difference operations to properly account for spacing and neighborhood radius
|
pure virtual |
This method is called by a finite difference solver image filter at each pixel that does not lie on a data set boundary. The width of the data set boundary is defined by the width of the neighborhood being evaluated.
The neighborhood argument is the neighborhood data. The globalData argument is a pointer to a data structure that holds values that need to be persistent across calls to this function, but cannot be stored in the function object itself for thread-safety reasons. Examples are values needed to compute the time-step for an iteration of the solver.
Implemented in itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >, itk::RegionBasedLevelSetFunction< TInputImage, TFeatureImage, TSharedData >, itk::LevelSetFunction< TImageType >, itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::DemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::LevelSetMotionRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::FastSymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::NCCRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MeanSquareRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MIRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::CurvatureFlowFunction< TImage >, itk::ShapePriorSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::CurvatureNDAnisotropicDiffusionFunction< TImage >, itk::GradientNDAnisotropicDiffusionFunction< TImage >, itk::GPUFiniteDifferenceFunction< TImageType >, itk::GPUFiniteDifferenceFunction< TImage >, itk::GPUFiniteDifferenceFunction< TDisplacementField >, itk::FiniteDifferenceSparseImageFunction< TSparseImageType >, itk::MinMaxCurvatureFlowFunction< TImage >, itk::VectorGradientNDAnisotropicDiffusionFunction< TImage >, itk::BinaryMinMaxCurvatureFlowFunction< TImage >, and itk::VectorCurvatureNDAnisotropicDiffusionFunction< TImage >.
|
pure virtual |
Returns a pointer to a global data structure that is passed to this object from the solver at each calculation. The idea is that the solver holds the state of any global values needed to calculate the time step, while the equation object performs the actual calculations.
The global data should also be initialized in this method.
Implemented in itk::AnisotropicDiffusionFunction< TImage >, itk::LevelSetFunction< TImageType >, itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >, itk::RegionBasedLevelSetFunction< TInputImage, TFeatureImage, TSharedData >, itk::GPUDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::DemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::FastSymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::LevelSetMotionRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::NCCRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MeanSquareRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MIRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::ShapePriorSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::GPUAnisotropicDiffusionFunction< TImage >, itk::CurvatureFlowFunction< TImage >, and itk::NormalVectorFunctionBase< TSparseImageType >.
|
virtual |
Run-time type information (and related methods)
Reimplemented from itk::LightObject.
Reimplemented in itk::AnisotropicDiffusionFunction< TImage >, itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >, itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >, itk::CurvatureNDAnisotropicDiffusionFunction< TImage >, itk::ScalarChanAndVeseLevelSetFunction< TInputImage, TFeatureImage, TSharedData >, itk::ShapeDetectionLevelSetFunction< TImageType, TFeatureImageType >, itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >, itk::RegionBasedLevelSetFunction< TInputImage, TFeatureImage, TSharedData >, itk::LevelSetFunction< TImageType >, itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::CurvesLevelSetFunction< TImageType, TFeatureImageType >, itk::ScalarRegionBasedLevelSetFunction< TInputImage, TFeatureImage, TSharedData >, itk::GradientNDAnisotropicDiffusionFunction< TImage >, itk::GPUDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::LevelSetMotionRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::VectorThresholdSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::GPUGradientNDAnisotropicDiffusionFunction< TImage >, itk::DemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::ThresholdSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::NormalVectorDiffusionFunction< TSparseImageType >, itk::ShapePriorSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::MeanSquareRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MIRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::NCCRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::ScalarAnisotropicDiffusionFunction< TImage >, itk::VectorAnisotropicDiffusionFunction< TImage >, itk::FastSymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >, itk::NormalVectorFunctionBase< TSparseImageType >, itk::FiniteDifferenceSparseImageFunction< TSparseImageType >, itk::VectorCurvatureNDAnisotropicDiffusionFunction< TImage >, itk::VectorGradientNDAnisotropicDiffusionFunction< TImage >, itk::GPUFiniteDifferenceFunction< TImageType >, itk::GPUFiniteDifferenceFunction< TImage >, itk::GPUFiniteDifferenceFunction< TDisplacementField >, itk::CurvatureFlowFunction< TImage >, itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::BinaryMinMaxCurvatureFlowFunction< TImage >, itk::MinMaxCurvatureFlowFunction< TImage >, itk::PDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::GPUPDEDeformableRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::CannySegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::LaplacianSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::GPUAnisotropicDiffusionFunction< TImage >, and itk::GPUScalarAnisotropicDiffusionFunction< TImage >.
const RadiusType& itk::FiniteDifferenceFunction< TImageType >::GetRadius | ( | ) | const |
Returns the radius of the neighborhood this FiniteDifferenceFunction needs to perform its calculations.
void itk::FiniteDifferenceFunction< TImageType >::GetScaleCoefficients | ( | PixelRealType | vals[ImageDimension] | ) | const |
Returns the current scale coefficients.
|
inlinevirtual |
This method allows the function to set its state before each iteration of the finite difference solver (image filter) that uses it. This is a thread-safe time to manipulate the object's state.
An example of how this can be used: the AnisotropicDiffusionFunction class of FiniteDifferenceFunction use this method to pre-calculate an average gradient magnitude across the entire image region. This value is set in the function object and used by the ComputeUpdate() methods that are called at each pixel as a constant.
Reimplemented in itk::GPUDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::DemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::LevelSetMotionRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::FastSymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::NCCRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MeanSquareRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MIRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::CurvatureNDAnisotropicDiffusionFunction< TImage >, itk::GradientNDAnisotropicDiffusionFunction< TImage >, itk::GPUGradientNDAnisotropicDiffusionFunction< TImage >, itk::VectorGradientNDAnisotropicDiffusionFunction< TImage >, itk::GPUFiniteDifferenceFunction< TImageType >, itk::GPUFiniteDifferenceFunction< TImage >, itk::GPUFiniteDifferenceFunction< TDisplacementField >, and itk::VectorCurvatureNDAnisotropicDiffusionFunction< TImage >.
Definition at line 119 of file itkFiniteDifferenceFunction.h.
|
private |
|
protectedvirtual |
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::LightObject.
Reimplemented in itk::LevelSetFunction< TImageType >, itk::ThresholdSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >, itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >, itk::VectorThresholdSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::ShapePriorSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::CurvesLevelSetFunction< TImageType, TFeatureImageType >, itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >, itk::GPUFiniteDifferenceFunction< TImageType >, itk::GPUFiniteDifferenceFunction< TImage >, and itk::GPUFiniteDifferenceFunction< TDisplacementField >.
|
pure virtual |
When the finite difference solver filter has finished using a global data pointer, it passes it to this method, which frees the memory.
The solver cannot free the memory because it does not know the type to which the pointer points.
Implemented in itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >, itk::RegionBasedLevelSetFunction< TInputImage, TFeatureImage, TSharedData >, itk::LevelSetFunction< TImageType >, itk::AnisotropicDiffusionFunction< TImage >, itk::GPUDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::ESMDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::DemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::LevelSetMotionRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::FastSymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::SymmetricForcesDemonsRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::ShapePriorSegmentationLevelSetFunction< TImageType, TFeatureImageType >, itk::NCCRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MeanSquareRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::MIRegistrationFunction< TFixedImage, TMovingImage, TDisplacementField >, itk::GPUAnisotropicDiffusionFunction< TImage >, itk::CurvatureFlowFunction< TImage >, and itk::NormalVectorFunctionBase< TSparseImageType >.
void itk::FiniteDifferenceFunction< TImageType >::SetRadius | ( | const RadiusType & | r | ) |
Sets the radius of the neighborhood this FiniteDifferenceFunction needs to perform its calculations.
void itk::FiniteDifferenceFunction< TImageType >::SetScaleCoefficients | ( | PixelRealType | vals[ImageDimension] | ) |
Set the ScaleCoefficients for the difference operators. The defaults a 1.0. These can be set to take the image spacing into account.
|
static |
Save image dimension.
Definition at line 85 of file itkFiniteDifferenceFunction.h.
|
protected |
Definition at line 192 of file itkFiniteDifferenceFunction.h.
|
protected |
Definition at line 193 of file itkFiniteDifferenceFunction.h.