mirtk::SurfaceForce Class Reference

#include <SurfaceForce.h>

Inheritance diagram for mirtk::SurfaceForce:

Collaboration diagram for mirtk::SurfaceForce:

Public Member Functions
double	IntersectWithRay (const double p[3], const double e[3], double l=.0) const
double	SelfDistance (const double p[3], const double n[3], double maxd=.0) const
virtual	~SurfaceForce ()
	Destructor.
Public Member Functions inherited from mirtk::ExternalForce
virtual void	Initialize ()
	Initialize external force once input and parameters have been set.
virtual void	Update (bool=true)
	Update moving input points and internal state of external force term.
virtual	~ExternalForce ()
	Destructor.
Public Member Functions inherited from mirtk::PointSetForce
virtual void	Reinitialize ()
virtual void	WriteDataSets (const char *, const char *, bool=true) const
	Write input of force term.
virtual void	WriteGradient (const char *, const char *) const
	Write gradient of force term.
virtual	~PointSetForce ()
	Destructor.
Public Member Functions inherited from mirtk::EnergyTerm
virtual enum EnergyMeasure	EnergyMeasure () const =0
	Energy measure implemented by this term.
void	Gradient (double *gradient, double step)
virtual void	GradientStep (const double *gradient, double &min, double &max) const
double	InitialValue ()
	Returns initial value of energy term.
void	NormalizedGradient (double *gradient, double step)
virtual ParameterList	Parameter () const
	Get parameter key/value as string map.
string	Prefix (const char *=NULL) const
	Prefix to be used for debug output files.
virtual void	Print (Indent=0) const
	Print debug information.
virtual double	RawValue (double) const
double	RawValue ()
void	ResetInitialValue ()
	Reset initial value of energy term.
void	ResetValue ()
	Reset cached value of energy term.
virtual bool	Upgrade ()
	Update energy term after convergence.
double	Value ()
	Evaluate energy term.
virtual	~EnergyTerm ()
	Destructor.
Public Member Functions inherited from mirtk::Configurable
string	DefaultName () const
virtual bool	Set (const char *, const char *)
	Set parameter value from string.
virtual	~Configurable ()
	Destructor.
Public Member Functions inherited from mirtk::Observable
void	AddObserver (Observer &)
	Add observer.
void	Broadcast (Event, const void *=NULL)
	Broadcast event to observers.
void	ClearObservers ()
	Delete all observers.
void	DeleteObserver (Observer &)
	Delete observer.
void	NotifyObservers (Event, const void *=NULL)
	Notify all observers about given event if this object has changed.
int	NumberOfObservers () const
	Number of current observers.
virtual	~Observable ()
	Destructor.
Public Member Functions inherited from mirtk::Object
virtual const char *	NameOfClass () const =0
	Get name of class, which this object is an instance of.
bool	Parameter (const ParameterList &)
	Set parameters from name/value pairs.
virtual	~Object ()
	Destructor.

Protected Member Functions
void	CopyAttributes (const SurfaceForce &)
	Copy attributes of this class from another instance.
SurfaceForce &	operator= (const SurfaceForce &)
	Assignment operator.
	SurfaceForce (const char *="", double=1.0)
	Constructor.
	SurfaceForce (const SurfaceForce &)
	Copy constructor.
Protected Member Functions inherited from mirtk::ExternalForce
void	CopyAttributes (const ExternalForce &)
	Copy attributes of this class from another instance.
virtual double	Evaluate ()
	Evaluate external force term.
	ExternalForce (const char *="", double=1.0)
	Constructor.
	ExternalForce (const ExternalForce &)
	Copy constructor.
ExternalForce &	operator= (const ExternalForce &)
	Assignment operator.
Protected Member Functions inherited from mirtk::PointSetForce
void	AddPointData (const char *name, vtkSmartPointer< vtkDataArray > &data, bool global=false)
vtkDataArray *	AddPointData (const char *name, int c=1, int type=VTK_FLOAT, bool global=false)
void	AllocateCount (int)
	Allocate _Count memory.
