The TransformedParameter abstract class. More...

#include <Bpp/Numeric/TransformedParameter.h>

Inheritance diagram for bpp::TransformedParameter:

Collaboration diagram for bpp::TransformedParameter:

Public Member Functions
	TransformedParameter (const std::string &name, double value)

TransformedParameter *	clone () const =0
	Create a copy of this object and send a pointer to it. More...

virtual void	setOriginalValue (double value)=0 throw (ConstraintException)
	Set the value of the parameter using the orignal coordinate system. More...

virtual double	getOriginalValue () const =0

virtual double	getFirstOrderDerivative () const =0 throw (NotImplementedException)

virtual double	getSecondOrderDerivative () const =0 throw (NotImplementedException)

virtual void	setName (const std::string &name)
	Set the name of this parameter. More...

virtual void	setValue (double value) throw (ConstraintException)
	Set the value of this parameter. More...

void	setPrecision (double precision)
	Set the precision of this parameter. More...

virtual const std::string &	getName () const
	Get the name of this parameter. More...

virtual double	getValue () const
	Get the value of this parameter. More...

virtual double	getPrecision () const
	Get the precision of this parameter. More...

virtual const Constraint *	getConstraint () const
	Return the constraint associated to this parameter if there is one. More...

virtual Constraint *	getConstraint ()
	Return the constraint associated to this parameter if there is one. More...

virtual bool	hasConstraint () const
	Tells if this parameter has a constraint. More...

virtual const Constraint *	removeConstraint ()
	Remove the constraint associated to this parameter. More...

virtual void	setConstraint (Constraint *constraint, bool attach=false)
	Set a constraint to this parameter. More...

virtual void	addParameterListener (ParameterListener *listener, bool attachListener=true)
	Add a new listener to this parameter. More...

virtual void	removeParameterListener (const std::string &listenerId)
	Remove all listeners with a given id from this parameter. More...

virtual bool	hasParameterListener (const std::string &listenerId)
	Tell is there is a listener with a given id from this parameter. More...

Static Public Attributes
static const IntervalConstraint	R_PLUS

static const IntervalConstraint	R_PLUS_STAR

static const IntervalConstraint	R_MINUS

static const IntervalConstraint	R_MINUS_STAR

static const IntervalConstraint	PROP_CONSTRAINT_IN

static const IntervalConstraint	PROP_CONSTRAINT_EX

Protected Member Functions
void	fireParameterNameChanged (ParameterEvent &event)

void	fireParameterValueChanged (ParameterEvent &event)

Protected Attributes
std::string	name_

double	value_

double	precision_

Constraint *	constraint_

bool	attach_

std::vector< ParameterListener * >	listeners_

std::vector< bool >	listenerAttach_

Detailed Description

The TransformedParameter abstract class.

This class extends the Parameter class. A transformed parameter does not have a constraint attached to it, and is supposed to range from -inf to +inf. It uses a transformation in order to do this, typically using a bijection. The exact function used to achieve the transformation depends on the implementation of the interface.

Definition at line 59 of file TransformedParameter.h.

Constructor & Destructor Documentation

◆ TransformedParameter()

bpp::TransformedParameter::TransformedParameter	(	const std::string &	name,
		double	value
	)

inline

Definition at line 63 of file TransformedParameter.h.

Member Function Documentation

◆ addParameterListener()

virtual void bpp::Parameter::addParameterListener	(	ParameterListener *	listener,
		bool	attachListener = `true`
	)

inlinevirtualinherited

Add a new listener to this parameter.

Parameters

listener	The listener to add.
attachListener	Tell if the parameter will own this listener. If so, deep copies will be made when cloning the parameter, and the listener will be destroyed upon destruction of the parameter or upon removal. Alternatively, only superficial copies will be made, and the listener will persist if the parameter is destroyed.

Definition at line 298 of file Parameter.h.

References bpp::Parameter::listenerAttach_, and bpp::Parameter::listeners_.

