itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage > Class Template Reference

This class implements a detail enhancing filter by making use of the 4th-order level set isotropic diffusion (smoothing) PDE. More...

#include <itkUnsharpMaskLevelSetImageFilter.h>

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

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

[legend]List of all members.

Public Types
typedef UnsharpMaskLevelSetImageFilter	Self
typedef SparseFieldFourthOrderLevelSetImageFilter< TInputImage, TOutputImage >	Superclass
typedef SmartPointer< Self >	Pointer
typedef SmartPointer< const Self >	ConstPointer
typedef Superclass::SparseImageType	SparseImageType
typedef LevelSetFunctionWithRefitTerm< TOutputImage, SparseImageType >	FunctionType
typedef FunctionType::RadiusType	RadiusType
Public Member Functions
virtual const char *	GetNameOfClass () const
virtual unsigned int	GetMaxFilterIteration ()
virtual void	SetMaxFilterIteration (unsigned int _arg)
Static Public Member Functions
Pointer	New ()
Protected Member Functions
	UnsharpMaskLevelSetImageFilter ()
	~UnsharpMaskLevelSetImageFilter ()
virtual void	PrintSelf (std::ostream &os, Indent indent) const
virtual bool	Halt ()
Protected Attributes
FunctionType::Pointer	m_Function
unsigned int	m_MaxFilterIteration

---

Detailed Description

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

This class implements a detail enhancing filter by making use of the 4th-order level set isotropic diffusion (smoothing) PDE.

INPUT and OUTPUT

This is a volume to volume filter; however, it is meant to process (smooth) surfaces. The input surface is an isosurface of the input volume. The isosurface value to be processed can be set by calling SetIsoSurfaceValue (default is 0). The output surface is the 0-isosurface of the output volume, regardless of the input isosurface value. To visualize the input/output surfaces to this filter a mesh extraction method such as marching cubes can be used.

This filter is an example of how the 4th order level set PDE framework can be used for general purpose surface processing. It is motivated by unsharp masking from image processing which is a way of enhancing detail. This filter acts much like the IsotropicFourthOrderLevelSetImageFilter because it first smoothes the normal vectors via isotropic diffusion. However, as a post-processing step we extrapolate from the original normals in the direction opposite to the new processes normals. By refiting the surface to these extrapolated vectors we achieve detail enhancement. This process is not the same as running the isotropic diffusion process in reverse.

IMPORTANT

Because this filters enhances details on the surface, it will also amplify noise! This filter is provided only as an example of graphics oriented post-processing. Do not use it on noisy data.

PARAMETERS

As mentioned before, the IsoSurfaceValue parameter chooses which isosurface of the input to process. The MaxFilterIterations parameter determine the number of iterations for which this filter will run. Since, this filter enhances detail AND noise MaxFilterIterations above a couple of hundred are unreasonable. Finally NormalProcessUnsharpWeight controls the amount of extrapolation (or equivalently the amount of detail enhancement). This value should be in the range [0.1,1] for reasonable results.

Definition at line 66 of file itkUnsharpMaskLevelSetImageFilter.h.

---

Member Typedef Documentation

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

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

template<class TInputImage, class TOutputImage> typedef LevelSetFunctionWithRefitTerm<TOutputImage,SparseImageType> itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::FunctionType

The level set function class with a refit term that forces the curvature of the moving front to match a prescribed curvature image. Definition at line 90 of file itkUnsharpMaskLevelSetImageFilter.h.

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

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

template<class TInputImage, class TOutputImage> typedef FunctionType::RadiusType itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::RadiusType

The radius type for the neighborhoods. Definition at line 93 of file itkUnsharpMaskLevelSetImageFilter.h.

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

Standard class typedefs Reimplemented from itk::SparseFieldFourthOrderLevelSetImageFilter< TInputImage, TOutputImage >. Definition at line 72 of file itkUnsharpMaskLevelSetImageFilter.h.

template<class TInputImage, class TOutputImage> typedef Superclass::SparseImageType itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::SparseImageType

The sparse image type used in LevelSetFunctionWithRefitTerm Reimplemented from itk::SparseFieldFourthOrderLevelSetImageFilter< TInputImage, TOutputImage >. Definition at line 86 of file itkUnsharpMaskLevelSetImageFilter.h.

template<class TInputImage, class TOutputImage> typedef SparseFieldFourthOrderLevelSetImageFilter<TInputImage, TOutputImage> itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::Superclass

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

---

Constructor & Destructor Documentation

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

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

Definition at line 100 of file itkUnsharpMaskLevelSetImageFilter.h.

---

Member Function Documentation

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

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

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

template<class TInputImage, class TOutputImage> virtual bool itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::Halt (   )  [inline, protected, virtual]

This filter halts when the iteration count reaches the specified count. Reimplemented from itk::FiniteDifferenceImageFilter< TInputImage, TOutputImage >. Definition at line 110 of file itkUnsharpMaskLevelSetImageFilter.h.

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

Standard new macro Reimplemented from itk::SparseFieldLevelSetImageFilter< TInputImage, TOutputImage >.

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

This method first calls the Superclass InitializeIteration method. Then it determines whether ProcessNormals should be called. Reimplemented from itk::SparseFieldFourthOrderLevelSetImageFilter< TInputImage, TOutputImage >.

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

---

Member Data Documentation

template<class TInputImage, class TOutputImage> FunctionType::Pointer itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::m_Function [protected]

The LevelSetFunctionWithRefitTerm object. Definition at line 104 of file itkUnsharpMaskLevelSetImageFilter.h.

template<class TInputImage, class TOutputImage> unsigned int itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::m_MaxFilterIteration [protected]

The number of iterations for which this filter will run. Definition at line 107 of file itkUnsharpMaskLevelSetImageFilter.h.

---

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

• itkUnsharpMaskLevelSetImageFilter.h

---