This class is designed to facilitate the manipulation of parameters. More...

#include <Bpp/Numeric/Parameter.h>

Inheritance diagram for bpp::Parameter:

Collaboration diagram for bpp::Parameter:

Public Member Functions
	Parameter ()
	Default contructor. Creates a parameter with no name, no constraint, and a value of 0.
	Parameter (const std::string &name, double value, Constraint *constraint, bool attachConstraint, double precision=0) throw (ConstraintException)
	Build a new parameter.
	Parameter (const std::string &name, double value, const Constraint *constraint=0, double precision=0) throw (ConstraintException)
	Build a new parameter.
	Parameter (const Parameter &param)
	Copy constructor.
Parameter &	operator= (const Parameter &param)
	Assignment operator.
virtual	~Parameter ()
Parameter *	clone () const
	Create a copy of this object and send a pointer to it.
virtual void	setName (const std::string &name)
	Set the name of this parameter.
virtual void	setValue (double value) throw (ConstraintException)
	Set the value of this parameter.
void	setPrecision (double precision)
	Set the precision of this parameter.
virtual const std::string &	getName () const
	Get the name of this parameter.
virtual double	getValue () const
	Get the value of this parameter.
virtual double	getPrecision () const
	Get the precision of this parameter.
virtual const Constraint *	getConstraint () const
	Return the constraint associated to this parameter if there is one.
virtual Constraint *	getConstraint ()
	Return the constraint associated to this parameter if there is one.
virtual bool	hasConstraint () const
	Tells if this parameter has a constraint.
virtual const Constraint *	removeConstraint ()
	Remove the constraint associated to this parameter.
virtual void	setConstraint (Constraint *constraint, bool attach=false)
	Set a constraint to this parameter.
virtual void	addParameterListener (ParameterListener *listener, bool attachListener=true)
	Add a new listener to this parameter.
virtual void	removeParameterListener (const std::string &listenerId)
	Remove all listeners with a given id from this parameter.
virtual bool	hasParameterListener (const std::string &listenerId)
	Tell is there is a listener with a given id from this parameter.
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

This class is designed to facilitate the manipulation of parameters.

A parameter object contains a value stored as a double. It also contains a name and optionaly a constraint. Constraint objects allows to apply restriction on the value of the parameter, for instance positive number, or a particular interval and so on.

See also:: ParameterList, Parametrizable, Constraint.

Definition at line 135 of file Parameter.h.

Constructor & Destructor Documentation

bpp::Parameter::Parameter ( ) [inline]

Default contructor. Creates a parameter with no name, no constraint, and a value of 0.

Definition at line 152 of file Parameter.h.

Referenced by clone().

Parameter::Parameter	(	const std::string &	name,
		double	value,
		Constraint *	constraint,
		bool	attachConstraint,
		double	precision = `0`
	)		throw (ConstraintException)

Build a new parameter.

Parameters:

name	The parameter name.
value	The parameter value.
constraint	A pointer toward a constraint Object.
attachConstraint	Tell if the constraint must be attached to this parameter, or shared
precision	An optional parameter precision (default 0) between different objects (the default behavior, for backward compatibility). If the first case, the constraint object will be destroyed when the parameter is destroyed, and duplicated when the parameter is copied.

Exceptions:

ConstraintException If the parameter value does not match the contraint.

Constructors:

Definition at line 57 of file Parameter.cpp.

Parameter::Parameter	(	const std::string &	name,
		double	value,
		const Constraint *	constraint = `0`,
		double	precision = `0`
	)		throw (ConstraintException)

Build a new parameter.

Parameters:

name	The parameter name.
value	The parameter value.
constraint	An optional pointer toward a constraint Object. The constraint will be copied and attached to this instance.
precision	An optional parameter precision (default 0)

Exceptions:

ConstraintException If the parameter value does not match the contraint.

Definition at line 66 of file Parameter.cpp.

Parameter::Parameter ( const Parameter & param )

Copy constructor.

Definition at line 75 of file Parameter.cpp.

References attach_, bpp::Constraint::clone(), constraint_, listenerAttach_, and listeners_.

Parameter::~Parameter ( ) [virtual]

Destructor:

Definition at line 113 of file Parameter.cpp.

References attach_, constraint_, listenerAttach_, and listeners_.

Member Function Documentation

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

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 299 of file Parameter.h.

References listenerAttach_, and listeners_.

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

Parameter* bpp::Parameter::clone ( ) const [inline, virtual]

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

Returns:: A pointer toward the copy object.

Implements bpp::Clonable.

Reimplemented in bpp::PlaceboTransformedParameter, bpp::IntervalTransformedParameter, bpp::RTransformedParameter, bpp::AutoParameter, and bpp::TransformedParameter.

Definition at line 199 of file Parameter.h.

References Parameter().

Referenced by bpp::AbstractParameterAliasable::addParameter_(), and bpp::ParameterList::getCommonParametersWith().

void bpp::Parameter::fireParameterNameChanged ( ParameterEvent & event ) [inline, protected]

Definition at line 321 of file Parameter.h.

References listeners_.

Referenced by setName().

void bpp::Parameter::fireParameterValueChanged ( ParameterEvent & event ) [inline, protected]

Definition at line 326 of file Parameter.h.

References listeners_.

virtual const Constraint* bpp::Parameter::getConstraint ( ) const [inline, virtual]

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 constraint_.

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

virtual Constraint* bpp::Parameter::getConstraint ( ) [inline, virtual]

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 constraint_.

virtual const std::string& bpp::Parameter::getName ( ) const [inline, virtual]

Get the name of this parameter.

Returns:: The parameter name.

Definition at line 234 of file Parameter.h.

References name_.

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

virtual double bpp::Parameter::getPrecision ( ) const [inline, virtual]

Get the precision of this parameter.

Returns:: The precision value.

Definition at line 248 of file Parameter.h.

References precision_.

virtual double bpp::Parameter::getValue ( ) const [inline, virtual]

Get the value of this parameter.

Returns:: The parameter value.

Definition at line 241 of file Parameter.h.

References value_.

Referenced by 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().

virtual bool bpp::Parameter::hasConstraint ( ) const [inline, virtual]

Tells if this parameter has a constraint.

Returns:: True if this parameter has a contraint.

Definition at line 269 of file Parameter.h.

References constraint_.

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

bool Parameter::hasParameterListener ( const std::string & listenerId ) [virtual]

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 listeners_.

Parameter & Parameter::operator= ( const Parameter & param )

Assignment operator.

Definition at line 93 of file Parameter.cpp.

References attach_, bpp::Constraint::clone(), constraint_, listenerAttach_, listeners_, name_, precision_, and value_.

const Constraint * Parameter::removeConstraint ( ) [virtual]

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 constraint_.

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

void Parameter::removeParameterListener ( const std::string & listenerId ) [virtual]

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 listenerAttach_, and listeners_.

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

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

Returns:: A pointer toward the formerly used contraint.

Constraint:

Definition at line 143 of file Parameter.cpp.

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

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

virtual void bpp::Parameter::setName ( const std::string & name ) [inline, virtual]

Set the name of this parameter.

Parameters:

name	the new parameter name.

Definition at line 208 of file Parameter.h.

References fireParameterNameChanged(), and name_.

void Parameter::setPrecision ( double precision )

Set the precision of this parameter.

Parameters:

precision the new parameter precision.

Precision:

Definition at line 136 of file Parameter.cpp.

References precision_.

void Parameter::setValue ( double value ) throw (ConstraintException) [virtual]

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

bool bpp::Parameter::attach_ [protected]

Definition at line 143 of file Parameter.h.

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

Constraint* bpp::Parameter::constraint_ [protected]

Definition at line 142 of file Parameter.h.

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

std::vector<bool> bpp::Parameter::listenerAttach_ [protected]

Definition at line 145 of file Parameter.h.

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

std::vector<ParameterListener*> bpp::Parameter::listeners_ [protected]

Definition at line 144 of file Parameter.h.

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

std::string bpp::Parameter::name_ [protected]

Definition at line 139 of file Parameter.h.

Referenced by getName(), operator=(), and setName().

double bpp::Parameter::precision_ [protected]

Definition at line 141 of file Parameter.h.

Referenced by getPrecision(), operator=(), and setPrecision().

const IntervalConstraint Parameter::PROP_CONSTRAINT_EX [static]

Definition at line 338 of file Parameter.h.

const IntervalConstraint Parameter::PROP_CONSTRAINT_IN [static]

Definition at line 337 of file Parameter.h.

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

const IntervalConstraint Parameter::R_MINUS [static]

Definition at line 335 of file Parameter.h.

const IntervalConstraint Parameter::R_MINUS_STAR [static]

Definition at line 336 of file Parameter.h.

const IntervalConstraint Parameter::R_PLUS [static]

Definition at line 333 of file Parameter.h.

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

const IntervalConstraint Parameter::R_PLUS_STAR [static]

Definition at line 334 of file Parameter.h.

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

double bpp::Parameter::value_ [protected]

Definition at line 140 of file Parameter.h.

Referenced by getValue(), operator=(), and setConstraint().

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

Bpp/Numeric/Parameter.h
Bpp/Numeric/Parameter.cpp

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation