ITK
4.8.0
Insight Segmentation and Registration Toolkit
|
#include <itkDiscreteGaussianImageFilter.h>
Blurs an image by separable convolution with discrete gaussian kernels. This filter performs Gaussian blurring by separable convolution of an image and a discrete Gaussian operator (kernel).
The Gaussian operator used here was described by Tony Lindeberg (Discrete Scale-Space Theory and the Scale-Space Primal Sketch. Dissertation. Royal Institute of Technology, Stockholm, Sweden. May 1991.) The Gaussian kernel used here was designed so that smoothing and derivative operations commute after discretization.
The variance or standard deviation (sigma) will be evaluated as pixel units if SetUseImageSpacing is off (false) or as physical units if SetUseImageSpacing is on (true, default). The variance can be set independently in each dimension.
When the Gaussian kernel is small, this filter tends to run faster than itk::RecursiveGaussianImageFilter.
Definition at line 62 of file itkDiscreteGaussianImageFilter.h.
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 flag) |
Static Public Member Functions inherited from itk::LightObject | |
static void | BreakOnError () |
static Pointer | New () |
Static Public Attributes | |
static const unsigned int | ImageDimension = TOutputImage::ImageDimension |
Static Public Attributes inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
static const unsigned int | InputImageDimension = TInputImage::ImageDimension |
static const unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
Static Public Attributes inherited from itk::ImageSource< TOutputImage > | |
static const unsigned int | OutputImageDimension = TOutputImage::ImageDimension |
Private Member Functions | |
DiscreteGaussianImageFilter (const Self &) | |
void | operator= (const Self &) |
Private Attributes | |
unsigned int | m_FilterDimensionality |
unsigned int | m_InternalNumberOfStreamDivisions |
ArrayType | m_MaximumError |
int | m_MaximumKernelWidth |
bool | m_UseImageSpacing |
ArrayType | m_Variance |
Additional Inherited Members | |
Protected Types inherited from itk::ImageToImageFilter< TInputImage, TOutputImage > | |
typedef ImageToImageFilterDetail::ImageRegionCopier < itkGetStaticConstMacro(OutputImageDimension), itkGetStaticConstMacro(InputImageDimension) > | InputToOutputRegionCopierType |
typedef ImageToImageFilterDetail::ImageRegionCopier < itkGetStaticConstMacro(InputImageDimension), itkGetStaticConstMacro(OutputImageDimension) > | OutputToInputRegionCopierType |
Static Protected Member Functions inherited from itk::ImageSource< TOutputImage > | |
static const ImageRegionSplitterBase * | GetGlobalDefaultSplitter () |
static ITK_THREAD_RETURN_TYPE | ThreaderCallback (void *arg) |
Protected Attributes inherited from itk::ProcessObject | |
TimeStamp | m_OutputInformationMTime |
bool | m_Updating |
Protected Attributes inherited from itk::LightObject | |
AtomicInt< int > | m_ReferenceCount |
typedef FixedArray< double, itkGetStaticConstMacro(ImageDimension) > itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::ArrayType |
Typedef of double containers
Definition at line 99 of file itkDiscreteGaussianImageFilter.h.
typedef SmartPointer< const Self > itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::ConstPointer |
Definition at line 70 of file itkDiscreteGaussianImageFilter.h.
typedef TInputImage itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::InputImageType |
Image type information.
Definition at line 76 of file itkDiscreteGaussianImageFilter.h.
typedef TInputImage::InternalPixelType itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::InputInternalPixelType |
Definition at line 87 of file itkDiscreteGaussianImageFilter.h.
typedef TInputImage::PixelType itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::InputPixelType |
Definition at line 86 of file itkDiscreteGaussianImageFilter.h.
typedef NumericTraits<InputPixelType>::ValueType itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::InputPixelValueType |
Pixel value type for Vector pixel types
Definition at line 90 of file itkDiscreteGaussianImageFilter.h.
typedef TOutputImage itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::OutputImageType |
Definition at line 80 of file itkDiscreteGaussianImageFilter.h.
typedef TOutputImage::InternalPixelType itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::OutputInternalPixelType |
Definition at line 85 of file itkDiscreteGaussianImageFilter.h.
typedef TOutputImage::PixelType itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::OutputPixelType |
Extract some information from the image types. Dimensionality of the two images is assumed to be the same.
Definition at line 84 of file itkDiscreteGaussianImageFilter.h.
typedef NumericTraits<OutputPixelType>::ValueType itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::OutputPixelValueType |
Definition at line 91 of file itkDiscreteGaussianImageFilter.h.
typedef SmartPointer< Self > itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::Pointer |
Definition at line 69 of file itkDiscreteGaussianImageFilter.h.
typedef DiscreteGaussianImageFilter itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::Self |
Standard class typedefs.
Definition at line 67 of file itkDiscreteGaussianImageFilter.h.
typedef ImageToImageFilter< TInputImage, TOutputImage > itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::Superclass |
Definition at line 68 of file itkDiscreteGaussianImageFilter.h.
|
inlineprotected |
Definition at line 239 of file itkDiscreteGaussianImageFilter.h.
References itk::FixedArray< TValue, VLength >::Fill(), itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::ImageDimension, itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::m_FilterDimensionality, itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::m_InternalNumberOfStreamDivisions, itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::m_MaximumError, itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::m_MaximumKernelWidth, itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::m_UseImageSpacing, and itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::m_Variance.
|
inlineprotectedvirtual |
Definition at line 249 of file itkDiscreteGaussianImageFilter.h.
|
private |
|
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.
Reimplemented in itk::GPUDiscreteGaussianImageFilter< TInputImage, TOutputImage >, and itk::GPUImageToImageFilter< TInputImage, TOutputImage, DiscreteGaussianImageFilter< TInputImage, TOutputImage > >.
|
overrideprotectedvirtual |
Standard pipeline method. While this class does not implement a ThreadedGenerateData(), its GenerateData() delegates all calculations to an NeighborhoodOperatorImageFilter. Since the NeighborhoodOperatorImageFilter is multithreaded, this filter is multithreaded by default.
Reimplemented from itk::ImageSource< TOutputImage >.
Reimplemented in itk::GPUImageToImageFilter< TInputImage, TOutputImage, DiscreteGaussianImageFilter< TInputImage, TOutputImage > >.
|
overridevirtual |
DiscreteGaussianImageFilter needs a larger input requested region than the output requested region (larger by the size of the Gaussian kernel). As such, DiscreteGaussianImageFilter needs to provide an implementation for GenerateInputRequestedRegion() in order to inform the pipeline execution model.
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Reimplemented in itk::GPUDiscreteGaussianImageFilter< TInputImage, TOutputImage >.
|
virtual |
Set the number of dimensions to smooth. Defaults to the image dimension. Can be set to less than ImageDimension, smoothing all the dimensions less than FilterDimensionality. For instance, to smooth the slices of a volume without smoothing in Z, set the FilterDimensionality to 2.
|
virtual |
|
virtual |
The algorithm will size the discrete kernel so that the error resulting from truncation of the kernel is no greater than MaximumError. The default is 0.01 in each dimension.
|
virtual |
Set the kernel to be no wider than MaximumKernelWidth pixels, even if MaximumError demands it. The default is 32 pixels.
|
virtual |
Run-time type information (and related methods).
Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.
Reimplemented in itk::GPUDiscreteGaussianImageFilter< TInputImage, TOutputImage >, and itk::GPUImageToImageFilter< TInputImage, TOutputImage, DiscreteGaussianImageFilter< TInputImage, TOutputImage > >.
|
virtual |
Set/Get whether or not the filter will use the spacing of the input image in its calculations
|
virtual |
The variance for the discrete Gaussian kernel. Sets the variance independently for each dimension, but see also SetVariance(const double v). 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.
|
static |
Method for creation through the object factory.
|
private |
|
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::ImageToImageFilter< TInputImage, TOutputImage >.
Reimplemented in itk::GPUDiscreteGaussianImageFilter< TInputImage, TOutputImage >, and itk::GPUImageToImageFilter< TInputImage, TOutputImage, DiscreteGaussianImageFilter< TInputImage, TOutputImage > >.
|
virtual |
Set the number of dimensions to smooth. Defaults to the image dimension. Can be set to less than ImageDimension, smoothing all the dimensions less than FilterDimensionality. For instance, to smooth the slices of a volume without smoothing in Z, set the FilterDimensionality to 2.
|
virtual |
Set/Get number of pieces to divide the input for the internal composite pipeline. The upstream pipeline will not be effected.
The default value is $ImageDimension^2$.
This parameter was introduced to reduce the memory used by images internally, at the cost of performance.
|
virtual |
The algorithm will size the discrete kernel so that the error resulting from truncation of the kernel is no greater than MaximumError. The default is 0.01 in each dimension.
Referenced by itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetMaximumError().
|
inline |
Definition at line 142 of file itkDiscreteGaussianImageFilter.h.
References itk::FixedArray< TValue, VLength >::Fill(), itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::m_MaximumError, and itk::Object::Modified().
|
inline |
Definition at line 170 of file itkDiscreteGaussianImageFilter.h.
References itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::ImageDimension, and itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetMaximumError().
|
inline |
Definition at line 181 of file itkDiscreteGaussianImageFilter.h.
References itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::ImageDimension, and itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetMaximumError().
|
virtual |
Set the kernel to be no wider than MaximumKernelWidth pixels, even if MaximumError demands it. The default is 32 pixels.
|
virtual |
Set/Get whether or not the filter will use the spacing of the input image in its calculations
Referenced by itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetUseImageSpacingOff(), and itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetUseImageSpacingOn().
|
inline |
Ignore the image spacing. Use this option if you want to specify Gaussian variance in pixels. Default is ImageSpacingOn.
Definition at line 200 of file itkDiscreteGaussianImageFilter.h.
References itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetUseImageSpacing().
|
inline |
Use the image spacing information in calculations. Use this option if you want to specify Gaussian variance in real world units. Default is ImageSpacingOn.
Definition at line 195 of file itkDiscreteGaussianImageFilter.h.
References itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetUseImageSpacing().
|
virtual |
The variance for the discrete Gaussian kernel. Sets the variance independently for each dimension, but see also SetVariance(const double v). 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.
Referenced by itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetVariance().
|
inline |
Convenience Set methods for setting all dimensional parameters to the same values.
Definition at line 135 of file itkDiscreteGaussianImageFilter.h.
References itk::FixedArray< TValue, VLength >::Fill(), itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::m_Variance, and itk::Object::Modified().
|
inline |
Definition at line 148 of file itkDiscreteGaussianImageFilter.h.
References itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::ImageDimension, and itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetVariance().
|
inline |
Definition at line 159 of file itkDiscreteGaussianImageFilter.h.
References itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::ImageDimension, and itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetVariance().
itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::typedef | ( | Concept::HasNumericTraits< OutputPixelValueType > | ) |
This class requires OutputHasNumericTraitsCheck in the form of ( Concept::HasNumericTraits< OutputPixelValueType > )
|
static |
Extract some information from the image types. Dimensionality of the two images is assumed to be the same.
Definition at line 96 of file itkDiscreteGaussianImageFilter.h.
Referenced by itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::DiscreteGaussianImageFilter(), itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetMaximumError(), and itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetVariance().
|
private |
Number of dimensions to process. Default is all dimensions
Definition at line 277 of file itkDiscreteGaussianImageFilter.h.
Referenced by itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::DiscreteGaussianImageFilter().
|
private |
Number of pieces to divide the input on the internal composite pipeline. The upstream pipeline will not be effected.
Definition at line 284 of file itkDiscreteGaussianImageFilter.h.
Referenced by itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::DiscreteGaussianImageFilter().
|
private |
The maximum error of the gaussian blurring kernel in each dimensional direction. For definition of maximum error, see GaussianOperator.
Definition at line 270 of file itkDiscreteGaussianImageFilter.h.
Referenced by itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::DiscreteGaussianImageFilter(), and itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetMaximumError().
|
private |
Maximum allowed kernel width for any dimension of the discrete Gaussian approximation
Definition at line 274 of file itkDiscreteGaussianImageFilter.h.
Referenced by itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::DiscreteGaussianImageFilter().
|
private |
Flag to indicate whether to use image spacing
Definition at line 280 of file itkDiscreteGaussianImageFilter.h.
Referenced by itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::DiscreteGaussianImageFilter().
|
private |
The variance of the gaussian blurring kernel in each dimensional direction.
Definition at line 265 of file itkDiscreteGaussianImageFilter.h.
Referenced by itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::DiscreteGaussianImageFilter(), and itk::DiscreteGaussianImageFilter< TInputImage, TOutputImage >::SetVariance().