Referenced by bpp::AbstractParameterAliasable::aliasParameters().

◆ clone()

TransformedParameter* bpp::TransformedParameter::clone ( ) const

pure virtual

Create a copy of this object and send a pointer to it.

Returns: A pointer toward the copy object.

Reimplemented from bpp::Parameter.

Implemented in bpp::PlaceboTransformedParameter, bpp::IntervalTransformedParameter, and bpp::RTransformedParameter.

◆ fireParameterNameChanged()

void bpp::Parameter::fireParameterNameChanged ( ParameterEvent & event )

inlineprotectedinherited

Definition at line 320 of file Parameter.h.

References bpp::Parameter::listeners_.

Referenced by bpp::Parameter::setName().

◆ fireParameterValueChanged()

void bpp::Parameter::fireParameterValueChanged ( ParameterEvent & event )

inlineprotectedinherited

Definition at line 325 of file Parameter.h.

References bpp::Parameter::listeners_.

◆ getConstraint() [1/2]

virtual const Constraint* bpp::Parameter::getConstraint ( ) const

inlinevirtualinherited

Return the constraint associated to this parameter if there is one.

Returns: A pointer toward the constraint, or NULL if there is no constraint.

Definition at line 255 of file Parameter.h.

References bpp::Parameter::constraint_.

Referenced by bpp::AbstractParameterAliasable::aliasParameters(), bpp::ReparametrizationFunctionWrapper::init_(), bpp::ParameterList::matchParametersValues(), bpp::ParameterList::setParametersValues(), and bpp::ParameterList::testParametersValues().

◆ getConstraint() [2/2]

virtual Constraint* bpp::Parameter::getConstraint ( )

inlinevirtualinherited

Return the constraint associated to this parameter if there is one.

Returns: A pointer toward the constraint, or NULL if there is no constraint.

Definition at line 262 of file Parameter.h.

References bpp::Parameter::constraint_.

◆ getFirstOrderDerivative()

virtual double bpp::TransformedParameter::getFirstOrderDerivative	(		)	const
throw	(	NotImplementedException
	)

pure virtual

Returns: The first order derivative of the transformation at the original point.

Exceptions

NotImplementedException if the transformation does not support derivation or if the derivation was not implemented.

Implemented in bpp::PlaceboTransformedParameter, bpp::IntervalTransformedParameter, and bpp::RTransformedParameter.

◆ getName()

virtual const std::string& bpp::Parameter::getName ( ) const

inlinevirtualinherited

Get the name of this parameter.

Returns: The parameter name.

Definition at line 234 of file Parameter.h.

References bpp::Parameter::name_.

Referenced by bpp::ParameterList::deleteParameter(), bpp::AbstractParameterAliasable::deleteParameter_(), bpp::FullHmmTransitionMatrix::FullHmmTransitionMatrix(), bpp::ParameterList::getCommonParametersWith(), bpp::ParametersStopCondition::getCurrentTolerance(), bpp::NumCalcApplicationTools::getDefaultValue(), bpp::ParameterList::getParameter(), bpp::ParameterList::getParameterValue(), bpp::ParameterList::hasParameter(), bpp::ReparametrizationFunctionWrapper::init_(), bpp::ParametersStopCondition::isToleranceReached(), bpp::AliasParameterListener::parameterValueChanged(), and bpp::FullHmmTransitionMatrix::setTransitionProbabilities().

◆ getOriginalValue()

virtual double bpp::TransformedParameter::getOriginalValue ( ) const

pure virtual

Returns: The current value of the parameter in orignal coordinates.

Implemented in bpp::PlaceboTransformedParameter, bpp::IntervalTransformedParameter, and bpp::RTransformedParameter.

◆ getPrecision()

virtual double bpp::Parameter::getPrecision ( ) const

inlinevirtualinherited

Get the precision of this parameter.

Returns: The precision value.