void	AllocateGradient (int)
	Allocate memory for (non-parametric) gradient.
void	CopyAttributes (const PointSetForce &)
	Copy attributes of this class from another instance.
vtkPointSet *	DeformedPointSet () const
	Get point set on which this force is acting on.
vtkPolyData *	DeformedSurface () const
	Get point set on which this force is acting on.
const EdgeTable *	Edges () const
	Get edge table of point set mesh.
virtual void	EvaluateGradient (double *gradient, double step, double weight)
vtkSmartPointer< vtkPoints >	GetInitialPoints () const
	Get initial points, possibly pre-transformed by global transformation.
void	Init ()
	Common (re-)initialization steps of this class only (non-virtual function!)
vtkDataArray *	InitialStatus () const
	Get initial point status array.
	mirtkAggregateMacro (int, Count)
	mirtkAttributeMacro (int, GradientSize)
	Size of gradient vector.
	mirtkAttributeMacro (int, CountSize)
	Size of count vector.
	mirtkAttributeMacro (bool, InitialUpdate)
	Whether Update has not been called since initialization.
	mirtkComponentMacro (GradientType, Gradient)
	Negative node forces/gradient of external force term.
	mirtkPublicAggregateMacro (RegisteredPointSet, PointSet)
	Transformed point set.
	mirtkPublicAttributeMacro (int, GradientAveraging)
	Number of gradient averaging iterations.
	mirtkPublicAttributeMacro (bool, AverageSignedGradients)
	mirtkPublicAttributeMacro (bool, AverageGradientMagnitude)
	Whether to only average the magnitude of the gradient vectors.
	mirtkReadOnlyAttributeMacro (bool, SurfaceForce)
	mirtkReadOnlyAttributeMacro (int, NumberOfPoints)
	Number of points.
const NodeNeighbors *	Neighbors (int=-1) const
	Get edge-connectivity table of point set node neighbors.
vtkDataArray *	Normals () const
	Get point normals array.
PointSetForce &	operator= (const PointSetForce &)
	Assignment operator.
vtkPointSet *	OriginalPointSet () const
	Get point set on which this force is acting on.
vtkPolyData *	OriginalSurface () const
	Get point set on which this force is acting on.
vtkPointData *	PointData () const
	Get point data.
vtkDataArray *	PointData (const char *name, bool optional=false) const
vtkPoints *	Points () const
	Get points of point set on which this force is acting on.
	PointSetForce (const char *="", double=1.0)
	Constructor.
	PointSetForce (const PointSetForce &)
	Copy constructor.
void	RemovePointData (const char *name)
SharedPtr< const EdgeTable >	SharedEdgeTable () const
	Get edge table of point set mesh.
vtkDataArray *	Status () const
	Get point status array.
Protected Member Functions inherited from mirtk::EnergyTerm
	EnergyTerm (const char *="", double=1.0)
	Constructor.
	EnergyTerm (const EnergyTerm &)
	Copy constructor.
EnergyTerm &	operator= (const EnergyTerm &)
	Assignment operator.
virtual bool	SetWithoutPrefix (const char *, const char *)
	Set parameter value from string.
virtual bool	SetWithPrefix (const char *, const char *)
	Set parameter value from string.
Protected Member Functions inherited from mirtk::Configurable
	Configurable (const char *="")
	Constructor.
	Configurable (const Configurable &)
	Copy constructor.
string	DefaultPrefix () const
	Get default object name prefix (if any)
bool	HasName () const
	Whether this object has an explicit name.
bool	HasPrefix () const
	Whether this object has either an explicit name or default prefix.
template<class T >
bool	InsertWithPrefix (ParameterList &, string, T) const
	Insert parameter into name/value list with object name prefix.
bool	InsertWithPrefix (ParameterList &, const ParameterList &) const
	Insert parameters into name/value list with object name prefix.
Configurable &	operator= (const Configurable &)
	Assignment operator.
string	ParameterNameWithoutPrefix (const char *) const
	Get name of parameter without object name prefix.
string	ParameterNameWithPrefix (const string &) const
	Get name of parameter with default object name prefix.
string	ParameterNameWithPrefix (const char *) const
	Get name of parameter with default object name prefix.
Protected Member Functions inherited from mirtk::Observable
	Observable ()
	Default constructor.
	Observable (const Observable &)
	Copy constructor.
Observable &	operator= (const Observable &)
	Assignment operator.
Protected Member Functions inherited from mirtk::Object
template<typename... Args>
void	Throw (ErrorType err, const char *func, Args... args) const

Additional Inherited Members
Public Types inherited from mirtk::ExternalForce
typedef GenericImage< VoxelType >	ImageType
	Non-abstract base type of input image.
typedef RegisteredImage::VoxelType	VoxelType
	Type of input image voxel values.
Public Types inherited from mirtk::PointSetForce
typedef RegisteredPointSet::EdgeTable	EdgeTable
	Adjacency matrix with edge IDs.
typedef Vector3D< double >	GradientType
	Type of gradient w.r.t a single transformed data point.
typedef RegisteredPointSet::NodeNeighbors	NodeNeighbors
	Table of n-connected node neighbors.
Public Types inherited from mirtk::EnergyTerm
typedef ObjectFactory< enum EnergyMeasure, EnergyTerm >	FactoryType
	Type of energy term factory.
Static Public Member Functions inherited from mirtk::ExternalForce
static ExternalForce *	New (ExternalForceTerm, const char *="", double=1.0)
	Instantiate specified external force.
Static Public Member Functions inherited from mirtk::EnergyTerm
static FactoryType &	Factory ()
	Get global energy term factory instance.
static EnergyTerm *	New (EnergyMeasure, const char *="", double=1.0)
	Construct new energy term.
static EnergyTerm *	TryNew (EnergyMeasure, const char *="", double=1.0)
	Construct new energy term or return nullptr if term not available.
Static Public Member Functions inherited from mirtk::Object
static const char *	NameOfType ()
	Get name of this class type.
Static Protected Member Functions inherited from mirtk::Object
template<typename... Args>
static void	ThrowStatic (ErrorType err, const char *cls, const char *func, Args... args)

Detailed Description

Base class for external surface force terms

Subclasses implement in particular external forces for deformable surface models such as inflation/balloon forces and intensity edge forces. In case of a tetrahedral mesh, these forces only apply to the corresponding triangular surface of the simplicial complex boundary.

Definition at line 37 of file SurfaceForce.h.

Member Function Documentation

IntersectWithRay()

double mirtk::SurfaceForce::IntersectWithRay	(	const double	p[3],
		const double	e[3],
		double	l = .0
	)		const

Get distance to closest intersection with specified ray

Parameters

[in]	p	Ray starting point.
[in]	e	Ray direction.
[in]	l	Length of ray. When negative, a ray of length abs(l) is cast in the direction opposite to e.

Attention

This function is not thread-safe because the VTK cell locator used by this function is not thread-safe.

Returns

Distance to closest intersection with specified ray, clamped to maximum distance equal to length of ray l.

SelfDistance()

double mirtk::SurfaceForce::SelfDistance	(	const double	p[3],
		const double	n[3],
		double	maxd = .0
	)		const

Get self-distance value at given world position along specified direction

Parameters

[in]	p	Node position.
[in]	n	Node normal.
[in]	maxd	Maximum distance, length of rays cast in opposite directions.

Attention

This function is not thread-safe because the VTK cell locator used by this function is not thread-safe.

Returns

Distance to closest self-intersection along normal direction (two rays cast in opposing directions), clamped to maximum distance equal to length of rays l.

---

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

• SurfaceForce.h