Main Page   Groups   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Concepts

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 >:

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

Collaboration graph
[legend]
List of all members.

Public Types

typedef UnsharpMaskLevelSetImageFilter Self
typedef SparseFieldFourthOrderLevelSetImageFilter<
TInputImage, TOutputImage > 
Superclass
typedef SmartPointer< SelfPointer
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:
Generated at Thu May 25 02:32:44 2006 for ITK by doxygen 1.3.5 written by Dimitri van Heesch, © 1997-2000