ITK
5.0.0
Insight Segmentation and Registration Toolkit
|
#include <itkGaussianOperator.h>
A NeighborhoodOperator whose coefficients are a one dimensional, discrete Gaussian kernel.
GaussianOperator can be used to perform Gaussian blurring by taking its inner product with a Neighborhood (NeighborhoodIterator) that is swept across an image region. It is a directional operator. N successive applications oriented along each dimensional direction will effect separable, efficient, N-D Gaussian blurring of an image region.
GaussianOperator takes two parameters:
(1) The floating-point variance of the desired Gaussian function.
(2) 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.).
Definition at line 67 of file itkGaussianOperator.h.
Public Types | |
using | Self = GaussianOperator |
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 > |
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 () |
Private Attributes | |
double | m_MaximumError {.01} |
unsigned int | m_MaximumKernelWidth {30} |
double | m_Variance {1} |
Additional Inherited Members | |
Static Public Attributes inherited from itk::Neighborhood< TPixel, VDimension, TAllocator > | |
static constexpr unsigned int | NeighborhoodDimension = VDimension |
|
protected |
Definition at line 159 of file itkGaussianOperator.h.
using itk::GaussianOperator< TPixel, VDimension, TAllocator >::Self = GaussianOperator |
Standard class type aliases.
Definition at line 73 of file itkGaussianOperator.h.
using itk::GaussianOperator< TPixel, VDimension, TAllocator >::Superclass = NeighborhoodOperator< TPixel, VDimension, TAllocator > |
Definition at line 74 of file itkGaussianOperator.h.
|
inline |
Constructor.
Definition at line 79 of file itkGaussianOperator.h.
|
inline |
Copy constructor
Definition at line 82 of file itkGaussianOperator.h.
|
inlineoverrideprotected |
Arranges coefficients spatially in the memory buffer.
Definition at line 179 of file itkGaussianOperator.h.
|
overrideprotectedvirtual |
Calculates operator coefficients.
Implements itk::NeighborhoodOperator< TPixel, VDimension, TAllocator >.
|
inline |
Returns the 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.
Definition at line 133 of file itkGaussianOperator.h.
|
inline |
Returns the maximum allowed kernel width.
Definition at line 144 of file itkGaussianOperator.h.
|
virtual |
Reimplemented from itk::NeighborhoodOperator< TPixel, VDimension, TAllocator >.
|
inline |
Returns the variance of the Gaussian (scale) for the operator.
Definition at line 126 of file itkGaussianOperator.h.
double itk::GaussianOperator< TPixel, VDimension, TAllocator >::ModifiedBesselI | ( | int | , |
double | |||
) |
Returns the value of the modified Bessel function Ik(x) at a point x>=0, where k>=2.
double itk::GaussianOperator< TPixel, VDimension, TAllocator >::ModifiedBesselI0 | ( | double | ) |
Returns the value of the modified Bessel function I0(x) at a point x >= 0.
double itk::GaussianOperator< TPixel, VDimension, TAllocator >::ModifiedBesselI1 | ( | double | ) |
Returns the value of the modified Bessel function I1(x) at a point x, x real.
|
inline |
Assignment operator
Definition at line 92 of file itkGaussianOperator.h.
|
inlineoverridevirtual |
Prints some debugging information.
Reimplemented from itk::Neighborhood< TPixel, VDimension, TAllocator >.
Definition at line 148 of file itkGaussianOperator.h.
|
inline |
Sets 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 must be between 0.0 and 1.0.
Definition at line 115 of file itkGaussianOperator.h.
|
inline |
Sets 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.
Definition at line 140 of file itkGaussianOperator.h.
|
inline |
Sets the desired variance of the Gaussian kernel.
Definition at line 106 of file itkGaussianOperator.h.
|
private |
Difference between the areas under the curves of the continuous and discrete Gaussian functions.
Definition at line 188 of file itkGaussianOperator.h.
Referenced by itk::GaussianOperator< ScalarType, Superclass::Dimension >::GaussianOperator(), and itk::GaussianOperator< ScalarType, Superclass::Dimension >::operator=().
|
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 193 of file itkGaussianOperator.h.
Referenced by itk::GaussianOperator< ScalarType, Superclass::Dimension >::GaussianOperator(), and itk::GaussianOperator< ScalarType, Superclass::Dimension >::operator=().
|
private |
Desired variance of the discrete Gaussian function.
Definition at line 184 of file itkGaussianOperator.h.
Referenced by itk::GaussianOperator< ScalarType, Superclass::Dimension >::GaussianOperator(), and itk::GaussianOperator< ScalarType, Superclass::Dimension >::operator=().