#include <FunctionBase.h>
Inheritance diagram for FunctionBase:
This is the base class for functions that can be added to a DataRep and used by a fitter. The initial value of the functions parameters can be set by a call to the initialParameters() member function. This function takes as argument a FunctionHelper which maybe connected to the data set. The function can make calls to the FunctionHelper to get some summaries from the data set and make an estimate of parameter values so that the function will at least appear on the DataRep if not come close to fitting it. This function must be implemented in a derived class.
The value of the function at a given value of the one dimensional coordinate x
, or multi-dimensional coordinates as vector of doubles is obtained by a call to the overloaded member function operator()(). This function must be implemented in a derived class.
To support a user interface, the name of the function may be obtained by a call to the name() member function and the name of the function's parameters from the parmNames() member function. The values of the function's parameters can be obtained by a call to the getParameters() member function. The number of parameters can be obtained by the size member function.
Internally, setting and receiving the parameters described above is done by the functions that take an iterator as an argument. The iterator skips over fixed parameters in both setting and receiving functions. This architecture is used to support the derived class LinearSumFunction.
Derived classes need to implement a few pure virtual functions defined by this class.
Definition at line 92 of file FunctionBase.h.
Public Member Functions | |
virtual void | addToComposite (FunctionBase *) |
Does nothing. | |
virtual FunctionBase * | clone () const |
Creates a new function object by copying an existing one. | |
virtual int | count () |
Returns 0. | |
virtual double | derivByParm (int i, double x) const |
Returns the function's derivative at the coordinate value x with respect to the i-th parameter. | |
virtual const std::vector< double > & | getParameters () |
Returns the values of the parameters as a vector. | |
virtual bool | hasDerivatives () const |
Returns true if function can calculate its partial derivatives. | |
virtual void | initialParameters (const FunctionHelper *helper) |
Sets the FunctionHelper so that the function can calculate a reasonable set of initial parameter values. | |
virtual double | integrate (double lower_limit, double upper_limit) const |
Returns the integral of the function from the lower limit to the higher limit. | |
virtual bool | isComposite () const |
Returns false . | |
const std::string & | name () const |
Returns the name of the function. | |
virtual double | operator() (const std::vector< double > &v) const |
The function call operator for multi-dimension coordinate variable. | |
virtual double | operator() (double x) const |
The function call operator. | |
virtual const std::vector< std::string > & | parmNames () const |
Returns a reference to a vector of parameter names. | |
virtual void | removeFromComposite (FunctionBase *) |
Does nothing. | |
virtual std::vector< double >::const_iterator | setParameters (std::vector< double >::const_iterator it) |
Sets the parameter values to the value pointed to by the iterator. | |
virtual void | setParameters (const std::vector< double > &incr) |
Sets the parameter values. | |
void | setParmNames (const std::vector< std::string > &names) |
Sets the names of the parameters. | |
virtual int | size () const |
Returns the number of parameters. | |
virtual | ~FunctionBase () |
The virtual destructor. | |
Protected Member Functions | |
FunctionBase (const FunctionBase &) | |
The copy constructor. | |
FunctionBase () | |
The default constructor. | |
virtual void | initialize () |
Initializes the function and parameter names. | |
virtual void | resize () |
Resizes the appropriate vectors maintained in this base class. | |
void | setName (const char *) |
Sets the name of the function. | |
Protected Attributes | |
std::string | m_name |
The name of the function. | |
std::vector< std::string > | m_parm_names |
The names of the function parameters. | |
std::vector< double > | m_parms |
The parameter values. |
|
The default constructor. . Sets the function name to "nil". Should be overriden by derived class. If function name is "nil", then that indicated error condition that default constructor was called directly. Definition at line 31 of file FunctionBase.cxx. References m_name. |
|
The copy constructor.
Definition at line 40 of file FunctionBase.cxx. |
|
The virtual destructor.
Definition at line 47 of file FunctionBase.cxx. |
|
Does nothing. Derived classes that are a composite of functions should override this member function and add functions to the composite. Reimplemented in LinearSumFunction. Definition at line 160 of file FunctionBase.cxx. Referenced by FunctionController::addFunctionRep(), and FunctionController::buildComposite(). |
|
Creates a new function object by copying an existing one. The implementation raises an assertion as this member function should be reimplemented in s derived class.
Reimplemented in BrokenPowerLaw, Chi2Dist, ConstantF, Erfc, Exponential, Gaussian, Landau, Linear, LinearSumFunction, LogNormal, PowerLaw, Quadratic, Quadratic2, and FunctionWrap. Definition at line 53 of file FunctionBase.cxx. |
|
Returns 0. Derived classes that are a composite of functions should override this member function to return the number of functions in the composite. Reimplemented in LinearSumFunction. Definition at line 168 of file FunctionBase.cxx. Referenced by FunctionController::removeFunction(). |
|
Returns the function's derivative at the coordinate value Derived classes must implement this function.
Reimplemented in BrokenPowerLaw, Chi2Dist, ConstantF, Erfc, Exponential, Gaussian, Landau, Linear, LinearSumFunction, LogNormal, PowerLaw, Quadratic, Quadratic2, and FunctionWrap. Definition at line 184 of file FunctionBase.cxx. |
|
Returns the values of the parameters as a vector. The function is non-const because a derived class may need to create the vector. Reimplemented in LinearSumFunction. Definition at line 99 of file FunctionBase.cxx. References m_parms. Referenced by FunctionProjectorXML::createElement(), FuncParmRep::drawProjectedValues(), hippodraw::Python::export_FunctionBase(), FunctionRep::parameters(), FunctionProjector::saveParameters(), and FunctionProjector::setParameters(). |
|
Returns
This base class implementation returns Reimplemented in LogNormal. Definition at line 124 of file FunctionBase.cxx. |
|
Initializes the function and parameter names. The derived classes should initialize their names and the vector of parameter names and then invoke the resize() member function.
Reimplemented in BrokenPowerLaw, Chi2Dist, ConstantF, Erfc, Exponential, Gaussian, Landau, Linear, LinearSumFunction, LogNormal, PowerLaw, Quadratic, Quadratic2, and FunctionWrap. Definition at line 192 of file FunctionBase.cxx. |
|
Sets the FunctionHelper so that the function can calculate a reasonable set of initial parameter values.
Reimplemented in BrokenPowerLaw, Chi2Dist, ConstantF, Erfc, Exponential, Gaussian, Landau, Linear, LinearSumFunction, LogNormal, PowerLaw, Quadratic, Quadratic2, and FunctionWrap. Definition at line 60 of file FunctionBase.cxx. Referenced by FunctionProjector::initializeFunction(). |
|
Returns the integral of the function from the lower limit to the higher limit. As of now all the integration is done here numerically using the trapezoidal rule. Derived class may implement an analytical expression in place of this numerical method. Definition at line 132 of file FunctionBase.cxx. References operator()(). |
|
Returns
Derived classes that are a composite of functions should override this member function and return Reimplemented in LinearSumFunction. Definition at line 155 of file FunctionBase.cxx. Referenced by FunctionController::addFunctionRep(), FunctionRep::isComposite(), FunctionController::removeFunction(), FunctionController::restoreParameters(), and FunctionController::saveParameters(). |
|
Returns the name of the function.
Definition at line 81 of file FunctionBase.cxx. References m_name. Referenced by FunctionController::addFunctionRep(), FunctionProjectorXML::createElement(), FunctionController::createNTuple(), FuncParmRep::drawProjectedValues(), hippodraw::Python::export_FunctionBase(), FunctionController::functionNames(), FunctionProjector::getTitle(), FunctionProjector::getYLabel(), and LinearSumFunction::parmNames(). |
|
The function call operator for multi-dimension coordinate variable. Returns the value of the function at coordinate represented by v. The implementation in this base class uses the first element of the vector and calls operator () ( double ). Reimplemented in FunctionWrap. Definition at line 175 of file FunctionBase.cxx. References operator()(). |
|
The function call operator.
Reimplemented in BrokenPowerLaw, Chi2Dist, ConstantF, Erfc, Exponential, Gaussian, Landau, Linear, LinearSumFunction, LogNormal, PowerLaw, Quadratic, Quadratic2, and FunctionWrap. Definition at line 199 of file FunctionBase.cxx. Referenced by integrate(), and operator()(). |
|
Returns a reference to a vector of parameter names.
Reimplemented in LinearSumFunction. Definition at line 86 of file FunctionBase.cxx. References m_parm_names. Referenced by FuncParmRep::drawProjectedValues(), hippodraw::Python::export_FunctionBase(), and FunctionRep::parmNames(). |
|
Does nothing. Derived classes that are a composite of functions should override this member function and remove functions from the composite. Reimplemented in LinearSumFunction. Definition at line 164 of file FunctionBase.cxx. Referenced by FunctionController::removeFunction(). |
|
Resizes the appropriate vectors maintained in this base class. Derived classes should call this member function after initializing the m_parm_names data member, as the new size is taken from that data member's size. Definition at line 71 of file FunctionBase.cxx. References m_parm_names, m_parms, and size(). Referenced by Quadratic2::initialize(), Quadratic::initialize(), PowerLaw::initialize(), LogNormal::initialize(), Linear::initialize(), Landau::initialize(), Gaussian::initialize(), FunctionWrap::initialize(), Exponential::initialize(), Erfc::initialize(), ConstantF::initialize(), Chi2Dist::initialize(), BrokenPowerLaw::initialize(), FunctionWrap::setParmNames(), and setParmNames(). |
|
Sets the name of the function.
Definition at line 66 of file FunctionBase.cxx. References m_name. Referenced by FunctionWrap::setName(). |
|
Sets the parameter values to the value pointed to by the iterator. Returns an iterator to a data element one past the last used data element. Reimplemented in LinearSumFunction. Definition at line 112 of file FunctionBase.cxx. |
|
Sets the parameter values. Derived classes should implement this function by invoking incrementValues ( vector< double >::const_iterator ) so that they correctly work with the LinearSumFunction class. Definition at line 104 of file FunctionBase.cxx. Referenced by hippodraw::Python::export_FunctionBase(), FunctionProjector::restoreParameters(), FunctionProjectorXML::setAttributes(), and FunctionProjector::setParameters(). |
|
Sets the names of the parameters.
Reimplemented in FunctionWrap. Definition at line 93 of file FunctionBase.cxx. References m_parm_names, and resize(). |
|
Returns the number of parameters.
Reimplemented in LinearSumFunction. Definition at line 150 of file FunctionBase.cxx. References m_parm_names. Referenced by LogNormal::initialParameters(), Gaussian::initialParameters(), resize(), FunctionProjectorXML::setAttributes(), and setParameters(). |
|
The name of the function.
Definition at line 105 of file FunctionBase.h. Referenced by FunctionBase(), Quadratic2::initialize(), Quadratic::initialize(), PowerLaw::initialize(), LogNormal::initialize(), LinearSumFunction::initialize(), Linear::initialize(), Landau::initialize(), Gaussian::initialize(), Exponential::initialize(), Erfc::initialize(), ConstantF::initialize(), Chi2Dist::initialize(), BrokenPowerLaw::initialize(), name(), and setName(). |
|
The names of the function parameters.
Definition at line 108 of file FunctionBase.h. Referenced by Quadratic2::initialize(), Quadratic::initialize(), PowerLaw::initialize(), LogNormal::initialize(), Linear::initialize(), Landau::initialize(), Gaussian::initialize(), Exponential::initialize(), Erfc::initialize(), ConstantF::initialize(), Chi2Dist::initialize(), BrokenPowerLaw::initialize(), LinearSumFunction::parmNames(), parmNames(), resize(), FunctionWrap::setParmNames(), setParmNames(), and size(). |
|