Definition at line 248 of file Parameter.h.

References bpp::Parameter::precision_.

◆ getSecondOrderDerivative()

virtual double bpp::TransformedParameter::getSecondOrderDerivative	(		)	const
throw	(	NotImplementedException
	)

pure virtual

Returns: The second order derivative of the transformation at the original point.

Exceptions

NotImplementedException if the transformation does not support derivation or if the derivation was not implemented.

Implemented in bpp::PlaceboTransformedParameter, bpp::IntervalTransformedParameter, and bpp::RTransformedParameter.

◆ getValue()

virtual double bpp::Parameter::getValue ( ) const

inlinevirtualinherited

Get the value of this parameter.

Returns: The parameter value.

Definition at line 241 of file Parameter.h.

References bpp::Parameter::value_.

Referenced by bpp::AbstractParameterAliasable::aliasParameters(), bpp::ParametersStopCondition::getCurrentTolerance(), bpp::NumCalcApplicationTools::getDefaultValue(), bpp::RTransformedParameter::getFirstOrderDerivative(), bpp::IntervalTransformedParameter::getFirstOrderDerivative(), bpp::RTransformedParameter::getOriginalValue(), bpp::IntervalTransformedParameter::getOriginalValue(), bpp::PlaceboTransformedParameter::getOriginalValue(), bpp::AbstractParametrizable::getParameterValue(), bpp::ParameterList::getParameterValue(), bpp::RTransformedParameter::getSecondOrderDerivative(), bpp::IntervalTransformedParameter::getSecondOrderDerivative(), bpp::TestFunction::getValue(), bpp::ReparametrizationFunctionWrapper::init_(), bpp::ParametersStopCondition::isToleranceReached(), bpp::ParameterList::matchParametersValues(), bpp::ParameterList::setAllParametersValues(), bpp::ParameterList::setParametersValues(), and bpp::ParameterList::testParametersValues().

◆ hasConstraint()

virtual bool bpp::Parameter::hasConstraint ( ) const

inlinevirtualinherited

Tells if this parameter has a constraint.

Returns: True if this parameter has a contraint.

Definition at line 269 of file Parameter.h.

References bpp::Parameter::constraint_.

Referenced by bpp::AbstractParameterAliasable::aliasParameters(), bpp::ParameterList::matchParametersValues(), bpp::ParameterList::setParametersValues(), and bpp::ParameterList::testParametersValues().

◆ hasParameterListener()

bool Parameter::hasParameterListener ( const std::string & listenerId )

virtualinherited

Tell is there is a listener with a given id from this parameter.

Parameters

listenerId The id of listener to remove.

Returns: True if at list one listener with the given id was found.

Definition at line 187 of file Parameter.cpp.

References bpp::Parameter::listeners_.

◆ removeConstraint()

const Constraint * Parameter::removeConstraint ( )

virtualinherited

Remove the constraint associated to this parameter.

Warning! The contraint objet is not deleted.

Returns: A pointer toward the formerly used contraint.

Definition at line 163 of file Parameter.cpp.

References bpp::Parameter::constraint_.

Referenced by bpp::SimpleDiscreteDistribution::restrictToConstraint().

◆ removeParameterListener()

void Parameter::removeParameterListener ( const std::string & listenerId )

virtualinherited

Remove all listeners with a given id from this parameter.

Parameters

listenerId The id of listener to remove.

Definition at line 172 of file Parameter.cpp.

References bpp::Parameter::listenerAttach_, and bpp::Parameter::listeners_.

◆ setConstraint()

void Parameter::setConstraint	(	Constraint *	constraint,
		bool	attach = `false`
	)

virtualinherited

Set a constraint to this parameter.

Parameters

constraint	a pointer to the constraint (may be null)
attach	says if the constraint is attached to the Parameter (default: false).

Constraint:

Definition at line 143 of file Parameter.cpp.

