template<class T>
class ROOT::Math::WrappedMultiTF1Templ< T >

Class to Wrap a ROOT Function class (like TF1) in a IParamMultiFunction interface of multi-dimensions to be used in the ROOT::Math numerical algorithm.

This wrapper class does not own the TF1 pointer, so it assumes it exists during the wrapper lifetime. The class copy the TF1 pointer only when it owns it.

The class from ROOT version 6.03 does not contain anymore a copy of the parameters. The parameters are stored in the TF1 class.

Definition at line 47 of file WrappedMultiTF1.h.

Public Types
typedef ROOT::Math::IParametricFunctionMultiDimTempl< T >::BaseFunc	BaseFunc

typedef ROOT::Math::IParametricGradFunctionMultiDimTempl< T >	BaseParamFunc

Public Types inherited from ROOT::Math::IParametricGradFunctionMultiDimTempl< T >
using	BaseFunc = typename IParametricFunctionMultiDimTempl< T >::BaseFunc

using	BaseGradFunc = IGradientFunctionMultiDimTempl< T >

using	BaseParamFunc = IParametricFunctionMultiDimTempl< T >

Public Types inherited from ROOT::Math::IParametricFunctionMultiDimTempl< T >
typedef IBaseFunctionMultiDimTempl< T >	BaseFunc

Public Types inherited from ROOT::Math::IBaseFunctionMultiDimTempl< T >
typedef T	BackendType

typedef IBaseFunctionMultiDimTempl< T >	BaseFunc

Public Member Functions
	WrappedMultiTF1Templ (const WrappedMultiTF1Templ< T > &rhs)
	Copy constructor.

	WrappedMultiTF1Templ (TF1 &f, unsigned int dim=0)
	constructor from a function pointer to a TF1 If dim = 0 dimension is taken from TF1::GetNdim().

	~WrappedMultiTF1Templ ()
	Destructor (no operations).

WrappedMultiTF1Templ &	operator= (const WrappedMultiTF1Templ< T > &rhs)
	Assignment operator.

Public Member Functions inherited from ROOT::Math::IParametricGradFunctionMultiDimTempl< T >
virtual	~IParametricGradFunctionMultiDimTempl ()
	Virtual Destructor (no operations)

T	operator() (const T *x) const

T	operator() (const T x, const double p) const

T	ParameterDerivative (const T x, const double p, unsigned int ipar=0) const
	Evaluate the partial derivative w.r.t a parameter ipar from values and parameters.

T	ParameterDerivative (const T *x, unsigned int ipar=0) const
	Evaluate partial derivative using cached parameter values.

void	ParameterGradient (const T x, T grad) const
	Evaluate all derivatives using cached parameter values.

Public Member Functions inherited from ROOT::Math::IParametricFunctionMultiDimTempl< T >
T	operator() (const T *x) const

T	operator() (const T x, const double p) const
	Evaluate function at a point x and for given parameters p.

Public Member Functions inherited from ROOT::Math::IBaseFunctionMultiDimTempl< T >
	IBaseFunctionMultiDimTempl ()

virtual	~IBaseFunctionMultiDimTempl ()
	virtual destructor

T	operator() (const T *x) const
	Evaluate the function at a point x[].

Public Member Functions inherited from ROOT::Math::IBaseParam
virtual	~IBaseParam ()
	Virtual Destructor (no operations)

interface inherited from IParamFunction
bool	fLinear

bool	fPolynomial

bool	fOwnFunc

TF1 *	fFunc

unsigned int	fDim

IMultiGenFunctionTempl< T > *	Clone () const
	Clone the wrapper but not the original function.

unsigned int	NDim () const
	Retrieve the dimension of the function.

const double *	Parameters () const
	get the parameter values (return values from TF1)

void	SetParameters (const double *p)
	set parameter values (only the cached one in this class,leave unchanges those of TF1)

unsigned int	NPar () const
	return number of parameters

std::string	ParameterName (unsigned int i) const
	return parameter name (from TF1)

void	ParameterGradient (const T x, const double par, T *grad) const
	Evaluate the all the derivatives (gradient vector) of the function with respect to the parameters at a point x.

const TF1 *	GetFunction () const
	method to retrieve the internal function pointer

void	SetAndCopyFunction (const TF1 *f=0)
	method to set a new function pointer and copy it inside.

static void	SetDerivPrecision (double eps)
	precision value used for calculating the derivative step-size h = eps * \|x\|.

static double	GetDerivPrecision ()
	get precision value used for calculating the derivative step-size

T	DoEvalPar (const T x, const double p) const
	evaluate function passing coordinates x and vector of parameters

T	DoEvalVec (const T *x) const
	evaluate function using the cached parameter values (of TF1) re-implement for better efficiency

T	DoEval (const T *x) const
	evaluate function using the cached parameter values (of TF1) re-implement for better efficiency

T	DoParameterDerivative (const T x, const double p, unsigned int ipar) const
	evaluate the partial derivative with respect to the parameter

#include <Math/WrappedMultiTF1.h>

Inheritance diagram for ROOT::Math::WrappedMultiTF1Templ< T >:

[legend]

Member Typedef Documentation

◆ BaseFunc

template<class T >

typedef ROOT::Math::IParametricFunctionMultiDimTempl<T>::BaseFunc ROOT::Math::WrappedMultiTF1Templ< T >::BaseFunc

Definition at line 52 of file WrappedMultiTF1.h.

◆ BaseParamFunc

template<class T >

typedef ROOT::Math::IParametricGradFunctionMultiDimTempl<T> ROOT::Math::WrappedMultiTF1Templ< T >::BaseParamFunc

Definition at line 51 of file WrappedMultiTF1.h.

Constructor & Destructor Documentation

◆ WrappedMultiTF1Templ() [1/2]

template<class T >

ROOT::Math::WrappedMultiTF1Templ< T >::WrappedMultiTF1Templ	(	TF1 &	f,
		unsigned int	dim = `0`
	)

constructor from a function pointer to a TF1 If dim = 0 dimension is taken from TF1::GetNdim().

IN case of multi-dimensional function created using directly TF1 object the dimension returned by TF1::GetNdim is always 1. The user must then pass the correct value of dim

Definition at line 214 of file WrappedMultiTF1.h.

◆ ~WrappedMultiTF1Templ()

template<class T >

ROOT::Math::WrappedMultiTF1Templ< T >::~WrappedMultiTF1Templ ( )

inline

Destructor (no operations).

Function pointer is not owned

Definition at line 65 of file WrappedMultiTF1.h.

◆ WrappedMultiTF1Templ() [2/2]

template<class T >

ROOT::Math::WrappedMultiTF1Templ< T >::WrappedMultiTF1Templ ( const WrappedMultiTF1Templ< T > & rhs )

Copy constructor.

Definition at line 246 of file WrappedMultiTF1.h.

Member Function Documentation

◆ Clone()

template<class T >

IMultiGenFunctionTempl< T > * ROOT::Math::WrappedMultiTF1Templ< T >::Clone ( ) const

inlinevirtual

Clone the wrapper but not the original function.

Implements ROOT::Math::IBaseFunctionMultiDimTempl< T >.

Definition at line 85 of file WrappedMultiTF1.h.

◆ DoEval()

template<class T >

T ROOT::Math::WrappedMultiTF1Templ< T >::DoEval ( const T * x ) const

inlineprivatevirtual

evaluate function using the cached parameter values (of TF1) re-implement for better efficiency

Reimplemented from ROOT::Math::IParametricGradFunctionMultiDimTempl< T >.

Definition at line 160 of file WrappedMultiTF1.h.

◆ DoEvalPar()

template<class T >

T ROOT::Math::WrappedMultiTF1Templ< T >::DoEvalPar	(	const T *	x,
		const double *	p
	)		const

inlineprivatevirtual

evaluate function passing coordinates x and vector of parameters

Implements ROOT::Math::IParametricGradFunctionMultiDimTempl< T >.

Definition at line 146 of file WrappedMultiTF1.h.

◆ DoEvalVec()

template<class T >

T ROOT::Math::WrappedMultiTF1Templ< T >::DoEvalVec ( const T * x ) const

inlineprivate

evaluate function using the cached parameter values (of TF1) re-implement for better efficiency

Definition at line 153 of file WrappedMultiTF1.h.

◆ DoParameterDerivative()

template<class T >

T ROOT::Math::WrappedMultiTF1Templ< T >::DoParameterDerivative	(	const T *	x,
		const double *	p,
		unsigned int	ipar
	)		const

privatevirtual

evaluate the partial derivative with respect to the parameter

Implements ROOT::Math::IParametricGradFunctionMultiDimTempl< T >.

Definition at line 294 of file WrappedMultiTF1.h.

◆ GetDerivPrecision()

template<class T >

double ROOT::Math::WrappedMultiTF1Templ< T >::GetDerivPrecision

static

get precision value used for calculating the derivative step-size

Definition at line 324 of file WrappedMultiTF1.h.

◆ GetFunction()

template<class T >

const TF1 * ROOT::Math::WrappedMultiTF1Templ< T >::GetFunction ( ) const

inline

method to retrieve the internal function pointer

Definition at line 135 of file WrappedMultiTF1.h.

◆ NDim()

template<class T >

unsigned int ROOT::Math::WrappedMultiTF1Templ< T >::NDim ( ) const

inlinevirtual

Retrieve the dimension of the function.

Implements ROOT::Math::IBaseFunctionMultiDimTempl< T >.

