ITK  6.0.0
Insight Toolkit
Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Member Functions | Private Attributes | List of all members
itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType > Class Template Reference

#include <itkGeodesicActiveContourShapePriorLevelSetFunction.h>

Detailed Description

template<typename TImageType, typename TFeatureImageType = TImageType>
class itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >

This function is used in GeodesicActiveContourShapePriorSegmentationLevelSetFilter to segment structures in an image based on user supplied edge potential map and shape model.

IMPORTANT
The LevelSetFunction, SegmentationLevelSetFunction and ShapePriorSegmentationLevelSetFunction classes contain additional information necessary to gain full understanding of how to use this function.

GeodesicActiveContourShapePriorLevelSetFunction 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}(\mathbf{x}) = -\nabla g(\mathbf{x}) \]

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

This class extends the basic LevelSetFunction with a shape prior term as developed in [1].

\( \zeta( \phi^{*} - \phi) \)

where \( \phi^{*} \) is the signed distance function from a target shape and \( \zeta \) is a scalar constant.

The target shape signed distance function is supplied through a ShapeSignedDistanceFunction object. Typically, the shape is a function of a set of parameters.

See also
LevelSetFunction
SegmentationLevelSetFunction
ShapePriorSegmentationLevelSetFunction
ShapeSignedDistanceFunction
REFERENCES
[1] Leventon, M.E. et al. "Statistical Shape Influence in Geodesic Active Contours", CVPR 2000.

Definition at line 93 of file itkGeodesicActiveContourShapePriorLevelSetFunction.h.

+ Inheritance diagram for itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >:
+ Collaboration diagram for itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >:

Public Types

using ConstPointer = SmartPointer< const Self >
 
using FeatureImageType = TFeatureImageType
 
using Pointer = SmartPointer< Self >
 
using Self = GeodesicActiveContourShapePriorLevelSetFunction
 
using Superclass = ShapePriorSegmentationLevelSetFunction< TImageType, TFeatureImageType >
 
- Public Types inherited from itk::ShapePriorSegmentationLevelSetFunction< TImageType, TImageType >
using ConstPointer = SmartPointer< const Self >
 
using FeatureImageType = TImageType
 
using Pointer = SmartPointer< Self >
 
using Self = ShapePriorSegmentationLevelSetFunction
 
using ShapeFunctionPointer = typename ShapeFunctionType::ConstPointer
 
using ShapeFunctionType = ShapeSignedDistanceFunction< double, Self::ImageDimension >
 
using Superclass = SegmentationLevelSetFunction< TImageType, TImageType >
 
- Public Types inherited from itk::SegmentationLevelSetFunction< TImageType, TImageType >
using ConstPointer = SmartPointer< const Self >
 
using ContinuousIndexType = typename InterpolatorType::ContinuousIndexType
 
using FeatureImageType = TImageType
 
using FeatureScalarType = typename FeatureImageType::PixelType
 
using IndexType = typename ImageType::IndexType
 
using InterpolatorType = LinearInterpolateImageFunction< ImageType >
 
using Pointer = SmartPointer< Self >
 
using Self = SegmentationLevelSetFunction
 
using Superclass = LevelSetFunction< TImageType >
 
using VectorImageType = Image< VectorType, Self::ImageDimension >
 
using VectorInterpolatorType = VectorLinearInterpolateImageFunction< VectorImageType >
 
- Public Types inherited from itk::LevelSetFunction< TImageType >
using ConstPointer = SmartPointer< const Self >
 
using Pointer = SmartPointer< Self >
 
using ScalarValueType = PixelType
 
using Self = LevelSetFunction
 
using Superclass = FiniteDifferenceFunction< TImageType >
 
using TimeStepType = double
 
using VectorType = FixedArray< ScalarValueType, Self::ImageDimension >
 
- Public Types inherited from itk::FiniteDifferenceFunction< TImageType >
using ConstPointer = SmartPointer< const Self >
 
