class containg the result of the fit and all the related information (fitted parameter values, error, covariance matrix and minimizer result information) Contains a pointer also to the fitted (model) function, modified with the fit parameter values.
When the fit is valid, it is constructed from a Minimizer and a model function pointer
Definition at line 47 of file FitResult.h.
Public Types | |
typedef ROOT::Math::IParamMultiFunction | IModelFunction |
Public Member Functions | |
FitResult () | |
Default constructor for an empty (non valid) fit result. | |
FitResult (const FitConfig &fconfig) | |
Constructor from a fit-config for a dummy fit (e.g. | |
FitResult (const FitResult &rhs) | |
Copy constructor. | |
virtual | ~FitResult () |
Destructor. | |
double | Chi2 () const |
Chi2 fit value in case of likelihood must be computed ? | |
bool | Contour (unsigned int ipar, unsigned int jpar, unsigned int &npoints, double *pntsx, double *pntsy, double confLevel=0.683) |
create contour of two parameters around the minimum pass as option confidence level: default is a value of 0.683 | |
double | Correlation (unsigned int i, unsigned int j) const |
retrieve correlation elements | |
double | CovMatrix (unsigned int i, unsigned int j) const |
retrieve covariance matrix element | |
int | CovMatrixStatus () const |
covariance matrix status code using Minuit convention : =0 not calculated, =1 approximated, =2 made pos def , =3 accurate | |
double | Edm () const |
Expected distance from minimum. | |
double | Error (unsigned int i) const |
parameter error by index | |
const std::vector< double > & | Errors () const |
parameter errors (return st::vector) | |
void | FillResult (const std::shared_ptr< ROOT::Math::Minimizer > &min, const FitConfig &fconfig, const std::shared_ptr< IModelFunction > &f, bool isValid, unsigned int sizeOfData=0, bool binFit=true, const ROOT::Math::IMultiGenFunction *chi2func=0, unsigned int ncalls=0) |
Fill the fit result from a Minimizer instance after fitting Run also Minos if requested from the configuration. | |
const BinData * | FittedBinData () const |
return BinData used in the fit (return a nullptr in case a different fit is done or the data are not available Pointer is managed internally, it must not be deleted | |
const IModelFunction * | FittedFunction () const |
fitting quantities | |
void | GetConfidenceIntervals (const BinData &data, double *ci, double cl=0.95, bool norm=false) const |
evaluate confidence interval for the point specified in the passed data sets the confidence interval are returned in the array ci cl is the desired confidence interval value. | |
std::vector< double > | GetConfidenceIntervals (double cl=0.95, bool norm=false) const |
evaluate confidence interval for the data set used in the last fit the confidence interval are returned as a vector of data points | |
void | GetConfidenceIntervals (unsigned int n, unsigned int stride1, unsigned int stride2, const double *x, double *ci, double cl=0.95, bool norm=false) const |
get confidence intervals for an array of n points x. | |
template<class Matrix > | |
void | GetCorrelationMatrix (Matrix &mat) const |
fill a correlation matrix elements using a generic symmetric matrix class implementing operator(i,j) the matrix must be previously allocates with right size (npar * npar) | |
template<class Matrix > | |
void | GetCovarianceMatrix (Matrix &mat) const |
fill covariance matrix elements using a generic matrix class implementing operator(i,j) the matrix must be previously allocates with right size (npar * npar) | |
const double * | GetErrors () const |
parameter errors (return const pointer) | |
std::string | GetParameterName (unsigned int ipar) const |
get name of parameter (deprecated) | |
const double * | GetParams () const |
parameter values (return const pointer) | |
double | GlobalCC (unsigned int i) const |
parameter global correlation coefficient | |
bool | HasMinosError (unsigned int i) const |
query if parameter i has the Minos error | |
int | Index (const std::string &name) const |
get index for parameter name (return -1 if not found) | |
bool | IsEmpty () const |
True if a fit result does not exist (even invalid) with parameter values. | |
bool | IsParameterBound (unsigned int ipar) const |
query if a parameter is bound | |
bool | IsParameterFixed (unsigned int ipar) const |
query if a parameter is fixed | |
bool | IsValid () const |
True if fit successful, otherwise false. | |
double | LowerError (unsigned int i) const |
lower Minos error. If Minos has not run for parameter i return the parabolic error | |
double | MinFcnValue () const |
Return value of the objective function (chi2 or likelihood) used in the fit. | |
const std::string & | MinimizerType () const |
minimization quantities | |
unsigned int | NCalls () const |
Number of function calls to find minimum. | |
unsigned int | Ndf () const |
Number of degree of freedom. | |
unsigned int | NFreeParameters () const |
get total number of free parameters | |
bool | NormalizedErrors () const |
flag to chek if errors are normalized | |
void | NormalizeErrors () |
normalize errors using chi2/ndf for chi2 fits | |
unsigned int | NPar () const |
total number of parameters (abbreviation) | |
unsigned int | NTotalParameters () const |
get total number of parameters | |
FitResult & | operator= (const FitResult &rhs) |
Assignment operator. | |
double | Parameter (unsigned int i) const |
parameter value by index | |
bool | ParameterBounds (unsigned int ipar, double &lower, double &upper) const |
retrieve parameter bounds - return false if parameter is not bound | |
const std::vector< double > & | Parameters () const |
parameter values (return std::vector) | |
double | ParError (unsigned int i) const |
parameter error by index | |
std::string | ParName (unsigned int i) const |
name of the parameter | |
void | Print (std::ostream &os, bool covmat=false) const |
print the result and optionaly covariance matrix and correlations | |
void | PrintCovMatrix (std::ostream &os) const |
print error matrix and correlations | |
double | Prob () const |
p value of the fit (chi2 probability) | |
bool | Scan (unsigned int ipar, unsigned int &npoints, double *pntsx, double *pntsy, double xmin=0, double xmax=0) |
scan likelihood value of parameter and fill the given graph. | |
void | SetMinosError (unsigned int i, double elow, double eup) |
set the Minos errors for parameter i (called by the Fitter class when running Minos) | |
int | Status () const |
minimizer status code | |
bool | Update (const std::shared_ptr< ROOT::Math::Minimizer > &min, const ROOT::Fit::FitConfig &fconfig, bool isValid, unsigned int ncalls=0) |
Update the fit result with a new minimization status To be run only if same fit is performed with same configuration Note that in this case MINOS is not re-run. | |
double | UpperError (unsigned int i) const |
upper Minos error. If Minos has not run for parameter i return the parabolic error | |
double | Value (unsigned int i) const |
parameter value by index | |
Protected Member Functions | |
std::shared_ptr< IModelFunction > | ModelFunction () |
Return pointer non const pointer to model (fit) function with fitted parameter values. | |
void | SetModelFunction (const std::shared_ptr< IModelFunction > &func) |
Protected Attributes | |
std::map< unsigned int, unsigned int > | fBoundParams |
double | fChi2 |
std::vector< double > | fCovMatrix |
int | fCovStatus |
double | fEdm |
std::vector< double > | fErrors |
std::shared_ptr< FitData > | fFitData |
model function resulting from the fit. | |
std::shared_ptr< IModelFunction > | fFitFunc |
objective function used for fitting | |
std::map< unsigned int, bool > | fFixedParams |
data set used in the fit | |
std::vector< double > | fGlobalCC |
std::shared_ptr< ROOT::Math::Minimizer > | fMinimizer |
std::string | fMinimType |
std::map< unsigned int, std::pair< double, double > > | fMinosErrors |
unsigned int | fNCalls |
unsigned int | fNdf |
unsigned int | fNFree |
bool | fNormalized |
std::shared_ptr< ROOT::Math::IMultiGenFunction > | fObjFunc |
minimizer object used for fitting | |
std::vector< std::pair< double, double > > | fParamBounds |
std::vector< double > | fParams |
std::vector< std::string > | fParNames |
int | fStatus |
double | fVal |
bool | fValid |
Friends | |
class | Fitter |
#include <Fit/FitResult.h>
Definition at line 51 of file FitResult.h.
ROOT::Fit::FitResult::FitResult | ( | ) |
Default constructor for an empty (non valid) fit result.
Definition at line 45 of file FitResult.cxx.
ROOT::Fit::FitResult::FitResult | ( | const FitConfig & | fconfig | ) |
Constructor from a fit-config for a dummy fit (e.g.
when only one fcn evaluation is done)
Definition at line 52 of file FitResult.cxx.
ROOT::Fit::FitResult::FitResult | ( | const FitResult & | rhs | ) |
Copy constructor.
Definition at line 225 of file FitResult.cxx.
|
virtual |
Destructor.
Definition at line 220 of file FitResult.cxx.
|
inline |
Chi2 fit value in case of likelihood must be computed ?
Definition at line 160 of file FitResult.h.
bool ROOT::Fit::FitResult::Contour | ( | unsigned int | ipar, |
unsigned int | jpar, | ||
unsigned int & | npoints, | ||
double * | pntsx, | ||
double * | pntsy, | ||
double | confLevel = 0.683 |
||
) |
create contour of two parameters around the minimum pass as option confidence level: default is a value of 0.683
Create a 2D contour around the minimum for the parameter ipar and jpar if a minimum does not exist or is invalid it will return false A array for x and y points should be provided Pass optionally the confidence level, default is 0.683 it is assumed that ErrorDef() defines the right error definition (i.e 1 sigma error for one parameter).
If not the confidence level are scaled to new level
Definition at line 704 of file FitResult.cxx.
retrieve correlation elements
Definition at line 226 of file FitResult.h.
retrieve covariance matrix element
Definition at line 216 of file FitResult.h.
|
inline |
covariance matrix status code using Minuit convention : =0 not calculated, =1 approximated, =2 made pos def , =3 accurate
Definition at line 142 of file FitResult.h.
|
inline |
Expected distance from minimum.
Definition at line 126 of file FitResult.h.
parameter error by index
Definition at line 186 of file FitResult.h.
|
inline |
parameter errors (return st::vector)
Definition at line 169 of file FitResult.h.
void ROOT::Fit::FitResult::FillResult | ( | const std::shared_ptr< ROOT::Math::Minimizer > & | min, |
const FitConfig & | fconfig, | ||
const std::shared_ptr< IModelFunction > & | f, | ||
bool | isValid, | ||
unsigned int | sizeOfData = 0 , |
||
bool | binFit = true , |
||
const ROOT::Math::IMultiGenFunction * | chi2func = 0 , |
||
unsigned int | ncalls = 0 |
||
) |
Fill the fit result from a Minimizer instance after fitting Run also Minos if requested from the configuration.
Definition at line 100 of file FitResult.cxx.
const BinData * ROOT::Fit::FitResult::FittedBinData | ( | ) | const |
return BinData used in the fit (return a nullptr in case a different fit is done or the data are not available Pointer is managed internally, it must not be deleted
Definition at line 675 of file FitResult.cxx.
|
inline |
fitting quantities
Return pointer to model (fit) function with fitted parameter values. Pointer is managed internally. I must not be deleted
Definition at line 148 of file FitResult.h.
void ROOT::Fit::FitResult::GetConfidenceIntervals | ( | const BinData & | data, |
double * | ci, | ||
double | cl = 0.95 , |
||
bool | norm = false |
||
) | const |
evaluate confidence interval for the point specified in the passed data sets the confidence interval are returned in the array ci cl is the desired confidence interval value.
This method is mantained for backward compatibility and will be deprecated
Definition at line 627 of file FitResult.cxx.
std::vector< double > ROOT::Fit::FitResult::GetConfidenceIntervals | ( | double | cl = 0.95 , |
bool | norm = false |
||
) | const |
evaluate confidence interval for the data set used in the last fit the confidence interval are returned as a vector of data points
Definition at line 643 of file FitResult.cxx.
void ROOT::Fit::FitResult::GetConfidenceIntervals | ( | unsigned int | n, |
unsigned int | stride1, | ||
unsigned int | stride2, | ||
const double * | x, | ||
double * | ci, | ||
double | cl = 0.95 , |
||
bool | norm = false |
||
) | const |
get confidence intervals for an array of n points x.
stride1 indicates the stride in the coordinate space while stride2 the stride in dimension space. For 1-dim points : stride1=1, stride2=1 for multi-dim points arranged as (x0,x1,...,xN,y0,....yN) stride1=1 stride2=n for multi-dim points arraged as (x0,y0,..,x1,y1,...,xN,yN,..) stride1=ndim, stride2=1
the confidence interval are returned in the array ci cl is the desired confidedence interval value norm is a flag to control if the intervals need to be normalized to the chi2/ndf value The intervals can be corrected optionally using the chi2/ndf value of the fit if a chi2 fit is performed. This has changed since ROOT 6.14, before the interval were corrected by default.
Definition at line 550 of file FitResult.cxx.
|
inline |
fill a correlation matrix elements using a generic symmetric matrix class implementing operator(i,j) the matrix must be previously allocates with right size (npar * npar)
Definition at line 250 of file FitResult.h.
fill covariance matrix elements using a generic matrix class implementing operator(i,j) the matrix must be previously allocates with right size (npar * npar)
Definition at line 236 of file FitResult.h.
|
inline |
parameter errors (return const pointer)
Definition at line 171 of file FitResult.h.
|
inline |
get name of parameter (deprecated)
Definition at line 328 of file FitResult.h.
|
inline |
parameter values (return const pointer)
Definition at line 176 of file FitResult.h.
parameter global correlation coefficient
Definition at line 210 of file FitResult.h.
query if parameter i has the Minos error
Definition at line 369 of file FitResult.cxx.
int ROOT::Fit::FitResult::Index | ( | const std::string & | name | ) | const |
get index for parameter name (return -1 if not found)
Definition at line 395 of file FitResult.cxx.
|
inline |
True if a fit result does not exist (even invalid) with parameter values.
Definition at line 117 of file FitResult.h.
query if a parameter is bound
Definition at line 405 of file FitResult.cxx.
query if a parameter is fixed
Definition at line 409 of file FitResult.cxx.
|
inline |
True if fit successful, otherwise false.
A fit is considered successful if the minimizer succeded in finding the minimum. It could happen that subsequent operations like error analysis (e.g. Minos) failed. In that case the status can be still true if the original minimization algorithm succeeded in finding the minimum. One can query in that case the minimizer return status using Status(). It is responability to the Minimizer class to tag a found minimum as valid or not and to produce also a status code.
Definition at line 114 of file FitResult.h.
lower Minos error. If Minos has not run for parameter i return the parabolic error
Definition at line 376 of file FitResult.cxx.
|
inline |
Return value of the objective function (chi2 or likelihood) used in the fit.
Definition at line 120 of file FitResult.h.
|
inline |
|
inlineprotected |
Return pointer non const pointer to model (fit) function with fitted parameter values.
used by Fitter class
Definition at line 338 of file FitResult.h.
|
inline |
Number of function calls to find minimum.
Definition at line 123 of file FitResult.h.
|
inline |
Number of degree of freedom.
Definition at line 163 of file FitResult.h.
|
inline |
get total number of free parameters
Definition at line 134 of file FitResult.h.
|
inline |
flag to chek if errors are normalized
Definition at line 309 of file FitResult.h.
void ROOT::Fit::FitResult::NormalizeErrors | ( | ) |
normalize errors using chi2/ndf for chi2 fits
Definition at line 350 of file FitResult.cxx.
|
inline |
total number of parameters (abbreviation)
Definition at line 131 of file FitResult.h.
|
inline |
get total number of parameters
Definition at line 129 of file FitResult.h.
Assignment operator.
Definition at line 232 of file FitResult.cxx.
parameter value by index
Definition at line 181 of file FitResult.h.
bool ROOT::Fit::FitResult::ParameterBounds | ( | unsigned int | ipar, |
double & | lower, | ||
double & | upper | ||
) | const |
retrieve parameter bounds - return false if parameter is not bound
Definition at line 413 of file FitResult.cxx.
|
inline |
parameter values (return std::vector)
Definition at line 174 of file FitResult.h.
parameter error by index
Definition at line 190 of file FitResult.h.
std::string ROOT::Fit::FitResult::ParName | ( | unsigned int | i | ) | const |
name of the parameter
Definition at line 426 of file FitResult.cxx.
print the result and optionaly covariance matrix and correlations
Definition at line 433 of file FitResult.cxx.
void ROOT::Fit::FitResult::PrintCovMatrix | ( | std::ostream & | os | ) | const |
print error matrix and correlations
Definition at line 491 of file FitResult.cxx.
double ROOT::Fit::FitResult::Prob | ( | ) | const |
p value of the fit (chi2 probability)
Definition at line 364 of file FitResult.cxx.
bool ROOT::Fit::FitResult::Scan | ( | unsigned int | ipar, |
unsigned int & | npoints, | ||
double * | pntsx, | ||
double * | pntsy, | ||
double | xmin = 0 , |
||
double | xmax = 0 |
||
) |
scan likelihood value of parameter and fill the given graph.
Scan parameter ipar between value of xmin and xmax A array for x and y points should be provided.
Definition at line 683 of file FitResult.cxx.
set the Minos errors for parameter i (called by the Fitter class when running Minos)
Definition at line 390 of file FitResult.cxx.
|
inlineprotected |
Definition at line 339 of file FitResult.h.
|
inline |
minimizer status code
Definition at line 137 of file FitResult.h.
bool ROOT::Fit::FitResult::Update | ( | const std::shared_ptr< ROOT::Math::Minimizer > & | min, |
const ROOT::Fit::FitConfig & | fconfig, | ||
bool | isValid, | ||
unsigned int | ncalls = 0 |
||
) |
Update the fit result with a new minimization status To be run only if same fit is performed with same configuration Note that in this case MINOS is not re-run.
If one wants to run also MINOS a new result must be created
Definition at line 275 of file FitResult.cxx.
upper Minos error. If Minos has not run for parameter i return the parabolic error
Definition at line 383 of file FitResult.cxx.
parameter value by index
Definition at line 179 of file FitResult.h.
|
friend |
Definition at line 341 of file FitResult.h.
Definition at line 359 of file FitResult.h.
|
protected |
Definition at line 353 of file FitResult.h.
|
protected |
Definition at line 363 of file FitResult.h.
|
protected |
Definition at line 350 of file FitResult.h.
|
protected |
Definition at line 352 of file FitResult.h.
|
protected |
Definition at line 362 of file FitResult.h.
|
protected |
model function resulting from the fit.
Definition at line 357 of file FitResult.h.
|
protected |
objective function used for fitting
Definition at line 356 of file FitResult.h.
data set used in the fit
Definition at line 358 of file FitResult.h.
|
protected |
Definition at line 364 of file FitResult.h.
|
protected |
Definition at line 354 of file FitResult.h.
|
protected |
Definition at line 366 of file FitResult.h.
Definition at line 365 of file FitResult.h.
|
protected |
Definition at line 348 of file FitResult.h.
|
protected |
Definition at line 347 of file FitResult.h.
|
protected |
Definition at line 346 of file FitResult.h.
|
protected |
Definition at line 345 of file FitResult.h.
|
protected |
minimizer object used for fitting
Definition at line 355 of file FitResult.h.
Definition at line 360 of file FitResult.h.
|
protected |
Definition at line 361 of file FitResult.h.
|
protected |
Definition at line 367 of file FitResult.h.
|
protected |
Definition at line 349 of file FitResult.h.
|
protected |
Definition at line 351 of file FitResult.h.
|
protected |
Definition at line 344 of file FitResult.h.