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

itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType > Class Template Reference
[Finite Difference Functions]

This function is used in GeodesicActiveContourLevelSetImageFilter to segment structures in an image based on a user supplied edge potential map. More...

#include <itkGeodesicActiveContourLevelSetFunction.h>

Inheritance diagram for itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >:

Inheritance graph
[legend]
Collaboration diagram for itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >:

Collaboration graph
[legend]
List of all members.

Public Types

typedef GeodesicActiveContourLevelSetFunction Self
typedef SegmentationLevelSetFunction<
TImageType, TFeatureImageType > 		Superclass
typedef SmartPointer< Self > Pointer
typedef SmartPointer< const
Self > 		ConstPointer
typedef TFeatureImageType FeatureImageType
typedef Superclass::ImageType ImageType
typedef Superclass::NeighborhoodType NeighborhoodType
typedef Superclass::ScalarValueType ScalarValueType
typedef Superclass::FeatureScalarType FeatureScalarType
typedef Superclass::RadiusType RadiusType
typedef Superclass::FloatOffsetType FloatOffsetType
typedef Superclass::VectorImageType VectorImageType
typedef Superclass::GlobalDataStruct GlobalDataStruct

Public Member Functions

virtual const char * GetClassName () const
 itkStaticConstMacro (ImageDimension, unsigned int, Superclass::ImageDimension)
virtual void CalculateSpeedImage ()
virtual void CalculateAdvectionImage ()
virtual ScalarValueType CurvatureSpeed (const NeighborhoodType &neighborhood, const FloatOffsetType &offset, GlobalDataStruct *gd) const
virtual void Initialize (const RadiusType &r)
void SetDerivativeSigma (const double v)
double GetDerivativeSigma ()

Static Public Member Functions

Pointer New ()

Protected Member Functions

 GeodesicActiveContourLevelSetFunction ()
virtual ~GeodesicActiveContourLevelSetFunction ()
 GeodesicActiveContourLevelSetFunction (const Self &)
void operator= (const Self &)
void PrintSelf (std::ostream &os, Indent indent) const

Detailed Description

template<class TImageType, class TFeatureImageType = TImageType>
class itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >

This function is used in GeodesicActiveContourLevelSetImageFilter to segment structures in an image based on a user supplied edge potential map.

IMPORTANT
The LevelSetFunction class contain additional information necessary to gain full understanding of how to use this function.
GeodesicActiveContourLevelSetFunction is a subclass of the generic LevelSetFunction. It is used to segment structures in an image based on a user supplied edge potential map $ g(I) $, which has values close to zero in regions near edges (or high image gradient) and values close to one in regions with relatively constant intensity. Typically, the edge potential map is a function of the gradient, for example:

\[ g(I) = 1 / ( 1 + | (\nabla * G)(I)| ) \]

\[ g(I) = \exp^{-|(\nabla * G)(I)|} \]

where $ I $ is image intensity and $ (\nabla * G) $ is the derivative of Gaussian operator.

The edge potential image is set via the SetFeatureImage() method.

In this function both the propagation term $ P(\mathbf{x}) $ and the curvature spatial modifier term $ Z(\mathbf{x}) $ are taken directly from the edge potential image such that:

\[ P(\mathbf{x}) = g(\mathbf{x}) \]

\[ Z(\mathbf{x}) = g(\mathbf{x}) \]

An advection term $ \mathbf{A}(\mathbf{x}) $ is constructed from the negative gradient of the edge potential image.

\[ \mathbf{A}(\matbf{x}) = -\nabla g(\mathbf{x}) \]

This term behaves like a doublet attracting the contour to the edges.

This implementation is based on: "Geodesic Active Contours", V. Caselles, R. Kimmel and G. Sapiro. International Journal on Computer Vision, Vol 22, No. 1, pp 61-97, 1997

See also:
LevelSetFunction

SegmentationLevelSetImageFunction

GeodesicActiveContourLevelSetImageFilter

Definition at line 75 of file itkGeodesicActiveContourLevelSetFunction.h.

Member Typedef Documentation

template<class TImageType, class TFeatureImageType = TImageType>
typedef SmartPointer<const Self> itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::ConstPointer
 

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 83 of file itkGeodesicActiveContourLevelSetFunction.h.

template<class TImageType, class TFeatureImageType = TImageType>
typedef TFeatureImageType itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::FeatureImageType
 

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 84 of file itkGeodesicActiveContourLevelSetFunction.h.

template<class TImageType, class TFeatureImageType = TImageType>
typedef Superclass::FeatureScalarType itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::FeatureScalarType
 

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 96 of file itkGeodesicActiveContourLevelSetFunction.h.

template<class TImageType, class TFeatureImageType = TImageType>
typedef Superclass::FloatOffsetType itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::FloatOffsetType
 

A floating point offset from an image grid location. Used for interpolation among grid values in a neighborhood.

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 98 of file itkGeodesicActiveContourLevelSetFunction.h.

Referenced by itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::CurvatureSpeed().

template<class TImageType, class TFeatureImageType = TImageType>
typedef Superclass::GlobalDataStruct itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::GlobalDataStruct
 

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 100 of file itkGeodesicActiveContourLevelSetFunction.h.

Referenced by itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::CurvatureSpeed().

template<class TImageType, class TFeatureImageType = TImageType>
typedef Superclass::ImageType itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::ImageType
 

Extract some parameters from the superclass.

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 93 of file itkGeodesicActiveContourLevelSetFunction.h.

template<class TImageType, class TFeatureImageType = TImageType>
typedef Superclass::NeighborhoodType itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::NeighborhoodType
 

The type of data structure that is passed to this function object to evaluate at a pixel that does not lie on a data set boundary.

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 94 of file itkGeodesicActiveContourLevelSetFunction.h.

Referenced by itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::CurvatureSpeed().

template<class TImageType, class TFeatureImageType = TImageType>
typedef SmartPointer<Self> itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::Pointer
 

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 82 of file itkGeodesicActiveContourLevelSetFunction.h.

template<class TImageType, class TFeatureImageType = TImageType>
typedef Superclass::RadiusType itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::RadiusType
 

Neighborhood radius type

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 97 of file itkGeodesicActiveContourLevelSetFunction.h.

template<class TImageType, class TFeatureImageType = TImageType>
typedef Superclass::ScalarValueType itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::ScalarValueType
 

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 95 of file itkGeodesicActiveContourLevelSetFunction.h.

Referenced by itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::CurvatureSpeed().

template<class TImageType, class TFeatureImageType = TImageType>
typedef GeodesicActiveContourLevelSetFunction itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::Self
 

Standard class typedefs.

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 80 of file itkGeodesicActiveContourLevelSetFunction.h.

Referenced by itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::~GeodesicActiveContourLevelSetFunction().

template<class TImageType, class TFeatureImageType = TImageType>
typedef SegmentationLevelSetFunction<TImageType, TFeatureImageType> itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::Superclass
 

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 81 of file itkGeodesicActiveContourLevelSetFunction.h.

template<class TImageType, class TFeatureImageType = TImageType>
typedef Superclass::VectorImageType itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::VectorImageType
 

Define an image type for the advection field.

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 99 of file itkGeodesicActiveContourLevelSetFunction.h.

Constructor & Destructor Documentation

template<class TImageType, class TFeatureImageType = TImageType>
itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::GeodesicActiveContourLevelSetFunction (   )  [inline, protected]
 

Definition at line 135 of file itkGeodesicActiveContourLevelSetFunction.h.

template<class TImageType, class TFeatureImageType = TImageType>
virtual itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::~GeodesicActiveContourLevelSetFunction (   )  [inline, protected, virtual]
 

Definition at line 143 of file itkGeodesicActiveContourLevelSetFunction.h.

References itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::Self.

template<class TImageType, class TFeatureImageType = TImageType>
itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::GeodesicActiveContourLevelSetFunction (  const Self &   )  [protected]
 

Member Function Documentation

template<class TImageType, class TFeatureImageType = TImageType>
virtual void itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::CalculateAdvectionImage (   )  [virtual]
 

Compute the advection field from feature image.

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

template<class TImageType, class TFeatureImageType = TImageType>
virtual void itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::CalculateSpeedImage (   )  [virtual]
 

Compute speed image from feature image.

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

template<class TImageType, class TFeatureImageType = TImageType>
virtual ScalarValueType itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::CurvatureSpeed (  const NeighborhoodType &  neighborhood,
const FloatOffsetType &  offset,
GlobalDataStruct *  gd
)  const [inline, virtual]
 

The curvature speed is same as the propagation speed.

Reimplemented from itk::LevelSetFunction< TImageType >.

Definition at line 113 of file itkGeodesicActiveContourLevelSetFunction.h.

References itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::FloatOffsetType, itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::GlobalDataStruct, itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::NeighborhoodType, and itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::ScalarValueType.

template<class TImageType, class TFeatureImageType = TImageType>
virtual const char* itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::GetClassName (   )  const [virtual]
 

Run-time type information (and related methods)

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

template<class TImageType, class TFeatureImageType = TImageType>
double itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::GetDerivativeSigma (   )  [inline]
 

Set/Get the sigma for the Gaussian kernel used to compute the gradient of the feature image needed for the advection term of the equation. Definition at line 121 of file itkGeodesicActiveContourLevelSetFunction.h.

template<class TImageType, class TFeatureImageType = TImageType>
virtual void itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::Initialize (  const RadiusType &  r  )  [inline, virtual]
 

This method creates the appropriate member variable operators for the level-set calculations. The argument to this function is a the radius necessary for performing the level-set calculations.

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

Definition at line 125 of file itkGeodesicActiveContourLevelSetFunction.h.

template<class TImageType, class TFeatureImageType = TImageType>
itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::itkStaticConstMacro (  ImageDimension  ,
unsigned  int,
Superclass::ImageDimension 
) 
 

Extract some parameters from the superclass.

Reimplemented from itk::SegmentationLevelSetFunction< TImageType, TFeatureImageType >.

template<class TImageType, class TFeatureImageType = TImageType>
Pointer itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::New (   )  [static]
 

Method for creation through the object factory.

Reimplemented from itk::LevelSetFunction< TImageType >.

template<class TImageType, class TFeatureImageType = TImageType>
void itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::operator= (  const Self &   )  [protected]
 

Reimplemented from itk::LevelSetFunction< TImageType >.

template<class TImageType, class TFeatureImageType = TImageType>
void itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::PrintSelf (  std::ostream &  os,
Indent  indent
)  const [inline, protected, virtual]
 

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::LevelSetFunction< TImageType >.

Definition at line 148 of file itkGeodesicActiveContourLevelSetFunction.h.

References HardConnectedComponentImageFilter::PrintSelf().

template<class TImageType, class TFeatureImageType = TImageType>
void itk::GeodesicActiveContourLevelSetFunction< TImageType, TFeatureImageType >::SetDerivativeSigma (  const double  v  )  [inline]
 

Set/Get the sigma for the Gaussian kernel used to compute the gradient of the feature image needed for the advection term of the equation. Definition at line 119 of file itkGeodesicActiveContourLevelSetFunction.h.

The documentation for this class was generated from the following file:
Generated at Sun Apr 1 02:49:41 2007 for ITK by doxygen 1.3.8 written by Dimitri van Heesch, © 1997-2000