using DefaultBoundaryConditionType = ZeroFluxNeumannBoundaryCondition< ImageType >
 
using FloatOffsetType = Vector< float, Self::ImageDimension >
 
using ImageType = TImageType
 
using NeighborhoodScalesType = Vector< PixelRealType, Self::ImageDimension >
 
using NeighborhoodType = ConstNeighborhoodIterator< TImageType, DefaultBoundaryConditionType >
 
using PixelRealType = double
 
using PixelType = typename ImageType::PixelType
 
using Pointer = SmartPointer< Self >
 
using RadiusType = typename ConstNeighborhoodIterator< TImageType >::RadiusType
 
using Self = FiniteDifferenceFunction
 
using Superclass = LightObject
 
using TimeStepType = double
 
- Public Types inherited from itk::LightObject
using ConstPointer = SmartPointer< const Self >
 
using Pointer = SmartPointer< Self >
 
using Self = LightObject
 

Public Member Functions

void CalculateAdvectionImage () override
 
void CalculateSpeedImage () override
 
ScalarValueType CurvatureSpeed (const NeighborhoodType &neighborhood, const FloatOffsetType &offset, GlobalDataStruct *gd) const override
 
const char * GetNameOfClass () const override
 
void Initialize (const RadiusType &r) override
 
void SetDerivativeSigma (const double v)
 
double GetDerivativeSigma ()
 
- Public Member Functions inherited from itk::ShapePriorSegmentationLevelSetFunction< TImageType, TImageType >
TimeStepType ComputeGlobalTimeStep (void *gd) const override
 
PixelType ComputeUpdate (const NeighborhoodType &neighborhood, void *gd, const FloatOffsetType &=FloatOffsetType(0.0)) override
 
void * GetGlobalDataPointer () const override
 
const char * GetNameOfClass () const override
 
void ReleaseGlobalDataPointer (void *GlobalData) const override
 
void SetShapePriorWeight (const ScalarValueType p)
 
ScalarValueType GetShapePriorWeight () const
 
void SetShapeFunction (const ShapeFunctionType *ptr)
 
const ShapeFunctionTypeGetShapeFunction () const
 
- Public Member Functions inherited from itk::SegmentationLevelSetFunction< TImageType, TImageType >
virtual void AllocateAdvectionImage ()
 
virtual void AllocateSpeedImage ()
 
virtual void CalculateAdvectionImage ()
 
virtual void CalculateSpeedImage ()
 
const char * GetNameOfClass () const override
 
void Initialize (const RadiusType &r) override
 
virtual void ReverseExpansionDirection ()
 
virtual const FeatureImageTypeGetFeatureImage () const
 
virtual void SetFeatureImage (const FeatureImageType *f)
 
virtual ImageTypeGetSpeedImage ()
 
void SetSpeedImage (ImageType *s)
 
virtual VectorImageTypeGetAdvectionImage () const
 
void SetAdvectionImage (VectorImageType *s)
 
- Public Member Functions inherited from itk::LevelSetFunction< TImageType >
virtual VectorType AdvectionField (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *=0) const
 
virtual ScalarValueType Compute3DMinimalCurvature (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *gd=0)
 
virtual ScalarValueType ComputeCurvatureTerm (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *gd=0)
 
TimeStepType ComputeGlobalTimeStep (void *GlobalData) const override
 
virtual ScalarValueType ComputeMeanCurvature (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *gd=0)
 
virtual ScalarValueType ComputeMinimalCurvature (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *gd=0)
 
PixelType ComputeUpdate (const NeighborhoodType &it, void *globalData, const FloatOffsetType &=FloatOffsetType(0.0)) override
 
virtual ScalarValueType CurvatureSpeed (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *=nullptr) const
 
void * GetGlobalDataPointer () const override
 
const char * GetNameOfClass () const override
 
