#include <itkGaussianDerivativeOperator.h>

Inheritance diagram for itk::GaussianDerivativeOperator< TPixel, VDimension, TAllocator >:

Collaboration diagram for itk::GaussianDerivativeOperator< TPixel, VDimension, TAllocator >:

Detailed Description

template<typename TPixel, unsigned int VDimension = 2, typename TAllocator = NeighborhoodAllocator< TPixel >>
class itk::GaussianDerivativeOperator< TPixel, VDimension, TAllocator >

A NeighborhoodOperator whose coefficients are a one dimensional, discrete derivative Gaussian kernel.

GaussianDerivativeOperator can be used to calculate Gaussian derivatives by taking its inner product with to a Neighborhood (NeighborhooIterator) that is swept across an image region. It is a directional operator. N successive applications oriented along each dimensional direction will calculate separable, efficient, N-D Gaussian derivatives of an image region.

GaussianDerivativeOperator takes three parameters:

(1) The floating-point variance of the desired Gaussian function.

(2) The order of the derivative to be calculated (zero order means it performs only smoothing as a standard itk::GaussianOperator)

(3) The "maximum error" allowed in the discrete Gaussian function. "Maximum errror" is defined as the difference between the area under the discrete Gaussian curve and the area under the continuous Gaussian. Maximum error affects the Gaussian operator size. Care should be taken not to make this value too small relative to the variance lest the operator size become unreasonably large.

References: The Gaussian kernel contained in this operator was described by Tony Lindeberg (Discrete Scale-Space Theory and the Scale-Space Primal Sketch. Dissertation. Royal Institute of Technology, Stockholm, Sweden. May 1991.).

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

This implementation is derived from the Insight Journal paper: https://hdl.handle.net/1926/1290

See Also: GaussianOperator; NeighborhoodOperator; NeighborhoodIterator; Neighborhood

Wiki Examples:

Examples:: WikiExamples/Operators/GaussianDerivativeOperator.cxx.

Definition at line 79 of file itkGaussianDerivativeOperator.h.

Public Types
using	DerivativeOperatorType = DerivativeOperator< TPixel, VDimension, TAllocator >

using	GaussianOperatorType = GaussianOperator< TPixel, VDimension, TAllocator >

using	Self = GaussianDerivativeOperator

using	Superclass = NeighborhoodOperator< TPixel, VDimension, TAllocator >

Public Types inherited from itk::NeighborhoodOperator< TPixel, VDimension, TAllocator >
using	PixelRealType = typename NumericTraits< TPixel >::RealType

using	PixelType = TPixel

using	Self = NeighborhoodOperator

using	SizeType = typename Superclass::SizeType

using	SliceIteratorType = SliceIterator< TPixel, Self >

using	Superclass = Neighborhood< TPixel, VDimension, TAllocator >

Public Types inherited from itk::Neighborhood< TPixel, VDimension, TAllocator >
using	AllocatorType = TAllocator

using	ConstIterator = typename AllocatorType::const_iterator

using	DimensionValueType = unsigned int

using	Iterator = typename AllocatorType::iterator

using	NeighborIndexType = SizeValueType

using	OffsetType = Offset< VDimension >

using	PixelType = TPixel

using	RadiusType = ::itk::Size< VDimension >

using	Self = Neighborhood

using	SizeType = ::itk::Size< VDimension >

using	SizeValueType = typename SizeType::SizeValueType

using	SliceIteratorType = SliceIterator< TPixel, Self >

Public Member Functions
	GaussianDerivativeOperator ()=default

	GaussianDerivativeOperator (const Self &other)

double	GetMaximumError ()

Self &	operator= (const Self &other)

void	PrintSelf (std::ostream &os, Indent i) const override

void	SetMaximumError (const double maxerror)

void	SetMaximumKernelWidth (unsigned int n)


void	SetNormalizeAcrossScale (bool flag)

bool	GetNormalizeAcrossScale () const

virtual void	NormalizeAcrossScaleOn ()

virtual void	NormalizeAcrossScaleOff ()


void	SetVariance (const double variance)

double	GetVariance () const


