itk::BilateralImageFilter< TInputImage, TOutputImage > Class Template Reference
[Image Enhancement Filters, Image Feature Extraction Filters]

Blurs an image while preserving edges. More...

#include <itkBilateralImageFilter.h>

Inheritance diagram for itk::BilateralImageFilter< TInputImage, TOutputImage >:

[legend]Collaboration diagram for itk::BilateralImageFilter< TInputImage, TOutputImage >:

[legend]List of all members.

[NOHEADER]
	BilateralImageFilter ()
virtual	~BilateralImageFilter ()
void	PrintSelf (std::ostream &os, Indent indent) const
void	BeforeThreadedGenerateData ()
void	ThreadedGenerateData (const OutputImageRegionType &outputRegionForThread, int threadId)
virtual void	GenerateInputRequestedRegion () throw (InvalidRequestedRegionError)
Public Types
typedef BilateralImageFilter	Self
typedef ImageToImageFilter< TInputImage, TOutputImage >	Superclass
typedef SmartPointer< Self >	Pointer
typedef SmartPointer< const Self >	ConstPointer
typedef TInputImage	InputImageType
typedef TOutputImage	OutputImageType
typedef Superclass::OutputImageRegionType	OutputImageRegionType
typedef TOutputImage::PixelType	OutputPixelType
typedef TOutputImage::InternalPixelType	OutputInternalPixelType
typedef NumericTraits< OutputPixelType >::RealType	OutputPixelRealType
typedef TInputImage::PixelType	InputPixelType
typedef TInputImage::InternalPixelType	InputInternalPixelType
typedef ConstNeighborhoodIterator< TInputImage >	NeighborhoodIteratorType
typedef Neighborhood< double, itkGetStaticConstMacro(ImageDimension)	KernelType )
typedef KernelType::Iterator	KernelIteratorType
typedef KernelType::ConstIterator	KernelConstIteratorType
typedef Image< double, itkGetStaticConstMacro(ImageDimension)	GaussianImageType )
Public Member Functions
virtual const char *	GetClassName () const
	itkStaticConstMacro (ImageDimension, unsigned int, TOutputImage::ImageDimension)
virtual void	SetDomainSigma (double data[])
virtual void	SetDomainSigma (float data[])
virtual const double *	GetDomainSigma () const
virtual void	SetRangeSigma (double _arg)
virtual double	GetRangeSigma ()
virtual unsigned int	GetFilterDimensionality ()
virtual void	SetFilterDimensionality (unsigned int _arg)
void	SetDomainSigma (const double v)
void	SetDomainSigma (const float v)
virtual void	SetNumberOfRangeGaussianSamples (unsigned long _arg)
virtual unsigned long	GetNumberOfRangeGaussianSamples ()
Static Public Member Functions
Pointer	New ()

---

Detailed Description

template<class TInputImage, class TOutputImage>
class itk::BilateralImageFilter< TInputImage, TOutputImage >

Blurs an image while preserving edges.

This filter uses bilateral filtering to blur an image using both domain and range "neighborhoods". Pixels that are close to a pixel in the image domain and similar to a pixel in the image range are used to calculate the filtered value. Two gaussian kernels (one in the image domain and one in the image range) are used to smooth the image. The result is an image that is smoothed in homogeneous regions yet has edges preserved. The result is similar to anisotropic diffusion but the implementation in non-iterative. Another benefit to bilateral filtering is that any distance metric can be used for kernel smoothing the image range. Hence, color images can be smoothed as vector images, using the CIE distances between intensity values as the similarity metric (the Gaussian kernel for the image domain is evaluated using CIE distances). A separate version of this filter will be designed for color and vector images.

Bilateral filtering is capable of reducing the noise in an image by an order of magnitude while maintaining edges.

The bilateral operator used here was described by Tomasi and Manduchi (Bilateral Filtering for Gray and ColorImages. IEEE ICCV. 1998.)

See also:

GaussianOperator

AnisotropicDiffusionImageFilter

Image

Neighborhood

NeighborhoodOperator

Todo:

Support color images

Support vector images

Definition at line 68 of file itkBilateralImageFilter.h.

---

Member Typedef Documentation

template<class TInputImage, class TOutputImage> typedef SmartPointer<const Self> itk::BilateralImageFilter< TInputImage, TOutputImage >::ConstPointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 76 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef Image<double, itkGetStaticConstMacro(ImageDimension) itk::BilateralImageFilter< TInputImage, TOutputImage >::GaussianImageType)

Gaussian image type Definition at line 118 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef TInputImage itk::BilateralImageFilter< TInputImage, TOutputImage >::InputImageType

Image type information. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 85 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef TInputImage::InternalPixelType itk::BilateralImageFilter< TInputImage, TOutputImage >::InputInternalPixelType