bool GetUseMinimalCurvature () const
 
virtual void Initialize (const RadiusType &r)
 
virtual ScalarValueType LaplacianSmoothingSpeed (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *=0) const
 
virtual ScalarValueType PropagationSpeed (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *=0) const
 
void ReleaseGlobalDataPointer (void *GlobalData) const override
 
void SetUseMinimalCurvature (bool b)
 
void UseMinimalCurvatureOff ()
 
void UseMinimalCurvatureOn ()
 
virtual void SetAdvectionWeight (const ScalarValueType a)
 
ScalarValueType GetAdvectionWeight () const
 
virtual void SetPropagationWeight (const ScalarValueType p)
 
ScalarValueType GetPropagationWeight () const
 
virtual void SetCurvatureWeight (const ScalarValueType c)
 
ScalarValueType GetCurvatureWeight () const
 
void SetLaplacianSmoothingWeight (const ScalarValueType c)
 
ScalarValueType GetLaplacianSmoothingWeight () const
 
void SetEpsilonMagnitude (const ScalarValueType e)
 
ScalarValueType GetEpsilonMagnitude () const
 
- Public Member Functions inherited from itk::FiniteDifferenceFunction< TImageType >
virtual TimeStepType ComputeGlobalTimeStep (void *GlobalData) const =0
 
const NeighborhoodScalesType ComputeNeighborhoodScales () const
 
virtual PixelType ComputeUpdate (const NeighborhoodType &neighborhood, void *globalData, const FloatOffsetType &offset=FloatOffsetType(0.0))=0
 
virtual void * GetGlobalDataPointer () const =0
 
const char * GetNameOfClass () const override
 
const RadiusTypeGetRadius () const
 
void GetScaleCoefficients (PixelRealType vals[ImageDimension]) const
 
virtual void InitializeIteration ()
 
virtual void ReleaseGlobalDataPointer (void *GlobalData) const =0
 
void SetRadius (const RadiusType &r)
 
void SetScaleCoefficients (const PixelRealType vals[ImageDimension])
 
- Public Member Functions inherited from itk::LightObject
Pointer Clone () const
 
virtual Pointer CreateAnother () const
 
virtual void Delete ()
 
virtual const char * GetNameOfClass () const
 
virtual int GetReferenceCount () const
 
void Print (std::ostream &os, Indent indent=0) const
 
virtual void Register () const
 
virtual void SetReferenceCount (int)
 
virtual void UnRegister () const noexcept
 

Static Public Member Functions

static Pointer New ()
 
- Static Public Member Functions inherited from itk::ShapePriorSegmentationLevelSetFunction< TImageType, TImageType >
static Pointer New ()
 
- Static Public Member Functions inherited from itk::LevelSetFunction< TImageType >
static double GetMaximumCurvatureTimeStep ()
 
static double GetMaximumPropagationTimeStep ()
 
static Pointer New ()
 
static void SetMaximumCurvatureTimeStep (double n)
 
static void SetMaximumPropagationTimeStep (double n)
 
- Static Public Member Functions inherited from itk::LightObject
static void BreakOnError ()
 
static Pointer New ()
 

Static Public Attributes

static constexpr unsigned int ImageDimension = Superclass::ImageDimension
 
- Static Public Attributes inherited from itk::ShapePriorSegmentationLevelSetFunction< TImageType, TImageType >
static constexpr unsigned int ImageDimension
 
- Static Public Attributes inherited from itk::SegmentationLevelSetFunction< TImageType, TImageType >
static constexpr unsigned int ImageDimension
 
- Static Public Attributes inherited from itk::LevelSetFunction< TImageType >
static constexpr unsigned int ImageDimension = Superclass::ImageDimension
 
- Static Public Attributes inherited from itk::FiniteDifferenceFunction< TImageType >
static constexpr unsigned int ImageDimension = ImageType::ImageDimension
 