Definition at line 93 of file WrappedMultiTF1.h.

◆ NPar()

template<class T >

unsigned int ROOT::Math::WrappedMultiTF1Templ< T >::NPar ( ) const

inlinevirtual

return number of parameters

Implements ROOT::Math::IBaseParam.

Definition at line 113 of file WrappedMultiTF1.h.

◆ operator=()

template<class T >

WrappedMultiTF1Templ< T > & ROOT::Math::WrappedMultiTF1Templ< T >::operator= ( const WrappedMultiTF1Templ< T > & rhs )

Assignment operator.

Definition at line 260 of file WrappedMultiTF1.h.

◆ ParameterGradient()

template<class T >

void ROOT::Math::WrappedMultiTF1Templ< T >::ParameterGradient	(	const T *	x,
		const double *	p,
		T *	grad
	)		const

virtual

Evaluate the all the derivatives (gradient vector) of the function with respect to the parameters at a point x.

It is optional to be implemented by the derived classes for better efficiency

Reimplemented from ROOT::Math::IParametricGradFunctionMultiDimTempl< T >.

Definition at line 273 of file WrappedMultiTF1.h.

◆ ParameterName()

template<class T >

std::string ROOT::Math::WrappedMultiTF1Templ< T >::ParameterName ( unsigned int i ) const

inlinevirtual

return parameter name (from TF1)

Reimplemented from ROOT::Math::IBaseParam.

Definition at line 120 of file WrappedMultiTF1.h.

◆ Parameters()

template<class T >

const double * ROOT::Math::WrappedMultiTF1Templ< T >::Parameters ( ) const

inlinevirtual

get the parameter values (return values from TF1)

Implements ROOT::Math::IBaseParam.

Definition at line 99 of file WrappedMultiTF1.h.

◆ SetAndCopyFunction()

template<class T >

void ROOT::Math::WrappedMultiTF1Templ< T >::SetAndCopyFunction ( const TF1 * f = 0 )

method to set a new function pointer and copy it inside.

By calling this method the class manages now the passed TF1 pointer

Definition at line 330 of file WrappedMultiTF1.h.

◆ SetDerivPrecision()

template<class T >

void ROOT::Math::WrappedMultiTF1Templ< T >::SetDerivPrecision ( double eps )

static

precision value used for calculating the derivative step-size h = eps * |x|.

The default is 0.001, give a smaller in case function changes rapidly

Definition at line 318 of file WrappedMultiTF1.h.

◆ SetParameters()

template<class T >

void ROOT::Math::WrappedMultiTF1Templ< T >::SetParameters ( const double * p )

inlinevirtual

set parameter values (only the cached one in this class,leave unchanges those of TF1)

Implements ROOT::Math::IBaseParam.

Definition at line 106 of file WrappedMultiTF1.h.

Member Data Documentation

◆ fDim

template<class T >

unsigned int ROOT::Math::WrappedMultiTF1Templ< T >::fDim

private

Definition at line 175 of file WrappedMultiTF1.h.

◆ fFunc

template<class T >

TF1* ROOT::Math::WrappedMultiTF1Templ< T >::fFunc

private

Definition at line 174 of file WrappedMultiTF1.h.

◆ fLinear

template<class T >

bool ROOT::Math::WrappedMultiTF1Templ< T >::fLinear

private

Definition at line 171 of file WrappedMultiTF1.h.

◆ fOwnFunc

template<class T >

bool ROOT::Math::WrappedMultiTF1Templ< T >::fOwnFunc

private

Definition at line 173 of file WrappedMultiTF1.h.

◆ fPolynomial

template<class T >

bool ROOT::Math::WrappedMultiTF1Templ< T >::fPolynomial

private

Definition at line 172 of file WrappedMultiTF1.h.

hist/hist/inc/Math/WrappedMultiTF1.h

Public Types

Public Member Functions

interface inherited from IParamFunction

Member Typedef Documentation

◆ BaseFunc

◆ BaseParamFunc

Constructor & Destructor Documentation

◆ WrappedMultiTF1Templ() [1/2]

◆ ~WrappedMultiTF1Templ()

◆ WrappedMultiTF1Templ() [2/2]

Member Function Documentation

◆ Clone()

◆ DoEval()

◆ DoEvalPar()

◆ DoEvalVec()

◆ DoParameterDerivative()

◆ GetDerivPrecision()

◆ GetFunction()

◆ NDim()

◆ NPar()

◆ operator=()

◆ ParameterGradient()

◆ ParameterName()

◆ Parameters()

◆ SetAndCopyFunction()

◆ SetDerivPrecision()

◆ SetParameters()

Member Data Documentation

◆ fDim

◆ fFunc

◆ fLinear

◆ fOwnFunc

◆ fPolynomial