References bpp::Parameter::attach_, bpp::Parameter::constraint_, bpp::Constraint::isCorrect(), and bpp::Parameter::value_.

Referenced by bpp::ConstantDistribution::restrictToConstraint(), bpp::TruncatedExponentialDiscreteDistribution::restrictToConstraint(), and bpp::SimpleDiscreteDistribution::restrictToConstraint().

◆ setName()

virtual void bpp::Parameter::setName ( const std::string & name )

inlinevirtualinherited

Set the name of this parameter.

Parameters

name	the new parameter name.

Definition at line 208 of file Parameter.h.

References bpp::Parameter::fireParameterNameChanged(), and bpp::Parameter::name_.

Referenced by bpp::ParametrizableCollection< N >::addObject(), bpp::FullHmmTransitionMatrix::FullHmmTransitionMatrix(), and bpp::FullHmmTransitionMatrix::setTransitionProbabilities().

◆ setOriginalValue()

virtual void bpp::TransformedParameter::setOriginalValue	(	double	value	)
throw	(	ConstraintException
	)

pure virtual

Set the value of the parameter using the orignal coordinate system.

Parameters

value Parameter value in original coordinates.

Exceptions

ConstraintException if the value is not correct.

Implemented in bpp::PlaceboTransformedParameter, bpp::IntervalTransformedParameter, and bpp::RTransformedParameter.

Referenced by bpp::RTransformedParameter::RTransformedParameter().

◆ setPrecision()

void Parameter::setPrecision ( double precision )

inherited

Set the precision of this parameter.

Parameters

precision the new parameter precision.

Precision:

Definition at line 136 of file Parameter.cpp.

References bpp::Parameter::precision_.

◆ setValue()

void Parameter::setValue	(	double	value	)
throw	(	ConstraintException
	)

virtualinherited

Set the value of this parameter.

Parameters

value the new parameter value.

Value:

Reimplemented in bpp::AutoParameter.

Definition at line 123 of file Parameter.cpp.

Referenced by bpp::NewtonBacktrackOneDimension::doStep(), bpp::GoldenSectionSearch::doStep(), bpp::BrentOneDimension::doStep(), bpp::ReparametrizationFunctionWrapper::fireParameterChanged(), bpp::ParameterList::matchParametersValues(), bpp::AliasParameterListener::parameterValueChanged(), bpp::ParameterList::setAllParametersValues(), bpp::RTransformedParameter::setOriginalValue(), bpp::IntervalTransformedParameter::setOriginalValue(), bpp::PlaceboTransformedParameter::setOriginalValue(), bpp::ParameterList::setParametersValues(), bpp::ParameterList::setParameterValue(), and bpp::AutoParameter::setValue().

Member Data Documentation

◆ attach_

bool bpp::Parameter::attach_

protectedinherited

Definition at line 143 of file Parameter.h.

Referenced by bpp::Parameter::operator=(), bpp::Parameter::Parameter(), bpp::Parameter::setConstraint(), and bpp::Parameter::~Parameter().

◆ constraint_

Constraint* bpp::Parameter::constraint_

protectedinherited

Definition at line 142 of file Parameter.h.

Referenced by bpp::Parameter::getConstraint(), bpp::Parameter::hasConstraint(), bpp::Parameter::operator=(), bpp::Parameter::Parameter(), bpp::Parameter::removeConstraint(), bpp::Parameter::setConstraint(), and bpp::Parameter::~Parameter().

◆ listenerAttach_

std::vector<bool> bpp::Parameter::listenerAttach_

protectedinherited

Definition at line 145 of file Parameter.h.

Referenced by bpp::Parameter::addParameterListener(), bpp::Parameter::operator=(), bpp::Parameter::Parameter(), bpp::Parameter::removeParameterListener(), and bpp::Parameter::~Parameter().

◆ listeners_

std::vector<ParameterListener*> bpp::Parameter::listeners_

protectedinherited

Definition at line 144 of file Parameter.h.

Referenced by bpp::Parameter::addParameterListener(), bpp::Parameter::fireParameterNameChanged(), bpp::Parameter::fireParameterValueChanged(), bpp::Parameter::hasParameterListener(), bpp::Parameter::operator=(), bpp::Parameter::Parameter(), bpp::Parameter::removeParameterListener(), and bpp::Parameter::~Parameter().

◆ name_

std::string bpp::Parameter::name_

protectedinherited

Definition at line 139 of file Parameter.h.

Referenced by bpp::Parameter::getName(), bpp::Parameter::operator=(), and bpp::Parameter::setName().

◆ precision_

double bpp::Parameter::precision_

protectedinherited

Definition at line 141 of file Parameter.h.

Referenced by bpp::Parameter::getPrecision(), bpp::Parameter::operator=(), and bpp::Parameter::setPrecision().

◆ PROP_CONSTRAINT_EX

const IntervalConstraint Parameter::PROP_CONSTRAINT_EX

staticinherited

Definition at line 337 of file Parameter.h.

Referenced by bpp::AutoCorrelationTransitionMatrix::AutoCorrelationTransitionMatrix(), and bpp::Simplex::Simplex().

◆ PROP_CONSTRAINT_IN

const IntervalConstraint Parameter::PROP_CONSTRAINT_IN

staticinherited

Definition at line 336 of file Parameter.h.

Referenced by bpp::InvariantMixedDiscreteDistribution::InvariantMixedDiscreteDistribution(), bpp::MixtureOfDiscreteDistributions::MixtureOfDiscreteDistributions(), bpp::SimpleDiscreteDistribution::SimpleDiscreteDistribution(), and bpp::Simplex::Simplex().

◆ R_MINUS

const IntervalConstraint Parameter::R_MINUS

staticinherited

Definition at line 334 of file Parameter.h.

◆ R_MINUS_STAR

const IntervalConstraint Parameter::R_MINUS_STAR

staticinherited

Definition at line 335 of file Parameter.h.

◆ R_PLUS

const IntervalConstraint Parameter::R_PLUS

staticinherited

Definition at line 332 of file Parameter.h.

Referenced by bpp::ExponentialDiscreteDistribution::ExponentialDiscreteDistribution(), and bpp::TruncatedExponentialDiscreteDistribution::TruncatedExponentialDiscreteDistribution().

◆ R_PLUS_STAR

const IntervalConstraint Parameter::R_PLUS_STAR

staticinherited

Definition at line 333 of file Parameter.h.

Referenced by bpp::GaussianDiscreteDistribution::GaussianDiscreteDistribution().

◆ value_

double bpp::Parameter::value_

protectedinherited

Definition at line 140 of file Parameter.h.

Referenced by bpp::Parameter::getValue(), bpp::Parameter::operator=(), and bpp::Parameter::setConstraint().

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

Bpp/Numeric/TransformedParameter.h

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ TransformedParameter()

Member Function Documentation

◆ addParameterListener()

◆ clone()

◆ fireParameterNameChanged()

◆ fireParameterValueChanged()

◆ getConstraint() [1/2]

◆ getConstraint() [2/2]

◆ getFirstOrderDerivative()

◆ getName()

◆ getOriginalValue()

◆ getPrecision()

◆ getSecondOrderDerivative()

◆ getValue()

◆ hasConstraint()

◆ hasParameterListener()

◆ removeConstraint()

◆ removeParameterListener()

◆ setConstraint()

◆ setName()

◆ setOriginalValue()

◆ setPrecision()

◆ setValue()

Member Data Documentation

◆ attach_

◆ constraint_

◆ listenerAttach_

◆ listeners_

◆ name_

◆ precision_

◆ PROP_CONSTRAINT_EX

◆ PROP_CONSTRAINT_IN

◆ R_MINUS

◆ R_MINUS_STAR

◆ R_PLUS

◆ R_PLUS_STAR

◆ value_