Definition at line 97 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef TInputImage::PixelType itk::BilateralImageFilter< TInputImage, TOutputImage >::InputPixelType

Definition at line 96 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef KernelType::ConstIterator itk::BilateralImageFilter< TInputImage, TOutputImage >::KernelConstIteratorType

Definition at line 114 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef KernelType::Iterator itk::BilateralImageFilter< TInputImage, TOutputImage >::KernelIteratorType

Kernel iterator. Definition at line 113 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef Neighborhood<double, itkGetStaticConstMacro(ImageDimension) itk::BilateralImageFilter< TInputImage, TOutputImage >::KernelType)

Kernel typedef. Definition at line 110 of file itkBilateralImageFilter.h. Referenced by itk::BilateralImageFilter< TInputImage, TOutputImage >::~BilateralImageFilter().

template<class TInputImage, class TOutputImage> typedef ConstNeighborhoodIterator<TInputImage> itk::BilateralImageFilter< TInputImage, TOutputImage >::NeighborhoodIteratorType

Neighborhood iterator types. Definition at line 106 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef Superclass::OutputImageRegionType itk::BilateralImageFilter< TInputImage, TOutputImage >::OutputImageRegionType

Superclass typedefs. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 89 of file itkBilateralImageFilter.h. Referenced by itk::BilateralImageFilter< TInputImage, TOutputImage >::~BilateralImageFilter().

template<class TInputImage, class TOutputImage> typedef TOutputImage itk::BilateralImageFilter< TInputImage, TOutputImage >::OutputImageType

Some convenient typedefs. Reimplemented from itk::ImageSource< TOutputImage >. Definition at line 86 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef TOutputImage::InternalPixelType itk::BilateralImageFilter< TInputImage, TOutputImage >::OutputInternalPixelType

Definition at line 94 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef NumericTraits<OutputPixelType>::RealType itk::BilateralImageFilter< TInputImage, TOutputImage >::OutputPixelRealType

Definition at line 95 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef TOutputImage::PixelType itk::BilateralImageFilter< TInputImage, TOutputImage >::OutputPixelType

Extract some information from the image types. Dimensionality of the two images is assumed to be the same. Definition at line 93 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef SmartPointer<Self> itk::BilateralImageFilter< TInputImage, TOutputImage >::Pointer

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 75 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> typedef BilateralImageFilter itk::BilateralImageFilter< TInputImage, TOutputImage >::Self

Standard class typedefs. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 73 of file itkBilateralImageFilter.h. Referenced by itk::BilateralImageFilter< TInputImage, TOutputImage >::~BilateralImageFilter().

template<class TInputImage, class TOutputImage> typedef ImageToImageFilter< TInputImage, TOutputImage > itk::BilateralImageFilter< TInputImage, TOutputImage >::Superclass

Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >. Definition at line 74 of file itkBilateralImageFilter.h.

---

Constructor & Destructor Documentation

template<class TInputImage, class TOutputImage> itk::BilateralImageFilter< TInputImage, TOutputImage >::BilateralImageFilter (   )  [inline, protected]

Constructor. Default value for DomainSigma is 4. Default value RangeSigma is 50. Definition at line 162 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> virtual itk::BilateralImageFilter< TInputImage, TOutputImage >::~BilateralImageFilter (   )  [inline, protected, virtual]

Constructor. Default value for DomainSigma is 4. Default value RangeSigma is 50. Definition at line 180 of file itkBilateralImageFilter.h. References itk::BilateralImageFilter< TInputImage, TOutputImage >::KernelType, itk::BilateralImageFilter< TInputImage, TOutputImage >::OutputImageRegionType, and itk::BilateralImageFilter< TInputImage, TOutputImage >::Self.

---

Member Function Documentation

template<class TInputImage, class TOutputImage> void itk::BilateralImageFilter< TInputImage, TOutputImage >::BeforeThreadedGenerateData (   )  [protected, virtual]

Do some setup before the ThreadedGenerateData Reimplemented from itk::ImageSource< TOutputImage >.

template<class TInputImage, class TOutputImage> virtual void itk::BilateralImageFilter< TInputImage, TOutputImage >::GenerateInputRequestedRegion (   )  throw (InvalidRequestedRegionError) [protected, virtual]

BilateralImageFilter needs a larger input requested region than the output requested region (larger by the size of the domain Gaussian kernel). As such, BilateralImageFilter needs to provide an implementation for GenerateInputRequestedRegion() in order to inform the pipeline execution model. See also: ImageToImageFilter::GenerateInputRequestedRegion() Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage> virtual const char* itk::BilateralImageFilter< TInputImage, TOutputImage >::GetClassName (   )  const [virtual]