Protected Member Functions

 GeodesicActiveContourShapePriorLevelSetFunction ()
 
void PrintSelf (std::ostream &os, Indent indent) const override
 
 ~GeodesicActiveContourShapePriorLevelSetFunction () override=default
 
- Protected Member Functions inherited from itk::ShapePriorSegmentationLevelSetFunction< TImageType, TImageType >
void PrintSelf (std::ostream &os, Indent indent) const override
 
 ShapePriorSegmentationLevelSetFunction ()
 
 ~ShapePriorSegmentationLevelSetFunction () override=default
 
- Protected Member Functions inherited from itk::SegmentationLevelSetFunction< TImageType, TImageType >
VectorType AdvectionField (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *gd) const override
 
ScalarValueType PropagationSpeed (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *gd) const override
 
 SegmentationLevelSetFunction ()
 
 ~SegmentationLevelSetFunction () override=default
 
- Protected Member Functions inherited from itk::LevelSetFunction< TImageType >
 LevelSetFunction ()
 
void PrintSelf (std::ostream &os, Indent indent) const override
 
 ~LevelSetFunction () override=default
 
- Protected Member Functions inherited from itk::FiniteDifferenceFunction< TImageType >
 FiniteDifferenceFunction ()
 
void PrintSelf (std::ostream &os, Indent indent) const override
 
 ~FiniteDifferenceFunction () override=default
 
- Protected Member Functions inherited from itk::LightObject
virtual LightObject::Pointer InternalClone () const
 
 LightObject ()
 
virtual void PrintHeader (std::ostream &os, Indent indent) const
 
virtual void PrintSelf (std::ostream &os, Indent indent) const
 
virtual void PrintTrailer (std::ostream &os, Indent indent) const
 
virtual ~LightObject ()
 

Private Attributes

double m_DerivativeSigma {}
 

Additional Inherited Members

- Static Protected Member Functions inherited from itk::LevelSetFunction< TImageType >
static VectorType InitializeZeroVectorConstant ()
 
- Protected Attributes inherited from itk::SegmentationLevelSetFunction< TImageType, TImageType >
VectorImageType::Pointer m_AdvectionImage
 
FeatureImageType::ConstPointer m_FeatureImage
 
InterpolatorType::Pointer m_Interpolator
 
ImageType::Pointer m_SpeedImage
 
VectorInterpolatorType::Pointer m_VectorInterpolator
 
- Protected Attributes inherited from itk::LevelSetFunction< TImageType >
ScalarValueType m_AdvectionWeight {}
 
OffsetValueType m_Center { 0 }
 
ScalarValueType m_CurvatureWeight {}
 
ScalarValueType m_EpsilonMagnitude {}
 
ScalarValueType m_LaplacianSmoothingWeight {}
 
ScalarValueType m_PropagationWeight {}
 
bool m_UseMinimalCurvature { false }
 
OffsetValueType m_xStride [Self::ImageDimension] {}
 
std::slice x_slice [Self::ImageDimension]
 
- Protected Attributes inherited from itk::FiniteDifferenceFunction< TImageType >
RadiusType m_Radius {}
 
PixelRealType m_ScaleCoefficients [ImageDimension] {}
 
- Protected Attributes inherited from itk::LightObject
std::atomic< int > m_ReferenceCount {}
 
- Static Protected Attributes inherited from itk::LevelSetFunction< TImageType >
static double m_DT
 
static double m_WaveDT
 
static VectorType m_ZeroVectorConstant
 

Member Typedef Documentation

◆ ConstPointer

template<typename TImageType , typename TFeatureImageType = TImageType>
using itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::ConstPointer = SmartPointer<const Self>

◆ FeatureImageType

template<typename TImageType , typename TFeatureImageType = TImageType>
using itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::FeatureImageType = TFeatureImageType

◆ Pointer

template<typename TImageType , typename TFeatureImageType = TImageType>
using itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::Pointer = SmartPointer<Self>