void	SetSpacing (const double spacing)

double	GetSpacing () const


void	SetOrder (const unsigned int order)

unsigned int	GetOrder () const

Public Member Functions inherited from itk::NeighborhoodOperator< TPixel, VDimension, TAllocator >
virtual void	CreateDirectional ()

virtual void	CreateToRadius (const SizeType &)

virtual void	CreateToRadius (const SizeValueType)

virtual void	FlipAxes ()

unsigned long	GetDirection () const

	NeighborhoodOperator ()

	NeighborhoodOperator (const Self &orig)

void	ScaleCoefficients (PixelRealType)

void	SetDirection (const unsigned long &direction)

Self &	operator= (const Self &orig)

void	PrintSelf (std::ostream &os, Indent i) const override

Public Member Functions inherited from itk::Neighborhood< TPixel, VDimension, TAllocator >
NeighborIndexType	GetCenterNeighborhoodIndex () const

TPixel	GetCenterValue () const

virtual NeighborIndexType	GetNeighborhoodIndex (const OffsetType &) const

OffsetType	GetOffset (NeighborIndexType i) const

const SizeType	GetRadius () const

SizeValueType	GetRadius (DimensionValueType n) const

SizeValueType	GetSize (DimensionValueType n) const

SizeType	GetSize () const

std::slice	GetSlice (unsigned int) const

OffsetValueType	GetStride (DimensionValueType axis) const

	itkTypeMacroNoParent (Neighborhood)

	Neighborhood (const Self &other)

	Neighborhood (Self &&)=default

bool	operator!= (const Self &other) const

Self &	operator= (const Self &other)

Self &	operator= (Self &&)=default

bool	operator== (const Self &other) const

void	Print (std::ostream &os) const

void	SetRadius (const SizeType &)

void	SetRadius (const SizeValueType)

NeighborIndexType	Size () const

virtual	~Neighborhood ()=default

	Neighborhood ()

Iterator	End ()

Iterator	Begin ()

ConstIterator	End () const

ConstIterator	Begin () const

TPixel &	operator[] (NeighborIndexType i)

const TPixel &	operator[] (NeighborIndexType i) const

TPixel &	GetElement (NeighborIndexType i)

void	SetRadius (const SizeValueType *rad)

AllocatorType &	GetBufferReference ()

const AllocatorType &	GetBufferReference () const

TPixel &	operator[] (const OffsetType &o)

const TPixel &	operator[] (const OffsetType &o) const

Protected Types
using	CoefficientVector = typename Superclass::CoefficientVector

Protected Types inherited from itk::NeighborhoodOperator< TPixel, VDimension, TAllocator >
using	CoefficientVector = std::vector< PixelRealType >

Protected Member Functions
void	Fill (const CoefficientVector &coeff) override

CoefficientVector	GenerateCoefficients () override

Protected Member Functions inherited from itk::NeighborhoodOperator< TPixel, VDimension, TAllocator >
virtual void	Fill (const CoefficientVector &)=0

virtual void	FillCenteredDirectional (const CoefficientVector &)

void	InitializeToZero ()

Protected Member Functions inherited from itk::Neighborhood< TPixel, VDimension, TAllocator >
virtual void	Allocate (NeighborIndexType i)

virtual void	ComputeNeighborhoodOffsetTable ()

virtual void	ComputeNeighborhoodStrideTable ()

void	SetSize ()

Static Protected Member Functions
static double	ModifiedBesselI (int, double)

static double	ModifiedBesselI0 (double)

static double	ModifiedBesselI1 (double)

Private Member Functions
CoefficientVector	GenerateGaussianCoefficients () const

const char *	GetNameOfClass () const override

Private Attributes
double	m_MaximumError {0.005}

unsigned int	m_MaximumKernelWidth {30}

bool	m_NormalizeAcrossScale {true}

unsigned int	m_Order {1}

double	m_Spacing {1.0}

double	m_Variance {1.0}

Additional Inherited Members
Static Public Attributes inherited from itk::Neighborhood< TPixel, VDimension, TAllocator >
static constexpr unsigned int	NeighborhoodDimension = VDimension