#include <SparsityConstraint.h>

Inheritance diagram for mirtk::SparsityConstraint:

Collaboration diagram for mirtk::SparsityConstraint:

Public Member Functions
void	Gradient (double gradient, double step, bool sgn_chg=NULL)

virtual void	GradientStep (const double *gradient, double &min, double &max) const

	SparsityConstraint (const char *="")
	Constructor.

Public Member Functions inherited from mirtk::TransformationConstraint
virtual ParameterList	Parameter () const
	Get parameter name/value pairs.

virtual	~TransformationConstraint ()
	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	Initialize ()
	Initialize energy term once input and parameters have been set.

double	InitialValue ()
	Returns initial value of energy term.

void	NormalizedGradient (double *gradient, double step)

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 void	Update (bool gradient=true)

virtual bool	Upgrade ()
	Update energy term after convergence.

double	Value ()
	Evaluate energy term.

virtual void	WriteDataSets (const char , const char , bool=true) const
	Write input of data fidelity term.

virtual void	WriteGradient (const char , const char ) const
	Write gradient of data fidelity term w.r.t each transformed input.

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
virtual double	Evaluate ()
	Compute penalty for current transformation estimate.

virtual void	EvaluateGradient (double *, double, double)
	Compute gradient of penalty term w.r.t transformation parameters.

virtual void	EvaluateGradient (double , double, double, bool )
	Compute gradient of penalty term w.r.t transformation parameters.

Protected Member Functions inherited from mirtk::TransformationConstraint
const FreeFormTransformation *	FFD () const
	Get transformation as free-form deformation or NULL if it is none.

const MultiLevelTransformation *	MFFD () const
	Get transformation as multi-level transformation or NULL if it is none.

TransformationConstraint &	operator= (const TransformationConstraint &)
	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.

template<class TransformationType >
const TransformationType *	TransformationAs () const
	Get transformation as specific type or NULL if dynamic cast fails.

	TransformationConstraint (const char *="", double=1.0)
	Constructor.

	TransformationConstraint (const TransformationConstraint &)
	Copy constructor.

void	WriteFFDGradient (const char , const FreeFormTransformation , const double *) const
	Write gradient of penalty term w.r.t. control point parameters.

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.

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::EnergyTerm
typedef ObjectFactory< enum EnergyMeasure, EnergyTerm >	FactoryType
	Type of energy term factory.

Static Public Member Functions inherited from mirtk::TransformationConstraint
static TransformationConstraint *	New (ConstraintMeasure, const char *="", double=1.0)
	Instantiate new transformation constraint of given kind.

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

Sparsity contraint based on L1 norm of transformation parameters

Wenzhe Shi et al., Registration using sparse free-form deformations, MICCAI 2012

See also: http://link.springer.com/chapter/10.1007%2F978-3-642-33418-4_81

Definition at line 37 of file SparsityConstraint.h.

Member Function Documentation

§ Gradient()

void mirtk::SparsityConstraint::Gradient	(	double *	gradient,
		double	step,
		bool *	sgn_chg = `NULL`
	)

Evaluate gradient of energy term

Parameters

[in,out]	gradient	Gradient to which the evaluated gradient of this energy term is added to with its resp. weight.
[in]	step	Step length for finite differences (unused).
[out]	sgn_chg	Whether sign change of parameter should be allowed.

§ GradientStep()

virtual void mirtk::SparsityConstraint::GradientStep	(	const double *	gradient,
		double &	min,
		double &	max
	)		const

virtual

Adjust step length range

Parameters

[in]	gradient	Gradient of objective function.
[in,out]	min	Minimum step length.
[in,out]	max	Maximum step length.

Reimplemented from mirtk::EnergyTerm.

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

SparsityConstraint.h

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

§ Gradient()

§ GradientStep()