ITK  4.1.0
Insight Segmentation and Registration Toolkit
Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Member Functions | Private Attributes
itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput > Class Template Reference

#include <itkDiscreteHessianGaussianImageFunction.h>

+ Inheritance diagram for itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >:
+ Collaboration diagram for itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >:

List of all members.

Public Types

typedef SmartPointer< const SelfConstPointer
typedef
Superclass::ContinuousIndexType 
ContinuousIndexType
typedef FixedArray
< GaussianDerivativeOperatorType,
3 *itkGetStaticConstMacro(ImageDimension2) > 
GaussianDerivativeOperatorArrayType
typedef
itk::GaussianDerivativeOperator
< TOutput,
itkGetStaticConstMacro(ImageDimension2) > 
GaussianDerivativeOperatorType
typedef Superclass::IndexType IndexType
typedef Superclass::IndexValueType IndexValueType
typedef Superclass::InputImageType InputImageType
typedef Superclass::InputPixelType InputPixelType
enum  InterpolationModeType {
  NearestNeighbourInterpolation,
  LinearInterpolation
}
typedef FixedArray< KernelType,
itkGetStaticConstMacro(ImageDimension2)*(itkGetStaticConstMacro(ImageDimension2)+1)/2 > 
KernelArrayType
typedef Neighborhood< TOutput,
itkGetStaticConstMacro(ImageDimension2) > 
KernelType
typedef
OperatorImageFunctionType::Pointer 
OperatorImageFunctionPointer
typedef
NeighborhoodOperatorImageFunction
< InputImageType, TOutput > 
OperatorImageFunctionType
typedef Superclass::OutputType OutputType
typedef SmartPointer< SelfPointer
typedef Superclass::PointType PointType
typedef
DiscreteHessianGaussianImageFunction 
Self
typedef ImageFunction
< TInputImage,
SymmetricSecondRankTensor
< TOutput,::itk::GetImageDimension
< TInputImage >
::ImageDimension >, TOutput > 
Superclass
typedef
SymmetricSecondRankTensor
< TOutput,::itk::GetImageDimension
< TInputImage >
::ImageDimension
TensorType
typedef FixedArray< double,
itkGetStaticConstMacro(ImageDimension2) > 
VarianceArrayType

Public Member Functions

virtual ::itk::LightObject::Pointer CreateAnother (void) const
virtual OutputType Evaluate (const PointType &point) const
virtual OutputType EvaluateAtContinuousIndex (const ContinuousIndexType &index) const
virtual OutputType EvaluateAtIndex (const IndexType &index) const
virtual const char * GetNameOfClass () const
virtual void Initialize ()
virtual void SetInputImage (const InputImageType *ptr)
void SetSigma (const double sigma)
virtual void SetVariance (VarianceArrayType _arg)
virtual const VarianceArrayType GetVariance () const
virtual void SetVariance (double data[])
virtual void SetVariance (double variance)
virtual void SetMaximumError (double _arg)
virtual double GetMaximumError () const
virtual void SetNormalizeAcrossScale (bool _arg)
virtual bool GetNormalizeAcrossScale () const
virtual void NormalizeAcrossScaleOn ()
virtual void NormalizeAcrossScaleOff ()
virtual void SetUseImageSpacing (bool _arg)
virtual bool GetUseImageSpacing () const
virtual void UseImageSpacingOn ()
virtual void UseImageSpacingOff ()
virtual void SetMaximumKernelWidth (unsigned int _arg)
virtual unsigned int GetMaximumKernelWidth () const
virtual void SetInterpolationMode (InterpolationModeType _arg)
virtual InterpolationModeType GetInterpolationMode () const

Static Public Member Functions

static Pointer New ()

Static Public Attributes

static const unsigned int ImageDimension2 = InputImageType::ImageDimension

Protected Member Functions

 DiscreteHessianGaussianImageFunction ()
 DiscreteHessianGaussianImageFunction (const Self &)
void operator= (const Self &)
void PrintSelf (std::ostream &os, Indent indent) const
void RecomputeGaussianKernel ()
 ~DiscreteHessianGaussianImageFunction ()

Private Attributes

