Logo ROOT  
Reference Guide
RooRealVar.h
Go to the documentation of this file.
1 /*****************************************************************************
2  * Project: RooFit *
3  * Package: RooFitCore *
4  * File: $Id: RooRealVar.h,v 1.54 2007/05/11 09:11:30 verkerke Exp $
5  * Authors: *
6  * WV, Wouter Verkerke, UC Santa Barbara, verkerke@slac.stanford.edu *
7  * DK, David Kirkby, UC Irvine, dkirkby@uci.edu *
8  * *
9  * Copyright (c) 2000-2005, Regents of the University of California *
10  * and Stanford University. All rights reserved. *
11  * *
12  * Redistribution and use in source and binary forms, *
13  * with or without modification, are permitted according to the terms *
14  * listed in LICENSE (http://roofit.sourceforge.net/license.txt) *
15  *****************************************************************************/
16 #ifndef ROO_REAL_VAR
17 #define ROO_REAL_VAR
18 
19 #include "RooAbsRealLValue.h"
20 
21 #include "TString.h"
22 
23 #include <list>
24 #include <string>
25 #include <map>
26 #include <memory>
27 #include <unordered_map>
28 
29 
30 class RooArgSet ;
31 class RooErrorVar ;
32 class RooVectorDataStore ;
35 
36 class RooRealVar : public RooAbsRealLValue {
37 public:
38  // Constructors, assignment etc.
39  RooRealVar() ;
40  RooRealVar(const char *name, const char *title,
41  Double_t value, const char *unit= "") ;
42  RooRealVar(const char *name, const char *title, Double_t minValue,
43  Double_t maxValue, const char *unit= "");
44  RooRealVar(const char *name, const char *title, Double_t value,
45  Double_t minValue, Double_t maxValue, const char *unit= "") ;
46  RooRealVar(const RooRealVar& other, const char* name=0);
47  RooRealVar& operator=(const RooRealVar& other);
48  virtual TObject* clone(const char* newname) const { return new RooRealVar(*this,newname); }
49  virtual ~RooRealVar();
50 
51  // Parameter value and error accessors
52  virtual Double_t getValV(const RooArgSet* nset=0) const ;
53  ////////////////////////////////////////////////////////////////////////////////
54  /// Return batch of data starting at `begin`.
55  /// \param begin First event to return.
56  /// \param batchSize Size of the batch.
57  /// \return Span with event data. If not attached to a data store, empty batch. The batch will be shorter if data store ends.
58  RooSpan<const double> getValBatch(std::size_t begin, std::size_t batchSize, const RooArgSet* = nullptr) const final {
59  return _batchData.getBatch(begin, batchSize);
60  }
61 
62  virtual void setVal(Double_t value);
63  virtual void setVal(Double_t value, const char* rangeName);
64  inline Double_t getError() const { return _error>=0?_error:0. ; }
65  inline Bool_t hasError(Bool_t allowZero=kTRUE) const { return allowZero ? (_error>=0) : (_error>0) ; }
66  inline void setError(Double_t value) { _error= value ; }
67  inline void removeError() { _error = -1 ; }
68  inline Double_t getAsymErrorLo() const { return _asymErrLo<=0?_asymErrLo:0. ; }
69  inline Double_t getAsymErrorHi() const { return _asymErrHi>=0?_asymErrHi:0. ; }
70  inline Bool_t hasAsymError(Bool_t allowZero=kTRUE) const { return allowZero ? ((_asymErrHi>=0 && _asymErrLo<=0)) : ((_asymErrHi>0 && _asymErrLo<0)) ; }
71  inline void removeAsymError() { _asymErrLo = 1 ; _asymErrHi = -1 ; }
72  inline void setAsymError(Double_t lo, Double_t hi) { _asymErrLo = lo ; _asymErrHi = hi ; }
73  inline Double_t getErrorLo() const { return _asymErrLo<=0?_asymErrLo:-1*_error ; }
74  inline Double_t getErrorHi() const { return _asymErrHi>=0?_asymErrHi:_error ; }
75 
76  RooErrorVar* errorVar() const ;
77 
78  // Set/get finite fit range limits
79  void setMin(const char* name, Double_t value) ;
80  void setMax(const char* name, Double_t value) ;
81  void setRange(const char* name, Double_t min, Double_t max) ;
82  void setRange(const char* name, RooAbsReal& min, RooAbsReal& max) ;
83  inline void setMin(Double_t value) { setMin(0,value) ; }
84  inline void setMax(Double_t value) { setMax(0,value) ; }
85  /// Set the limits of the default range.
86  inline void setRange(Double_t min, Double_t max) { setRange(0,min,max) ; }
87  /// Set parameterised limits of the default range. See setRange(const char*, RooAbsReal&, RooAbsReal&).
88  inline void setRange(RooAbsReal& min, RooAbsReal& max) { setRange(0,min,max) ; }
89 
90  void setBins(Int_t nBins, const char* name=0);
91  void setBinning(const RooAbsBinning& binning, const char* name=0) ;
92 
93  // RooAbsRealLValue implementation
94  Bool_t hasBinning(const char* name) const ;
95  const RooAbsBinning& getBinning(const char* name=0, Bool_t verbose=kTRUE, Bool_t createOnTheFly=kFALSE) const ;
96  RooAbsBinning& getBinning(const char* name=0, Bool_t verbose=kTRUE, Bool_t createOnTheFly=kFALSE) ;
97  std::list<std::string> getBinningNames() const ;
98 
99  // Set infinite fit range limits
100  /// Remove lower range limit for binning with given name. Empty name means default range.
101  void removeMin(const char* name=0);
102  /// Remove upper range limit for binning with given name. Empty name means default range.
103  void removeMax(const char* name=0);
104  /// Remove range limits for binning with given name. Empty name means default range.
105  void removeRange(const char* name=0);
106 
107  // I/O streaming interface (machine readable)
108  virtual Bool_t readFromStream(std::istream& is, Bool_t compact, Bool_t verbose=kFALSE) ;
109  virtual void writeToStream(std::ostream& os, Bool_t compact) const ;
110 
111  // We implement a fundamental type of AbsArg that can be stored in a dataset
112  inline virtual Bool_t isFundamental() const { return kTRUE; }
113 
114  // Force to be a leaf-node of any expression tree, even if we have (shape) servers
115  virtual Bool_t isDerived() const {
116  // Does value or shape of this arg depend on any other arg?
117  return !_serverList.empty() || _proxyList.GetEntries()>0;
118  }
119 
120  // Printing interface (human readable)
121  virtual void printValue(std::ostream& os) const ;
122  virtual void printExtras(std::ostream& os) const ;
123  virtual void printMultiline(std::ostream& os, Int_t contents, Bool_t verbose=kFALSE, TString indent="") const ;
124  virtual Int_t defaultPrintContents(Option_t* opt) const ;
125 
126 
127  TString* format(const RooCmdArg& formatArg) const ;
128  TString* format(Int_t sigDigits, const char *options) const ;
129 
130  static void printScientific(Bool_t flag=kFALSE) ;
131  static void printSigDigits(Int_t ndig=5) ;
132 
133  using RooAbsRealLValue::operator= ;
134 
135  void deleteSharedProperties() ;
136 
137  void copyCacheFast(const RooRealVar& other, Bool_t setValDirty=kTRUE) { _value = other._value ; if (setValDirty) setValueDirty() ; }
138 
139  protected:
140 
143 
144  friend class RooAbsRealLValue ;
145  virtual void setValFast(Double_t value) { _value = value ; setValueDirty() ; }
146 
147 
148  virtual Double_t evaluate() const { return _value ; } // dummy because we overloaded getVal()
149  virtual void copyCache(const RooAbsArg* source, Bool_t valueOnly=kFALSE, Bool_t setValDirty=kTRUE) ;
150  virtual void attachToTree(TTree& t, Int_t bufSize=32000) ;
151  virtual void attachToVStore(RooVectorDataStore& vstore) ;
152  virtual void fillTreeBranch(TTree& t) ;
153 
154  Double_t chopAt(Double_t what, Int_t where) const ;
155 
156  Double_t _error; // Symmetric error associated with current value
157  Double_t _asymErrLo ; // Low side of asymmetric error associated with current value
158  Double_t _asymErrHi ; // High side of asymmetric error associated with current value
159  std::unique_ptr<RooAbsBinning> _binning;
160  std::unordered_map<std::string,std::unique_ptr<RooAbsBinning>> _altNonSharedBinning ; //! Non-shareable alternative binnings
161 
162  std::shared_ptr<RooRealVarSharedProperties> sharedProp() const;
163  void installSharedProp(std::shared_ptr<RooRealVarSharedProperties>&& prop);
164 
165  virtual void setExpensiveObjectCache(RooExpensiveObjectCache&) { ; } // variables don't need caches
166 
167  static std::map<std::string,std::weak_ptr<RooRealVarSharedProperties>> _sharedPropList; // List of properties shared among clones of a variable
168  static const std::unique_ptr<RooRealVarSharedProperties> _nullProp ; // Null property
169  std::shared_ptr<RooRealVarSharedProperties> _sharedProp; //! Shared binnings associated with this instance
170 
171  ClassDef(RooRealVar,7) // Real-valued variable
172 };
173 
174 
175 
176 
177 #endif
RooRealVar::getAsymErrorHi
Double_t getAsymErrorHi() const
Definition: RooRealVar.h:69
RooRealVar::_asymErrLo
Double_t _asymErrLo
Definition: RooRealVar.h:157
RooCmdArg
Definition: RooCmdArg.h:27
RooRealVarSharedProperties
Definition: RooRealVarSharedProperties.h:27
RooRealVar::_sharedProp
std::shared_ptr< RooRealVarSharedProperties > _sharedProp
Definition: RooRealVar.h:169
RooRealVar::setVal
virtual void setVal(Double_t value)
Set value of variable to 'value'.
Definition: RooRealVar.cxx:216
kTRUE
const Bool_t kTRUE
Definition: RtypesCore.h:91
RooRealVar::_altNonSharedBinning
std::unordered_map< std::string, std::unique_ptr< RooAbsBinning > > _altNonSharedBinning
Definition: RooRealVar.h:160
RooRealVar::_sharedPropList
static std::map< std::string, std::weak_ptr< RooRealVarSharedProperties > > _sharedPropList
Definition: RooRealVar.h:167
RooRealVar::installSharedProp
void installSharedProp(std::shared_ptr< RooRealVarSharedProperties > &&prop)
Install the shared property into the member _sharedProp.
Definition: RooRealVar.cxx:1249
RooRealVar::printSigDigits
static void printSigDigits(Int_t ndig=5)
Set number of digits to show when printing RooRealVars.
Definition: RooRealVar.cxx:1299
RooRealVar::setMin
void setMin(const char *name, Double_t value)
Set minimum of name range to given value.
Definition: RooRealVar.cxx:420
RooRealVar::evaluate
virtual Double_t evaluate() const
Evaluate this PDF / function / constant. Needs to be overridden by all derived classes.
Definition: RooRealVar.h:148
RooRealVar::getValBatch
RooSpan< const double > getValBatch(std::size_t begin, std::size_t batchSize, const RooArgSet *=nullptr) const final
Return batch of data starting at begin.
Definition: RooRealVar.h:58
RooRealVar::_printScientific
static Bool_t _printScientific
Definition: RooRealVar.h:141
RooRealVar::getBinningNames
std::list< std::string > getBinningNames() const
Get a list of all binning names.
Definition: RooRealVar.cxx:335
RooRealVar::format
TString * format(const RooCmdArg &formatArg) const
Format contents of RooRealVar for pretty printing on RooPlot parameter boxes.
Definition: RooRealVar.cxx:816
RooAbsArg::_serverList
RefCountList_t _serverList
Definition: RooAbsArg.h:587
TTree
Definition: TTree.h:79
RooRealVar::fillTreeBranch
virtual void fillTreeBranch(TTree &t)
Overload RooAbsReal::fillTreeBranch to also fill tree branches with (asymmetric) errors if requested.
Definition: RooRealVar.cxx:1116
RooRealVar::setMax
void setMax(Double_t value)
Definition: RooRealVar.h:84
RooRealVar::removeAsymError
void removeAsymError()
Definition: RooRealVar.h:71
TObjArray::GetEntries
Int_t GetEntries() const
Return the number of objects in array (i.e.
Definition: TObjArray.cxx:523
indent
static void indent(ostringstream &buf, int indent_level)
Definition: TClingCallFunc.cxx:87
RooAbsReal
Definition: RooAbsReal.h:61
RooErrorVar
Definition: RooErrorVar.h:28
RooRealVar::writeToStream
virtual void writeToStream(std::ostream &os, Bool_t compact) const
Write object contents to given stream.
Definition: RooRealVar.cxx:666
RooRealVar::~RooRealVar
virtual ~RooRealVar()
Destructor.
Definition: RooRealVar.cxx:196
RooRealVar::chopAt
Double_t chopAt(Double_t what, Int_t where) const
Utility to calculate number of decimals to show based on magnitude of error.
Definition: RooRealVar.cxx:1014
TString
Definition: TString.h:136
RooRealVar::copyCache
virtual void copyCache(const RooAbsArg *source, Bool_t valueOnly=kFALSE, Bool_t setValDirty=kTRUE)
Copy the cached value of another RooAbsArg to our cache Warning: This function copies the cached valu...
Definition: RooRealVar.cxx:1154
RooRealVar::setRange
void setRange(const char *name, Double_t min, Double_t max)
Set a fit or plotting range.
Definition: RooRealVar.cxx:485
RooSTLRefCountList::empty
bool empty() const
Check if empty.
Definition: RooSTLRefCountList.h:114
RooRealVar::printValue
virtual void printValue(std::ostream &os) const
Print value of variable.
Definition: RooRealVar.cxx:731
TString.h
RooRealVar::errorVar
RooErrorVar * errorVar() const
Return a RooAbsRealLValue representing the error associated with this variable.
Definition: RooRealVar.cxx:250
RooExpensiveObjectCache
Definition: RooExpensiveObjectCache.h:24
bool
RooRealVar::setRange
void setRange(Double_t min, Double_t max)
Set the limits of the default range.
Definition: RooRealVar.h:86
RooRealVar::readFromStream
virtual Bool_t readFromStream(std::istream &is, Bool_t compact, Bool_t verbose=kFALSE)
Read object contents from given stream.
Definition: RooRealVar.cxx:527
hi
float type_of_call hi(const int &, const int &)
RooRealVar::attachToVStore
virtual void attachToVStore(RooVectorDataStore &vstore)
Overload RooAbsReal::attachToTree to also attach branches for errors and/or asymmetric errors attribu...
Definition: RooRealVar.cxx:1028
RooRealVar::setMin
void setMin(Double_t value)
Definition: RooRealVar.h:83
Option_t
const typedef char Option_t
Definition: RtypesCore.h:66
RooRealVar::RooRealVar
RooRealVar()
Default constructor.
Definition: RooRealVar.cxx:62
RooRealVar::_asymErrHi
Double_t _asymErrHi
Definition: RooRealVar.h:158
RooRealVar::getError
Double_t getError() const
Definition: RooRealVar.h:64
RooRealVar::getAsymErrorLo
Double_t getAsymErrorLo() const
Definition: RooRealVar.h:68
RooRealVar::getErrorHi
Double_t getErrorHi() const
Definition: RooRealVar.h:74
RooRealVar::removeError
void removeError()
Definition: RooRealVar.h:67
RooRealVar::removeMax
void removeMax(const char *name=0)
Remove upper range limit for binning with given name. Empty name means default range.
Definition: RooRealVar.cxx:355
RooRealVar::clone
virtual TObject * clone(const char *newname) const
Definition: RooRealVar.h:48
kFALSE
const Bool_t kFALSE
Definition: RtypesCore.h:92
RooRealVar::setError
void setError(Double_t value)
Definition: RooRealVar.h:66
RooRealVar::hasBinning
Bool_t hasBinning(const char *name) const
Returns true if variable has a binning named 'name'.
Definition: RooRealVar.cxx:264
RooAbsBinning
Definition: RooAbsBinning.h:26
RooRealVar::isFundamental
virtual Bool_t isFundamental() const
Is this object a fundamental type that can be added to a dataset? Fundamental-type subclasses overrid...
Definition: RooRealVar.h:112
RooRealVar::isDerived
virtual Bool_t isDerived() const
Does value or shape of this arg depend on any other arg?
Definition: RooRealVar.h:115
what
static const char * what
Definition: stlLoader.cc:6
RooAbsReal::_value
Double_t _value
Definition: RooAbsReal.h:450
RooRealVar::attachToTree
virtual void attachToTree(TTree &t, Int_t bufSize=32000)
Overload RooAbsReal::attachToTree to also attach branches for errors and/or asymmetric errors attribu...
Definition: RooRealVar.cxx:1063
RooAbsReal::_batchData
BatchHelpers::BatchData _batchData
Definition: RooAbsReal.h:451
RooRealVar::printExtras
virtual void printExtras(std::ostream &os) const
Print extras of variable: (asymmetric) error, constant flag, limits and binning.
Definition: RooRealVar.cxx:747
RooRealVar::getBinning
const RooAbsBinning & getBinning(const char *name=0, Bool_t verbose=kTRUE, Bool_t createOnTheFly=kFALSE) const
Return binning definition with name.
Definition: RooRealVar.cxx:277
RooRealVar::defaultPrintContents
virtual Int_t defaultPrintContents(Option_t *opt) const
Mapping of Print() option string to RooPrintable contents specifications.
Definition: RooRealVar.cxx:787
RooRealVar::_nullProp
static const std::unique_ptr< RooRealVarSharedProperties > _nullProp
Definition: RooRealVar.h:168
RooRealVar::getValV
virtual Double_t getValV(const RooArgSet *nset=0) const
Return value of variable.
Definition: RooRealVar.cxx:205
RooRealVar::setMax
void setMax(const char *name, Double_t value)
Set maximum of name range to given value.
Definition: RooRealVar.cxx:450
Double_t
double Double_t
Definition: RtypesCore.h:59
RooAbsArg::_proxyList
RooRefArray _proxyList
Definition: RooAbsArg.h:592
RooRealVar::setRange
void setRange(RooAbsReal &min, RooAbsReal &max)
Set parameterised limits of the default range. See setRange(const char*, RooAbsReal&,...
Definition: RooRealVar.h:88
RooRealVar::copyCacheFast
void copyCacheFast(const RooRealVar &other, Bool_t setValDirty=kTRUE)
Definition: RooRealVar.h:137
RooRealVar::setValFast
virtual void setValFast(Double_t value)
Definition: RooRealVar.h:145
RooRealVar::setBinning
void setBinning(const RooAbsBinning &binning, const char *name=0)
Add given binning under name 'name' with this variable.
Definition: RooRealVar.cxx:374
RooRealVar::setExpensiveObjectCache
virtual void setExpensiveObjectCache(RooExpensiveObjectCache &)
Definition: RooRealVar.h:165
RooRealVar::printScientific
static void printScientific(Bool_t flag=kFALSE)
If true, contents of RooRealVars will be printed in scientific notation.
Definition: RooRealVar.cxx:1290
RooVectorDataStore
Definition: RooVectorDataStore.h:35
RooRealVar::hasAsymError
Bool_t hasAsymError(Bool_t allowZero=kTRUE) const
Definition: RooRealVar.h:70
TObject
Definition: TObject.h:37
ClassDef
#define ClassDef(name, id)
Definition: Rtypes.h:325
RooRealVar::sharedProp
std::shared_ptr< RooRealVarSharedProperties > sharedProp() const
Non-shareable alternative binnings.
Definition: RooRealVar.cxx:1235
RooRealVar::removeRange
void removeRange(const char *name=0)
Remove range limits for binning with given name. Empty name means default range.
Definition: RooRealVar.cxx:358
name
char name[80]
Definition: TGX11.cxx:110
RooRealVar::removeMin
void removeMin(const char *name=0)
Remove lower range limit for binning with given name. Empty name means default range.
Definition: RooRealVar.cxx:352
genreflex::verbose
bool verbose
Definition: rootcling_impl.cxx:133
RooRealVar::_binning
std::unique_ptr< RooAbsBinning > _binning
Definition: RooRealVar.h:159
RooRealVar::_printSigDigits
static Int_t _printSigDigits
Definition: RooRealVar.h:142
RooAbsArg
Definition: RooAbsArg.h:73
RooRealVar::_error
Double_t _error
Definition: RooRealVar.h:156
RooRealVar::operator=
RooRealVar & operator=(const RooRealVar &other)
Assign the values of another RooRealVar to this instance.
Definition: RooRealVar.cxx:166
RooAbsArg::setValueDirty
void setValueDirty()
Mark the element dirty. This forces a re-evaluation when a value is requested.
Definition: RooAbsArg.h:505
RooRealVar::setAsymError
void setAsymError(Double_t lo, Double_t hi)
Definition: RooRealVar.h:72
RooRealVar::getErrorLo
Double_t getErrorLo() const
Definition: RooRealVar.h:73
BatchHelpers::BatchData::getBatch
RooSpan< const double > getBatch(std::size_t begin, std::size_t maxSize, const RooArgSet *const normSet=nullptr, Tag_t ownerTag=kUnspecified) const
Retrieve an existing batch.
Definition: BatchData.cxx:92
RooRealVar::setBins
void setBins(Int_t nBins, const char *name=0)
Create a uniform binning under name 'name' for this variable.
Definition: RooRealVar.cxx:367
RooRealVar
Definition: RooRealVar.h:36
RooAbsRealLValue
Definition: RooAbsRealLValue.h:31
RooAbsRealLValue.h
RooRealVar::deleteSharedProperties
void deleteSharedProperties()
Stop sharing properties.
Definition: RooRealVar.cxx:1273
RooSpan
A simple container to hold a batch of data values.
Definition: RooSpan.h:33
RooArgSet
Definition: RooArgSet.h:28
RooRealVar::hasError
Bool_t hasError(Bool_t allowZero=kTRUE) const
Definition: RooRealVar.h:65
int
RooRealVar::printMultiline
virtual void printMultiline(std::ostream &os, Int_t contents, Bool_t verbose=kFALSE, TString indent="") const
Detailed printing interface.
Definition: RooRealVar.cxx:799