◆ Self

template<typename TImageType , typename TFeatureImageType = TImageType>
using itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::Self = GeodesicActiveContourShapePriorLevelSetFunction

Standard class type aliases.

Definition at line 100 of file itkGeodesicActiveContourShapePriorLevelSetFunction.h.

◆ Superclass

template<typename TImageType , typename TFeatureImageType = TImageType>
using itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::Superclass = ShapePriorSegmentationLevelSetFunction<TImageType, TFeatureImageType>

Constructor & Destructor Documentation

◆ GeodesicActiveContourShapePriorLevelSetFunction()

template<typename TImageType , typename TFeatureImageType = TImageType>
itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::GeodesicActiveContourShapePriorLevelSetFunction ( )
inlineprotected

◆ ~GeodesicActiveContourShapePriorLevelSetFunction()

template<typename TImageType , typename TFeatureImageType = TImageType>
itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::~GeodesicActiveContourShapePriorLevelSetFunction ( )
overrideprotecteddefault

Member Function Documentation

◆ CalculateAdvectionImage()

template<typename TImageType , typename TFeatureImageType = TImageType>
void itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::CalculateAdvectionImage ( )
overridevirtual

Compute the advection field from feature image.

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

◆ CalculateSpeedImage()

template<typename TImageType , typename TFeatureImageType = TImageType>
void itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::CalculateSpeedImage ( )
overridevirtual

Compute speed image from feature image.

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

◆ CurvatureSpeed()

template<typename TImageType , typename TFeatureImageType = TImageType>
ScalarValueType itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::CurvatureSpeed ( const NeighborhoodType neighborhood,
const FloatOffsetType offset,
GlobalDataStruct gd 
) const
inlineoverridevirtual

The curvature speed is same as the propagation speed.

Reimplemented from itk::LevelSetFunction< TImageType >.

Definition at line 135 of file itkGeodesicActiveContourShapePriorLevelSetFunction.h.

◆ GetDerivativeSigma()

template<typename TImageType , typename TFeatureImageType = TImageType>
double itk::GeodesicActiveContourShapePriorLevelSetFunction< 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 150 of file itkGeodesicActiveContourShapePriorLevelSetFunction.h.

◆ GetNameOfClass()

template<typename TImageType , typename TFeatureImageType = TImageType>
const char * itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::GetNameOfClass ( ) const
overridevirtual

◆ Initialize()

template<typename TImageType , typename TFeatureImageType = TImageType>
void itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::Initialize ( const RadiusType r)
inlineoverridevirtual

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

Definition at line 157 of file itkGeodesicActiveContourShapePriorLevelSetFunction.h.

◆ New()

template<typename TImageType , typename TFeatureImageType = TImageType>
static Pointer itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::New ( )
static

Method for creation through the object factory.

◆ PrintSelf()

template<typename TImageType , typename TFeatureImageType = TImageType>
void itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::PrintSelf ( std::ostream &  os,
Indent  indent 
) const
overrideprotectedvirtual

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

◆ SetDerivativeSigma()

template<typename TImageType , typename TFeatureImageType = TImageType>
void itk::GeodesicActiveContourShapePriorLevelSetFunction< 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 145 of file itkGeodesicActiveContourShapePriorLevelSetFunction.h.

Member Data Documentation

◆ ImageDimension

template<typename TImageType , typename TFeatureImageType = TImageType>
constexpr unsigned int itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::ImageDimension = Superclass::ImageDimension
staticconstexpr

Extract some parameters from the superclass.

Definition at line 123 of file itkGeodesicActiveContourShapePriorLevelSetFunction.h.

◆ m_DerivativeSigma

template<typename TImageType , typename TFeatureImageType = TImageType>
double itk::GeodesicActiveContourShapePriorLevelSetFunction< TImageType, TFeatureImageType >::m_DerivativeSigma {}
private

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