InterpolationModeType m_InterpolationMode
KernelArrayType m_KernelArray
double m_MaximumError
unsigned int m_MaximumKernelWidth
bool m_NormalizeAcrossScale
GaussianDerivativeOperatorArrayType m_OperatorArray
OperatorImageFunctionPointer m_OperatorImageFunction
bool m_UseImageSpacing
VarianceArrayType m_Variance

Detailed Description

template<class TInputImage, class TOutput = double>
class itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >

Compute the Hessian Gaussian of an image at a specific location in space by calculating discrete second-order gaussian derivatives. This class is templated over the input image type.

The Initialize() method must be called after setting the parameters and before evaluating the function.

Author:
Ivan Macia, VICOMTech, Spain, http://www.vicomtech.es

This implementation was taken from the Insight Journal paper: http://hdl.handle.net/1926/1290

See also:
NeighborhoodOperator
ImageFunction

Definition at line 46 of file itkDiscreteHessianGaussianImageFunction.h.


Member Typedef Documentation

template<class TInputImage , class TOutput = double>
typedef SmartPointer< const Self > itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::ConstPointer
template<class TInputImage , class TOutput = double>
typedef Superclass::ContinuousIndexType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::ContinuousIndexType
template<class TInputImage , class TOutput = double>
typedef FixedArray< GaussianDerivativeOperatorType, 3 *itkGetStaticConstMacro(ImageDimension2) > itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::GaussianDerivativeOperatorArrayType

Array to store gaussian derivative operators from zero to second order (3*ImageDimension operators)

Definition at line 97 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
typedef itk::GaussianDerivativeOperator< TOutput, itkGetStaticConstMacro(ImageDimension2) > itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::GaussianDerivativeOperatorType

Definition at line 92 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
typedef Superclass::IndexType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::IndexType
template<class TInputImage , class TOutput = double>
typedef Superclass::IndexValueType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::IndexValueType
template<class TInputImage , class TOutput = double>
typedef Superclass::InputImageType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::InputImageType
template<class TInputImage , class TOutput = double>
typedef Superclass::InputPixelType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::InputPixelType
template<class TInputImage , class TOutput = double>
typedef FixedArray< KernelType, itkGetStaticConstMacro(ImageDimension2) * ( itkGetStaticConstMacro(ImageDimension2) + 1 ) / 2 > itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::KernelArrayType

Array to store precomputed N-dimensional kernels for the hessian components

Definition at line 104 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
typedef Neighborhood< TOutput, itkGetStaticConstMacro(ImageDimension2) > itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::KernelType

Definition at line 99 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
typedef OperatorImageFunctionType::Pointer itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::OperatorImageFunctionPointer

Definition at line 110 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
typedef NeighborhoodOperatorImageFunction< InputImageType, TOutput > itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::OperatorImageFunctionType

Image function that performs convolution with the neighborhood operator

Definition at line 109 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
typedef Superclass::OutputType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::OutputType
template<class TInputImage , class TOutput = double>
typedef SmartPointer< Self > itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::Pointer
template<class TInputImage , class TOutput = double>
typedef Superclass::PointType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::PointType
template<class TInputImage , class TOutput = double>
typedef DiscreteHessianGaussianImageFunction itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::Self
template<class TInputImage , class TOutput = double>
typedef ImageFunction< TInputImage, SymmetricSecondRankTensor< TOutput, ::itk::GetImageDimension< TInputImage >::ImageDimension >, TOutput > itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::Superclass
template<class TInputImage , class TOutput = double>
typedef SymmetricSecondRankTensor< TOutput, ::itk::GetImageDimension< TInputImage >::ImageDimension > itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::TensorType

Output type

Definition at line 85 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
typedef FixedArray< double, itkGetStaticConstMacro(ImageDimension2) > itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::VarianceArrayType

Definition at line 88 of file itkDiscreteHessianGaussianImageFunction.h.


Member Enumeration Documentation

template<class TInputImage , class TOutput = double>
enum itk::DiscreteHessianGaussianImageFunction::InterpolationModeType

Interpolation modes

Enumerator:
NearestNeighbourInterpolation 
LinearInterpolation 

Definition at line 113 of file itkDiscreteHessianGaussianImageFunction.h.


