ITK  4.0.0
Insight Segmentation and Registration Toolkit
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions
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 >:
Collaboration diagram for itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >:

List of all members.

Public Types

typedef SmartPointer< const SelfConstPointer
typedef
LevelSetFunctionWithRefitTerm
< TOutputImage,
SparseImageType
FunctionType
typedef SmartPointer< SelfPointer
typedef FunctionType::RadiusType RadiusType
typedef
UnsharpMaskLevelSetImageFilter 
Self
typedef Superclass::SparseImageType SparseImageType
typedef
SparseFieldFourthOrderLevelSetImageFilter
< TInputImage, TOutputImage > 
Superclass

Public Member Functions

virtual ::itk::LightObject::Pointer CreateAnother (void) const
virtual unsigned int GetMaxFilterIteration () const
virtual const char * GetNameOfClass () const
virtual void SetMaxFilterIteration (unsigned int _arg)

Static Public Member Functions

static Pointer New ()

Protected Member Functions

virtual void PrintSelf (std::ostream &os, Indent indent) const
 UnsharpMaskLevelSetImageFilter ()
 ~UnsharpMaskLevelSetImageFilter ()
virtual bool Halt ()

Protected Attributes

FunctionType::Pointer m_Function
unsigned int m_MaxFilterIteration

Private Member Functions

void operator= (const Self &)
 UnsharpMaskLevelSetImageFilter (const Self &)

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 67 of file itkUnsharpMaskLevelSetImageFilter.h.


Member Typedef Documentation

template<class TInputImage , class TOutputImage >
typedef SmartPointer< const Self > itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::ConstPointer
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
template<class TInputImage , class TOutputImage >
typedef FunctionType::RadiusType itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::RadiusType

The radius type for the neighborhoods.

Reimplemented from itk::SparseFieldFourthOrderLevelSetImageFilter< TInputImage, TOutputImage >.

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 73 of file itkUnsharpMaskLevelSetImageFilter.h.

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

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 99 of file itkUnsharpMaskLevelSetImageFilter.h.

template<class TInputImage , class TOutputImage >
itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::UnsharpMaskLevelSetImageFilter ( const Self ) [private]

Member Function Documentation

template<class TInputImage , class TOutputImage >
virtual::itk::LightObject::Pointer itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::CreateAnother ( void  ) const [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::SparseFieldLevelSetImageFilter< TInputImage, TOutputImage >.

template<class TInputImage , class TOutputImage >
virtual unsigned int itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::GetMaxFilterIteration ( ) const [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 109 of file itkUnsharpMaskLevelSetImageFilter.h.

template<class TInputImage , class TOutputImage >
static Pointer itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::New ( ) [static]
template<class TInputImage , class TOutputImage >
void itk::UnsharpMaskLevelSetImageFilter< TInputImage, TOutputImage >::operator= ( const Self ) [private]

The RMS change calculated from each update. Can be used by a subclass to determine halting criteria. Valid only for the previous iteration, not during the current iteration. Calculated in ApplyUpdate. This flag tells the solver whether or not to interpolate for the actual surface location when calculating change at each active layer node. By default this is turned on. Subclasses which do not sample propagation (speed), advection, or curvature terms should turn this flag off.

Reimplemented from itk::SparseFieldFourthOrderLevelSetImageFilter< 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]
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 106 of file itkUnsharpMaskLevelSetImageFilter.h.


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