ITK
6.0.0
Insight Toolkit
|
#include <itkCentralDifferenceImageFunction.h>
Calculate the derivative by central differencing.
This class is templated over the input image type, the coordinate representation type (e.g. float or double), and the output derivative type.
This class supports both scalar and vector pixel types for the input image, including VectorImage types.
For vector-pixel image types, the TOutputType template parameter must be set to a vector of appropriate size, to accommodate a result for each pixel component in each dimension. The output is packed by pixel component, i.e.
[C0D0, C0D1, ..., C0DN, C1D0, ...]
where C = pixel component, and D = image dimension.
The output type can be, for example:
\code CovariantVector<double, numberOfPixelComponents * ImageDimension> \endcode
or
Possible improvements:
1) speed performance: The template-specialization of the Evaluate*() methods (needed to support vector-pixel types) incur a performance penalty for the scalar-pixel case, when compared with previous scalar-only versions of the code. On MacOS (2.4GHz Core 2 Duo, gcc 4.2) the penalty is 0.5-2%, depending on the method. To recover this loss, the specialization of the methods would have to be done such that a nested subroutine need not be called, ie the specialization is performed on the Evaluate* methods directly. At the moment is seems this can't be done without requiring a template parameter on the methods.
2) the use of Neighborhood operators may improve efficiency.
Definition at line 76 of file itkCentralDifferenceImageFunction.h.
Classes | |
struct | OutputTypeSpecializationStructType |
Public Member Functions | |
OutputType | Evaluate (const PointType &point) const override |
OutputType | EvaluateAtContinuousIndex (const ContinuousIndexType &cindex) const override |
OutputType | EvaluateAtIndex (const IndexType &index) const override |
virtual InterpolatorType * | GetModifiableInterpolator () |
const char * | GetNameOfClass () const override |
void | SetInputImage (const TInputImage *inputData) override |
virtual void | SetInterpolator (InterpolatorType *interpolator) |
virtual void | SetUseImageDirection (bool _arg) |
virtual bool | GetUseImageDirection () const |
virtual void | UseImageDirectionOn () |
Public Member Functions inherited from itk::ImageFunction< TInputImage, TOutputType, TCoordRep > | |
void | ConvertContinuousIndexToNearestIndex (const ContinuousIndexType &cindex, IndexType &index) const |
void | ConvertPointToContinuousIndex (const PointType &point, ContinuousIndexType &cindex) const |
virtual const ContinuousIndexType & | GetEndContinuousIndex () const |
virtual const IndexType & | GetEndIndex () const |
const InputImageType * | GetInputImage () const |
const char * | GetNameOfClass () const override |
virtual const ContinuousIndexType & | GetStartContinuousIndex () const |
virtual const IndexType & | GetStartIndex () const |
virtual bool | IsInsideBuffer (const IndexType &index) const |
virtual bool | IsInsideBuffer (const ContinuousIndexType &index) const |
virtual bool | IsInsideBuffer (const PointType &point) const |
void | ConvertPointToNearestIndex (const PointType &point, IndexType &index) const |
Public Member Functions inherited from itk::Object | |
unsigned long | AddObserver (const EventObject &event, Command *cmd) const |
unsigned long | AddObserver (const EventObject &event, std::function< void(const EventObject &)> function) const |
LightObject::Pointer | CreateAnother () const override |
virtual void | DebugOff () const |
virtual void | DebugOn () const |
Command * | GetCommand (unsigned long tag) |
bool | GetDebug () const |
MetaDataDictionary & | GetMetaDataDictionary () |
const MetaDataDictionary & | GetMetaDataDictionary () const |
virtual ModifiedTimeType | GetMTime () const |
virtual const TimeStamp & | GetTimeStamp () const |
bool | HasObserver (const EventObject &event) const |
void | InvokeEvent (const EventObject &) |
void | InvokeEvent (const EventObject &) const |
virtual void | Modified () const |
void | Register () const override |
void | RemoveAllObservers () |
void | RemoveObserver (unsigned long tag) const |
void | SetDebug (bool debugFlag) const |
void | SetReferenceCount (int) override |
void | UnRegister () const noexcept override |
void | SetMetaDataDictionary (const MetaDataDictionary &rhs) |
void | SetMetaDataDictionary (MetaDataDictionary &&rrhs) |
virtual void | SetObjectName (std::string _arg) |
virtual const std::string & | GetObjectName () const |
Public Member Functions inherited from itk::LightObject | |
Pointer | Clone () const |
virtual void | Delete () |
virtual int | GetReferenceCount () const |
void | Print (std::ostream &os, Indent indent=0) const |
Static Public Member Functions | |
static Pointer | New () |
Static Public Member Functions inherited from itk::Object | |
static bool | GetGlobalWarningDisplay () |
static void | GlobalWarningDisplayOff () |
static void | GlobalWarningDisplayOn () |
static Pointer | New () |
static void | SetGlobalWarningDisplay (bool val) |
Static Public Member Functions inherited from itk::LightObject | |
static void | BreakOnError () |
static Pointer | New () |
Static Public Attributes | |
static constexpr unsigned int | ImageDimension = TInputImage::ImageDimension |
Static Public Attributes inherited from itk::ImageFunction< TInputImage, TOutputType, TCoordRep > | |
static constexpr unsigned int | ImageDimension |
Protected Member Functions | |
CentralDifferenceImageFunction () | |
void | PrintSelf (std::ostream &os, Indent indent) const override |
~CentralDifferenceImageFunction () override=default | |
Protected Member Functions inherited from itk::ImageFunction< TInputImage, TOutputType, TCoordRep > | |
ImageFunction () | |
void | PrintSelf (std::ostream &os, Indent indent) const override |
~ImageFunction () override=default | |
Protected Member Functions inherited from itk::FunctionBase< Point< TCoordRep, TInputImage::ImageDimension >, TOutputType > | |
FunctionBase ()=default | |
~FunctionBase () override=default | |
Protected Member Functions inherited from itk::Object | |
Object () | |
bool | PrintObservers (std::ostream &os, Indent indent) const |
virtual void | SetTimeStamp (const TimeStamp &timeStamp) |
~Object () override | |
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 () |
Private Attributes | |
InterpolatorPointer | m_Interpolator {} |
bool | m_UseImageDirection { true } |
Additional Inherited Members | |
Protected Attributes inherited from itk::ImageFunction< TInputImage, TOutputType, TCoordRep > | |
ContinuousIndexType | m_EndContinuousIndex |
IndexType | m_EndIndex |
InputImageConstPointer | m_Image |
ContinuousIndexType | m_StartContinuousIndex |
IndexType | m_StartIndex |
Protected Attributes inherited from itk::LightObject | |
std::atomic< int > | m_ReferenceCount {} |
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::ConstPointer = SmartPointer<const Self> |
Definition at line 88 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::InputImageType = TInputImage |
InputImageType type alias support
Definition at line 97 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::InputPixelConvertType = DefaultConvertPixelTraits<InputPixelType> |
InputPixelConvert type alias support
Definition at line 103 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::InputPixelType = typename InputImageType::PixelType |
InputPixelType type alias support
Definition at line 100 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::InterpolatorPointer = typename InterpolatorType::Pointer |
Definition at line 131 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::InterpolatorType = InterpolateImageFunction<TInputImage, TCoordRep> |
Interpolator type alias support
Definition at line 130 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::OutputConvertType = DefaultConvertPixelTraits<OutputType> |
Output convert type alias support
Definition at line 109 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::OutputValueType = typename OutputConvertType::ComponentType |
Output value type alias support
Definition at line 112 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::Pointer = SmartPointer<Self> |
Definition at line 87 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::ScalarDerivativeType = CovariantVector<OutputValueType, Self::ImageDimension> |
Scalar derivative type alias support
Definition at line 115 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::Self = CentralDifferenceImageFunction |
Standard class type aliases.
Definition at line 85 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::SpacingType = typename TInputImage::SpacingType |
Spacing type alias support
Definition at line 127 of file itkCentralDifferenceImageFunction.h.
using itk::CentralDifferenceImageFunction< TInputImage, TCoordRep, TOutputType >::Superclass = ImageFunction<TInputImage, TOutputType, TCoordRep> |
Definition at line 86 of file itkCentralDifferenceImageFunction.h.
|
protected |
|
overrideprotecteddefault |
|
overridevirtual |
Evaluate the image derivative by central differencing at non-integer point.
No bounds checking is done. The point is assumed to lie within the image buffer. If not, 0 is returned for the derivative without any error return, because of bounds-checking performed on the neighboring points.
If point
lies on a boundary in a given dimension, 0 is returned for that dimension. Note that points are centered on the voxel.
ImageFunction::IsInsideBuffer() can be used to check bounds before calling the method.
Implements itk::ImageFunction< TInputImage, TOutputType, TCoordRep >.
|
overridevirtual |
Evaluate the image derivative by central differencing at non-integer index.
No bounds checking is done. The point is assumed to lie within the image buffer.
If cindex
lies on a boundary in a given dimension, 0 is returned for that dimension.
ImageFunction::IsInsideBuffer() can be used to check bounds before calling the method.
Implements itk::ImageFunction< TInputImage, TOutputType, TCoordRep >.
|
inlineprivate |
Specialized version of EvaluateAtContinuousIndex() method to handle vector pixel types.
|
inlineprivate |
Specialized version of EvaluateAtContinuousIndex() method to handle scalar pixel types.
|
overridevirtual |
Evaluate the image derivative by central differencing at specified index.
No bounds checking is done. The point is assumed to lie within the image buffer.
If index
lies on a boundary in a given dimension, 0 is returned for that dimension.
ImageFunction::IsInsideBuffer() can be used to check bounds before calling the method.
Implements itk::ImageFunction< TInputImage, TOutputType, TCoordRep >.
|
inlineprivate |
Specialized version of EvaluateAtIndex() method to handle vector pixel types.
|
inlineprivate |
Specialized version of EvaluateAtIndex() method to handle scalar pixel types.
|
private |
Specialized version of Evaluate() method to handle vector pixel types.
|
private |
Specialized version of Evaluate() method to handle scalar pixel types.
|
virtual |
Get the interpolator.
|
overridevirtual |
Reimplemented from itk::Object.
|
virtual |
The UseImageDirection flag determines whether image derivatives are computed with respect to the image grid or with respect to the physical space. When this flag is ON the derivatives are computed with respect to the coordinate system of physical space. The difference is whether we take into account the image Direction or not. For EvaluateAtIndex
and EvaluateAtContinuousIndex
, the flag ON will take into account the image direction and will result in an extra matrix multiplication compared to the amount of computation performed when the flag is OFF. For Evaluate
, the opposite is true: the flag OFF will ignore the image direction and will result in an extra matrix multiplication compared to the amount of computation performed when the flag is ON. The default value of this flag is On.
|
static |
Method for creation through the object factory.
|
overrideprotectedvirtual |
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::Object.
|
overridevirtual |
Set the input image. This must be set by the user.
Reimplemented from itk::ImageFunction< TInputImage, TOutputType, TCoordRep >.
|
virtual |
Set interpolator. The interpolator is used in the methods Evaluate
and EvaluateAtContinuousIndex
.
|
virtual |
The UseImageDirection flag determines whether image derivatives are computed with respect to the image grid or with respect to the physical space. When this flag is ON the derivatives are computed with respect to the coordinate system of physical space. The difference is whether we take into account the image Direction or not. For EvaluateAtIndex
and EvaluateAtContinuousIndex
, the flag ON will take into account the image direction and will result in an extra matrix multiplication compared to the amount of computation performed when the flag is OFF. For Evaluate
, the opposite is true: the flag OFF will ignore the image direction and will result in an extra matrix multiplication compared to the amount of computation performed when the flag is ON. The default value of this flag is On.
|
virtual |
The UseImageDirection flag determines whether image derivatives are computed with respect to the image grid or with respect to the physical space. When this flag is ON the derivatives are computed with respect to the coordinate system of physical space. The difference is whether we take into account the image Direction or not. For EvaluateAtIndex
and EvaluateAtContinuousIndex
, the flag ON will take into account the image direction and will result in an extra matrix multiplication compared to the amount of computation performed when the flag is OFF. For Evaluate
, the opposite is true: the flag OFF will ignore the image direction and will result in an extra matrix multiplication compared to the amount of computation performed when the flag is ON. The default value of this flag is On.
|
staticconstexpr |
Dimension underlying input image.
Definition at line 82 of file itkCentralDifferenceImageFunction.h.
|
private |
Definition at line 267 of file itkCentralDifferenceImageFunction.h.
|
private |
Definition at line 264 of file itkCentralDifferenceImageFunction.h.