Constructor & Destructor Documentation

template<class TInputImage , class TOutput = double>
itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::DiscreteHessianGaussianImageFunction ( ) [protected]
template<class TInputImage , class TOutput = double>
itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::DiscreteHessianGaussianImageFunction ( const Self ) [inline, protected]

Definition at line 198 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::~DiscreteHessianGaussianImageFunction ( ) [inline, protected]

Definition at line 200 of file itkDiscreteHessianGaussianImageFunction.h.


Member Function Documentation

template<class TInputImage , class TOutput = double>
virtual::itk::LightObject::Pointer itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::CreateAnother ( void  ) const [virtual]

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::Object.

template<class TInputImage , class TOutput = double>
virtual OutputType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::Evaluate ( const PointType point) const [virtual]

Evalutate the in the given dimension at specified point

template<class TInputImage , class TOutput = double>
virtual OutputType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::EvaluateAtContinuousIndex ( const ContinuousIndexType index) const [virtual]

Evaluate the function at specified ContinousIndex position

template<class TInputImage , class TOutput = double>
virtual OutputType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::EvaluateAtIndex ( const IndexType index) const [virtual]

Evaluate the function at specified Index position

template<class TInputImage , class TOutput = double>
virtual InterpolationModeType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::GetInterpolationMode ( ) const [virtual]

Set/Get the interpolation mode.

template<class TInputImage , class TOutput = double>
virtual double itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::GetMaximumError ( ) const [virtual]

Set/Get the desired maximum error of the gaussian approximation. Maximum error is the difference between the area under the discrete Gaussian curve and the area under the continuous Gaussian. Maximum error affects the Gaussian operator size. The value is clamped between 0.00001 and 0.99999.

template<class TInputImage , class TOutput = double>
virtual unsigned int itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::GetMaximumKernelWidth ( ) const [virtual]

Set/Get a limit for growth of the kernel. Small maximum error values with large variances will yield very large kernel sizes. This value can be used to truncate a kernel in such instances. A warning will be given on truncation of the kernel.

template<class TInputImage , class TOutput = double>
virtual const char* itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::GetNameOfClass ( ) const [virtual]
template<class TInputImage , class TOutput = double>
virtual bool itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::GetNormalizeAcrossScale ( ) const [virtual]

Set/Get the flag for calculating scale-space normalized derivatives. Normalized derivatives are obtained multiplying by the scale parameter t.

template<class TInputImage , class TOutput = double>
virtual bool itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::GetUseImageSpacing ( ) const [virtual]

Set/Get the flag for using image spacing when calculating derivatives.

template<class TInputImage , class TOutput = double>
virtual const VarianceArrayType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::GetVariance ( ) const [virtual]

Set/Get the variance for the discrete Gaussian kernel. Sets the variance for individual dimensions. The default is 0.0 in each dimension. If UseImageSpacing is true, the units are the physical units of your image. If UseImageSpacing is false then the units are pixels.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::Initialize ( void  ) [inline, virtual]

Initialize the Gaussian kernel. Call this method before evaluating the function. This method MUST be called after any changes to function parameters.

Definition at line 194 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
static Pointer itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::New ( ) [static]

Method for creation through the object factory

Reimplemented from itk::Object.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::NormalizeAcrossScaleOff ( ) [virtual]

Set/Get the flag for calculating scale-space normalized derivatives. Normalized derivatives are obtained multiplying by the scale parameter t.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::NormalizeAcrossScaleOn ( ) [virtual]

Set/Get the flag for calculating scale-space normalized derivatives. Normalized derivatives are obtained multiplying by the scale parameter t.

template<class TInputImage , class TOutput = double>
void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::operator= ( const Self ) [inline, protected]
template<class TInputImage , class TOutput = double>
void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::PrintSelf ( std::ostream &  os,
Indent  indent 
) const [protected, virtual]

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::ImageFunction< TInputImage, SymmetricSecondRankTensor< TOutput,::itk::GetImageDimension< TInputImage >::ImageDimension >, TOutput >.

template<class TInputImage , class TOutput = double>
void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::RecomputeGaussianKernel ( ) [protected]
template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::SetInputImage ( const InputImageType ptr) [virtual]

Set the input image.