Run-time type information (and related methods). Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage> virtual const double* itk::BilateralImageFilter< TInputImage, TOutputImage >::GetDomainSigma (   )  const [virtual]

Standard get/set macros for filter parameters. DomainSigma is specified in the same units as the Image spacing. RangeSigma is specified in the units of intensity.

template<class TInputImage, class TOutputImage> virtual unsigned int itk::BilateralImageFilter< TInputImage, TOutputImage >::GetFilterDimensionality (   )  [virtual]

Standard get/set macros for filter parameters. DomainSigma is specified in the same units as the Image spacing. RangeSigma is specified in the units of intensity.

template<class TInputImage, class TOutputImage> virtual unsigned long itk::BilateralImageFilter< TInputImage, TOutputImage >::GetNumberOfRangeGaussianSamples (   )  [virtual]

Set/Get the number of samples in the approximation to the Gaussian used for the range smoothing. Samples are only generated in the range of [0, 4*m_RangeSigma]. Default is 100.

template<class TInputImage, class TOutputImage> virtual double itk::BilateralImageFilter< TInputImage, TOutputImage >::GetRangeSigma (   )  [virtual]

Standard get/set macros for filter parameters. DomainSigma is specified in the same units as the Image spacing. RangeSigma is specified in the units of intensity.

template<class TInputImage, class TOutputImage> itk::BilateralImageFilter< TInputImage, TOutputImage >::itkStaticConstMacro (  ImageDimension  , unsigned  int, TOutputImage::ImageDimension  )

Extract some information from the image types. Dimensionality of the two images is assumed to be the same.

template<class TInputImage, class TOutputImage> Pointer itk::BilateralImageFilter< TInputImage, TOutputImage >::New (   )  [static]

Method for creation through the object factory. Reimplemented from itk::Object.

template<class TInputImage, class TOutputImage> void itk::BilateralImageFilter< TInputImage, TOutputImage >::PrintSelf (  std::ostream &  os, Indent  indent )  const [protected, virtual]

Constructor. Default value for DomainSigma is 4. Default value RangeSigma is 50. Reimplemented from itk::ImageToImageFilter< TInputImage, TOutputImage >.

template<class TInputImage, class TOutputImage> void itk::BilateralImageFilter< TInputImage, TOutputImage >::SetDomainSigma (  const float  v  )  [inline]

Convenience get/set methods for setting all domain parameters to the same values. Definition at line 144 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> void itk::BilateralImageFilter< TInputImage, TOutputImage >::SetDomainSigma (  const double  v  )  [inline]

Convenience get/set methods for setting all domain parameters to the same values. Definition at line 134 of file itkBilateralImageFilter.h.

template<class TInputImage, class TOutputImage> virtual void itk::BilateralImageFilter< TInputImage, TOutputImage >::SetDomainSigma (  float  data[]  )  [virtual]

Standard get/set macros for filter parameters. DomainSigma is specified in the same units as the Image spacing. RangeSigma is specified in the units of intensity.

template<class TInputImage, class TOutputImage> virtual void itk::BilateralImageFilter< TInputImage, TOutputImage >::SetDomainSigma (  double  data[]  )  [virtual]

Standard get/set macros for filter parameters. DomainSigma is specified in the same units as the Image spacing. RangeSigma is specified in the units of intensity.

template<class TInputImage, class TOutputImage> virtual void itk::BilateralImageFilter< TInputImage, TOutputImage >::SetFilterDimensionality (  unsigned int  _arg  )  [virtual]

Standard get/set macros for filter parameters. DomainSigma is specified in the same units as the Image spacing. RangeSigma is specified in the units of intensity.

template<class TInputImage, class TOutputImage> virtual void itk::BilateralImageFilter< TInputImage, TOutputImage >::SetNumberOfRangeGaussianSamples (  unsigned long  _arg  )  [virtual]

Set/Get the number of samples in the approximation to the Gaussian used for the range smoothing. Samples are only generated in the range of [0, 4*m_RangeSigma]. Default is 100.

template<class TInputImage, class TOutputImage> virtual void itk::BilateralImageFilter< TInputImage, TOutputImage >::SetRangeSigma (  double  _arg  )  [virtual]

Standard get/set macros for filter parameters. DomainSigma is specified in the same units as the Image spacing. RangeSigma is specified in the units of intensity.

template<class TInputImage, class TOutputImage> void itk::BilateralImageFilter< TInputImage, TOutputImage >::ThreadedGenerateData (  const OutputImageRegionType &  outputRegionForThread, int  threadId )  [protected, virtual]

Standard pipeline method. This filter is implemented as a multi-threaded filter. Reimplemented from itk::ImageSource< TOutputImage >.

---

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

• itkBilateralImageFilter.h

---