#include <itkLevelSetFunctionWithRefitTerm.h>

Detailed Description

template<typename TImageType, typename TSparseImageType>
class itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >

This class extends the LevelSetFunction class by adding a grow term based on a target curvature stored in a sparse image.

: We extend the LevelSetFunction class to add a refitting term. This refitting term forces the curvature of the level set interface to match a prescribed curvature. The prescribed curvature is provided in a sparse image format. The NodeType for the sparse image should contain the member variables m_Curvature and m_CurvatureFlag. The refitting term is defined as part of the propagation term of the original LevelSetFunction. To this purpose we defined the PropagationSpeed method which computes the refitting term and also adds to this term the value returned by the new virtual OtherPropagationSpeed. Therefore, classes derived from this class MUST NOT overwrite the PropagationSpeed method. Instead classes wishing to define a propagation term must define OtherPropagationSpeed.

IMPORTANT: Subclasses MUST NOT overwrite the PropagationSpeed method. Define OtherPropagationSpeed instead.

Definition at line 52 of file itkLevelSetFunctionWithRefitTerm.h.

Inheritance diagram for itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >:

Collaboration diagram for itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >:

Public Types
using	ConstPointer = SmartPointer< const Self >

using	IndexType = typename ImageType::IndexType

using	NeighborhoodSizeValueType = typename NeighborhoodType::SizeValueType

using	NodeType = typename SparseImageType::NodeType

using	NormalVectorType = typename NodeType::NodeDataType

using	Pointer = SmartPointer< Self >

using	Self = LevelSetFunctionWithRefitTerm

using	SparseImageType = TSparseImageType

using	Superclass = LevelSetFunction< TImageType >

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
TimeStepType	ComputeGlobalTimeStep (void *GlobalData) const override

const char *	GetNameOfClass () const override

SparseImageType *	GetSparseTargetImage () const

void	SetOtherPropagationWeight (const ScalarValueType w)

void	SetRefitWeight (const ScalarValueType w)

void	SetSparseTargetImage (SparseImageType *im)

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 RadiusType &	GetRadius () 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::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 ()

Protected Member Functions
ScalarValueType	ComputeCurvature (const NeighborhoodType &) const

	LevelSetFunctionWithRefitTerm ()

virtual ScalarValueType	OtherPropagationSpeed (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *=0) const

void	PrintSelf (std::ostream &os, Indent indent) const override

ScalarValueType	PropagationSpeed (const NeighborhoodType &, const FloatOffsetType &, GlobalDataStruct *=0) const override

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 ()

Protected Attributes
ScalarValueType	m_OtherPropagationWeight {}

ScalarValueType	m_RefitWeight {}

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 {}

Private Attributes
ScalarValueType	m_MinVectorNorm {}

SparseImageType::Pointer	m_SparseTargetImage {}

Static Private Attributes
static const ScalarValueType	m_DimConst

static const NeighborhoodSizeValueType	m_NumVertex

Additional Inherited Members
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

Static Protected Member Functions inherited from itk::LevelSetFunction< TImageType >
static VectorType	InitializeZeroVectorConstant ()

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

using itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::ConstPointer = SmartPointer<const Self>

Definition at line 61 of file itkLevelSetFunctionWithRefitTerm.h.

◆ IndexType

template<typename TImageType , typename TSparseImageType >

using itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::IndexType = typename ImageType::IndexType

Index type derived from the ImageType.

Definition at line 81 of file itkLevelSetFunctionWithRefitTerm.h.

◆ NeighborhoodSizeValueType

template<typename TImageType , typename TSparseImageType >

using itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::NeighborhoodSizeValueType = typename NeighborhoodType::SizeValueType

Definition at line 78 of file itkLevelSetFunctionWithRefitTerm.h.

◆ NodeType

template<typename TImageType , typename TSparseImageType >

using itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::NodeType = typename SparseImageType::NodeType

The node type of the sparse image.

Definition at line 87 of file itkLevelSetFunctionWithRefitTerm.h.

◆ NormalVectorType

template<typename TImageType , typename TSparseImageType >

using itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::NormalVectorType = typename NodeType::NodeDataType

The type for the normal vectors of the level set image.

Definition at line 90 of file itkLevelSetFunctionWithRefitTerm.h.

◆ Pointer

template<typename TImageType , typename TSparseImageType >

using itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::Pointer = SmartPointer<Self>

Definition at line 60 of file itkLevelSetFunctionWithRefitTerm.h.

◆ Self

template<typename TImageType , typename TSparseImageType >

using itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::Self = LevelSetFunctionWithRefitTerm

Standard class type aliases.

Definition at line 58 of file itkLevelSetFunctionWithRefitTerm.h.

◆ SparseImageType

template<typename TImageType , typename TSparseImageType >

using itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::SparseImageType = TSparseImageType

The sparse image type used for the curvature target.

Definition at line 84 of file itkLevelSetFunctionWithRefitTerm.h.

◆ Superclass

template<typename TImageType , typename TSparseImageType >

using itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::Superclass = LevelSetFunction<TImageType>

Definition at line 59 of file itkLevelSetFunctionWithRefitTerm.h.

Constructor & Destructor Documentation

◆ LevelSetFunctionWithRefitTerm()

template<typename TImageType , typename TSparseImageType >

itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::LevelSetFunctionWithRefitTerm ( )

protected

Member Function Documentation

◆ ComputeCurvature()

template<typename TImageType , typename TSparseImageType >

ScalarValueType itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::ComputeCurvature ( const NeighborhoodType & ) const

protected

Computes the curvature of a level set neighborhood in a way that matches the curvature computation from normal vectors.

◆ ComputeGlobalTimeStep()

template<typename TImageType , typename TSparseImageType >

TimeStepType itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::ComputeGlobalTimeStep ( void * GlobalData ) const

overridevirtual

Computes the time step for an update given a global data structure. This calls the ComputeGlobalTimeStep method defined in LevelSetFunction and then imposes our own restrictions for the refitting term on the returned value.

Reimplemented from itk::LevelSetFunction< TImageType >.

◆ GetNameOfClass()

template<typename TImageType , typename TSparseImageType >

const char * itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::GetNameOfClass ( ) const

overridevirtual

See also: LightObject::GetNameOfClass()

Reimplemented from itk::LevelSetFunction< TImageType >.

◆ GetSparseTargetImage()

template<typename TImageType , typename TSparseImageType >

SparseImageType * itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::GetSparseTargetImage ( ) const

inline

Returns the sparse image.

Definition at line 117 of file itkLevelSetFunctionWithRefitTerm.h.

◆ New()

template<typename TImageType , typename TSparseImageType >

static Pointer itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::New ( )

static

Standard New macro.

◆ OtherPropagationSpeed()

template<typename TImageType , typename TSparseImageType >

virtual ScalarValueType itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::OtherPropagationSpeed	(	const NeighborhoodType &	,
		const FloatOffsetType &	,
		GlobalDataStruct *	= `0`
	)		const

inlineprotectedvirtual

Called by PropagationSpeed and added on to the refitting term. Function classes derived from this class should define this method for their propagation speed, NOT the actual PropagationSpeed method.

Definition at line 156 of file itkLevelSetFunctionWithRefitTerm.h.

◆ PrintSelf()

template<typename TImageType , typename TSparseImageType >

void itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::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::LevelSetFunction< TImageType >.

◆ PropagationSpeed()

template<typename TImageType , typename TSparseImageType >

ScalarValueType itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::PropagationSpeed	(	const NeighborhoodType &	,
		const FloatOffsetType &	,
		GlobalDataStruct *	= `0`
	)		const

overrideprotectedvirtual

Defines the virtual function in LevelSetFunction to add the refitting term. This function also calls OtherPropagationSpeed to provide a mechanism for subclasses to define other propagation terms.

Reimplemented from itk::LevelSetFunction< TImageType >.

◆ SetOtherPropagationWeight()

template<typename TImageType , typename TSparseImageType >

void itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::SetOtherPropagationWeight ( const ScalarValueType w )

inline

This is the weight for propagation terms (other than refitting) that can be defined by subclasses.

Definition at line 102 of file itkLevelSetFunctionWithRefitTerm.h.

◆ SetRefitWeight()

template<typename TImageType , typename TSparseImageType >

void itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::SetRefitWeight ( const ScalarValueType w )

inline

Set the relative weight of the refitting term.

Definition at line 94 of file itkLevelSetFunctionWithRefitTerm.h.

◆ SetSparseTargetImage()

template<typename TImageType , typename TSparseImageType >

void itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::SetSparseTargetImage ( SparseImageType * im )

inline

Sets the sparse image which has nodes containing the member variable m_Curvature used in refitting.

Definition at line 110 of file itkLevelSetFunctionWithRefitTerm.h.

Member Data Documentation

◆ m_DimConst

template<typename TImageType , typename TSparseImageType >

const ScalarValueType itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::m_DimConst

staticprivate

Definition at line 170 of file itkLevelSetFunctionWithRefitTerm.h.

◆ m_MinVectorNorm

template<typename TImageType , typename TSparseImageType >

ScalarValueType itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::m_MinVectorNorm {}

private

The minimum vector norm parameter.

Definition at line 166 of file itkLevelSetFunctionWithRefitTerm.h.

◆ m_NumVertex

template<typename TImageType , typename TSparseImageType >

const NeighborhoodSizeValueType itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::m_NumVertex

staticprivate

Constants used in computations.

Definition at line 169 of file itkLevelSetFunctionWithRefitTerm.h.

◆ m_OtherPropagationWeight

template<typename TImageType , typename TSparseImageType >

ScalarValueType itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::m_OtherPropagationWeight {}

protected

The weight for other scalar propagation terms that can be defined by classes derived from this class.

Definition at line 135 of file itkLevelSetFunctionWithRefitTerm.h.

◆ m_RefitWeight

template<typename TImageType , typename TSparseImageType >

ScalarValueType itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::m_RefitWeight {}

protected

The weight for the refitting term.

Definition at line 131 of file itkLevelSetFunctionWithRefitTerm.h.

◆ m_SparseTargetImage

template<typename TImageType , typename TSparseImageType >

SparseImageType::Pointer itk::LevelSetFunctionWithRefitTerm< TImageType, TSparseImageType >::m_SparseTargetImage {}

private

The sparse image that contains the target curvature information.

Definition at line 163 of file itkLevelSetFunctionWithRefitTerm.h.

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

itkLevelSetFunctionWithRefitTerm.h

Detailed Description

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Attributes

Static Private Attributes

Additional Inherited Members

Member Typedef Documentation

◆ ConstPointer

◆ IndexType

◆ NeighborhoodSizeValueType

◆ NodeType

◆ NormalVectorType

◆ Pointer

◆ Self

◆ SparseImageType

◆ Superclass

Constructor & Destructor Documentation

◆ LevelSetFunctionWithRefitTerm()

Member Function Documentation

◆ ComputeCurvature()

◆ ComputeGlobalTimeStep()

◆ GetNameOfClass()

◆ GetSparseTargetImage()

◆ New()

◆ OtherPropagationSpeed()

◆ PrintSelf()

◆ PropagationSpeed()

◆ SetOtherPropagationWeight()

◆ SetRefitWeight()

◆ SetSparseTargetImage()

Member Data Documentation

◆ m_DimConst

◆ m_MinVectorNorm

◆ m_NumVertex

◆ m_OtherPropagationWeight

◆ m_RefitWeight

◆ m_SparseTargetImage