Warning:
this method caches BufferedRegion information. If the BufferedRegion has changed, user must call SetInputImage again to update cached values.
template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::SetInterpolationMode ( InterpolationModeType  _arg) [virtual]

Set/Get the interpolation mode.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::SetMaximumError ( double  _arg) [virtual]

Set/Get the desired maximum error of the gaussian approximation. Maximum error is the difference between the area under the discrete Gaussian curve and the area under the continuous Gaussian. Maximum error affects the Gaussian operator size. The value is clamped between 0.00001 and 0.99999.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::SetMaximumKernelWidth ( unsigned int  _arg) [virtual]

Set/Get a limit for growth of the kernel. Small maximum error values with large variances will yield very large kernel sizes. This value can be used to truncate a kernel in such instances. A warning will be given on truncation of the kernel.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::SetNormalizeAcrossScale ( bool  _arg) [virtual]

Set/Get the flag for calculating scale-space normalized derivatives. Normalized derivatives are obtained multiplying by the scale parameter t.

template<class TInputImage , class TOutput = double>
void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::SetSigma ( const double  sigma) [inline]

Convenience method for setting the variance through the standard deviation

Definition at line 145 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::SetUseImageSpacing ( bool  _arg) [virtual]

Set/Get the flag for using image spacing when calculating derivatives.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::SetVariance ( VarianceArrayType  _arg) [virtual]

Set/Get the variance for the discrete Gaussian kernel. Sets the variance for individual dimensions. The default is 0.0 in each dimension. If UseImageSpacing is true, the units are the physical units of your image. If UseImageSpacing is false then the units are pixels.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::SetVariance ( double  data[]) [virtual]

Set/Get the variance for the discrete Gaussian kernel. Sets the variance for individual dimensions. The default is 0.0 in each dimension. If UseImageSpacing is true, the units are the physical units of your image. If UseImageSpacing is false then the units are pixels.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::SetVariance ( double  variance) [inline, virtual]

Convenience method for setting the variance for all dimensions

Definition at line 136 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::UseImageSpacingOff ( ) [virtual]

Set/Get the flag for using image spacing when calculating derivatives.

template<class TInputImage , class TOutput = double>
virtual void itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::UseImageSpacingOn ( ) [virtual]

Set/Get the flag for using image spacing when calculating derivatives.


Member Data Documentation

template<class TInputImage , class TOutput = double>
const unsigned int itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::ImageDimension2 = InputImageType::ImageDimension [static]

Dimension of the underlying image

Definition at line 81 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
InterpolationModeType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::m_InterpolationMode [private]

Interpolation mode

Definition at line 242 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
KernelArrayType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::m_KernelArray [private]

Array of N-dimensional kernels which are the result of convolving the operators for calculating hessian matrix derivatives

Definition at line 230 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
double itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::m_MaximumError [private]

Difference between the areas under the curves of the continuous and discrete Gaussian functions

Definition at line 214 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
unsigned int itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::m_MaximumKernelWidth [private]

Maximum kernel size allowed. This value is used to truncate a kernel that has grown too large. A warning is given when the specified maximum error causes the kernel to exceed this size

Definition at line 219 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
bool itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::m_NormalizeAcrossScale [private]

Flag for scale-space normalization of derivatives

Definition at line 236 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
GaussianDerivativeOperatorArrayType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::m_OperatorArray [mutable, private]

Array of derivative operators, one for each dimension and order. First N zero-order operators are stored, then N first-order and then N second-order making 3*N operators altogether where N=ImageDimension.

Definition at line 225 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
OperatorImageFunctionPointer itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::m_OperatorImageFunction [private]

OperatorImageFunction

Definition at line 233 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
bool itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::m_UseImageSpacing [private]

Flag to indicate whether to use image spacing

Definition at line 239 of file itkDiscreteHessianGaussianImageFunction.h.

template<class TInputImage , class TOutput = double>
VarianceArrayType itk::DiscreteHessianGaussianImageFunction< TInputImage, TOutput >::m_Variance [private]

Desired variance of the discrete Gaussian function

Definition at line 210 of file itkDiscreteHessianGaussianImageFunction.h.


The documentation for this class was generated from the following file: