Logo ROOT  
Reference Guide
RooAbsData Class Referenceabstract

RooAbsData is the common abstract base class for binned and unbinned datasets.

The abstract interface defines plotting and tabulating entry points for its contents and provides an iterator over its elements (bins for binned data sets, data points for unbinned datasets).

Storing global observables in RooFit datasets

RooFit groups model variables into observables and parameters, depending on if their values are stored in the dataset. For fits with parameter constraints, there is a third kind of variables, called global observables. These represent the results of auxiliary measurements that constrain the nuisance parameters. In the RooFit implementation, a likelihood is generally the sum of two terms:

  • the likelihood of the data given the parameters, where the normalization set is the set of observables (implemented by RooNLLVar)
  • the constraint term, where the normalization set is the set of global observables (implemented by RooConstraintSum)

Before this release, the global observable values were always taken from the model/pdf. With this release, a mechanism is added to store a snapshot of global observables in any RooDataSet or RooDataHist. For toy studies where the global observables assume a different values for each toy, the bookkeeping of the set of global observables and in particular their values is much easier with this change.

Usage example for a model with global observables g1 and g2:

auto data = model.generate(x, 1000); // data has only the single observables x
data->setGlobalObservables(g1, g2); // now, data also stores a snapshot of g1 and g2
// If you fit the model to the data, the global observables and their values
// are taken from the dataset:
model.fitTo(*data);
// You can still define the set of global observables yourself, but the values
// will be takes from the dataset if available:
model.fitTo(*data, GlobalObservables(g1, g2));
// To force `fitTo` to take the global observable values from the model even
// though they are in the dataset, you can use the new `GlobalObservablesSource`
// command argument:
model.fitTo(*data, GlobalObservables(g1, g2), GlobalObservablesSource("model"));
// The only other allowed value for `GlobalObservablesSource` is "data", which
// corresponds to the new default behavior explained above.
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void data
RooCmdArg GlobalObservables(Args_t &&... argsOrArgSet)
RooCmdArg GlobalObservablesSource(const char *sourceName)
Double_t x[n]
Definition: legend1.C:17

In case you create a RooFit dataset directly by calling its constructor, you can also pass the global observables in a command argument instead of calling RooAbsData::setGlobalObservables() later:

RooDataSet data{"dataset", "dataset", x, RooFit::GlobalObservables(g1, g2)};
RooDataSet is a container class to hold unbinned data.
Definition: RooDataSet.h:55

To access the set of global observables stored in a RooAbsData, call RooAbsData::getGlobalObservables(). It returns a nullptr if no global observable snapshots are stored in the dataset.

PyROOT

Some member functions of RooAbsData that take a RooCmdArg as argument also support keyword arguments. This applies to RooAbsData::plotOn, RooAbsData::createHistogram, RooAbsData::reduce, RooAbsData::statOn. For example, the following code is equivalent in PyROOT:

# Directly passing a RooCmdArg:
data.plotOn(frame, ROOT.RooFit.CutRange("r1"))
# With keyword arguments:
data.plotOn(frame, CutRange="r1")

Definition at line 62 of file RooAbsData.h.

Classes

struct  PlotOpt
 

Public Types

using CategorySpans = std::map< RooFit::Detail::DataKey, RooSpan< const RooAbsCategory::value_type > >
 
enum  ErrorType {
  Poisson , SumW2 , None , Auto ,
  Expected
}
 
using RealSpans = std::map< RooFit::Detail::DataKey, RooSpan< const double > >
 
enum  StorageType { Tree , Vector , Composite }
 
- Public Types inherited from TObject
enum  {
  kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 ,
  kBitMask = 0x00ffffff
}
 
enum  { kSingleKey = (1ULL << ( 0 )) , kOverwrite = (1ULL << ( 1 )) , kWriteDelete = (1ULL << ( 2 )) }
 
enum  EDeprecatedStatusBits { kObjInCanvas = (1ULL << ( 3 )) }
 
enum  EStatusBits {
  kCanDelete = (1ULL << ( 0 )) , kMustCleanup = (1ULL << ( 3 )) , kIsReferenced = (1ULL << ( 4 )) , kHasUUID = (1ULL << ( 5 )) ,
  kCannotPick = (1ULL << ( 6 )) , kNoContextMenu = (1ULL << ( 8 )) , kInvalidObject = (1ULL << ( 13 ))
}
 
- Public Types inherited from RooPrintable
enum  ContentsOption {
  kName =1 , kClassName =2 , kValue =4 , kArgs =8 ,
  kExtras =16 , kAddress =32 , kTitle =64 , kCollectionHeader =128
}
 
enum  StyleOption {
  kInline =1 , kSingleLine =2 , kStandard =3 , kVerbose =4 ,
  kTreeStructure =5
}
 

Public Member Functions

 RooAbsData ()
 Default constructor. More...
 
 RooAbsData (const RooAbsData &other, const char *newname=0)
 Copy constructor. More...
 
 RooAbsData (RooStringView name, RooStringView title, const RooArgSet &vars, RooAbsDataStore *store=0)
 Constructor from a set of variables. More...
 
 ~RooAbsData () override
 Destructor. More...
 
virtual void add (const RooArgSet &row, double weight=1, double weightError=0)=0
 
void addOwnedComponent (const char *idxlabel, RooAbsData &data)
 
void attachBuffers (const RooArgSet &extObs)
 
bool canSplitFast () const
 
virtual bool changeObservableName (const char *from, const char *to)
 
void checkInit () const
 
virtual void convertToTreeStore ()
 Convert vector-based storage to tree-based storage. More...
 
void convertToVectorStore ()
 Convert tree-based storage to vector-based storage. More...
 
double correlation (RooRealVar &x, RooRealVar &y, const char *cutSpec=0, const char *cutRange=0) const
 
TMatrixDSymcorrelationMatrix (const char *cutSpec=0, const char *cutRange=0) const
 
TMatrixDSymcorrelationMatrix (const RooArgList &vars, const char *cutSpec=0, const char *cutRange=0) const
 
double covariance (RooRealVar &x, RooRealVar &y, const char *cutSpec=0, const char *cutRange=0) const
 
TMatrixDSymcovarianceMatrix (const char *cutSpec=0, const char *cutRange=0) const
 
TMatrixDSymcovarianceMatrix (const RooArgList &vars, const char *cutSpec=0, const char *cutRange=0) const
 
TH1createHistogram (const char *name, const RooAbsRealLValue &xvar, const RooCmdArg &arg1=RooCmdArg::none(), const RooCmdArg &arg2=RooCmdArg::none(), const RooCmdArg &arg3=RooCmdArg::none(), const RooCmdArg &arg4=RooCmdArg::none(), const RooCmdArg &arg5=RooCmdArg::none(), const RooCmdArg &arg6=RooCmdArg::none(), const RooCmdArg &arg7=RooCmdArg::none(), const RooCmdArg &arg8=RooCmdArg::none()) const
 Calls createHistogram(const char *name, const RooAbsRealLValue& xvar, const RooLinkedList& argList) const. More...
 
TH1createHistogram (const char *name, const RooAbsRealLValue &xvar, const RooLinkedList &argList) const
 Create and fill a ROOT histogram TH1,TH2 or TH3 with the values of this dataset. More...
 
TH1createHistogram (const char *varNameList, const RooCmdArg &binArgX, const RooCmdArg &binArgY=RooCmdArg::none(), const RooCmdArg &binArgZ=RooCmdArg::none()) const
 Create and fill a ROOT histogram TH1,TH2 or TH3 with the values of this dataset for the variables with given names. More...
 
TH1createHistogram (const char *varNameList, Int_t xbins=0, Int_t ybins=0, Int_t zbins=0) const R__DEPRECATED(6
 Create and fill a ROOT histogram TH1,TH2 or TH3 with the values of this dataset for the variables with given names The range of each observable that is histogrammed is always automatically calculated from the distribution in the dataset. More...
 
TH2FcreateHistogram (const RooAbsRealLValue &var1, const RooAbsRealLValue &var2, const char *cuts="", const char *name="hist") const
 Create a TH2F histogram of the distribution of the specified variable using this dataset. More...
 
TH2FcreateHistogram (const RooAbsRealLValue &var1, const RooAbsRealLValue &var2, int nx, int ny, const char *cuts="", const char *name="hist") const
 Create a TH2F histogram of the distribution of the specified variable using this dataset. More...
 
Int_t defaultPrintContents (Option_t *opt) const override
 Define default print options, for a given print style. More...
 
void Draw (Option_t *option="") override
 Forward draw command to data store. More...
 
virtual RooAbsDataemptyClone (const char *newName=0, const char *newTitle=0, const RooArgSet *vars=0, const char *wgtVarName=0) const =0
 
virtual void fill ()
 
virtual TH1fillHistogram (TH1 *hist, const RooArgList &plotVars, const char *cuts="", const char *cutRange=0) const
 Loop over columns of our tree data and fill the input histogram. More...
 
virtual const RooArgSetget () const
 
virtual const RooArgSetget (Int_t index) const
 
RealSpans getBatches (std::size_t first=0, std::size_t len=std::numeric_limits< std::size_t >::max()) const
 Write information to retrieve data columns into evalData.spans. More...
 
CategorySpans getCategoryBatches (std::size_t first=0, std::size_t len=std::numeric_limits< std::size_t >::max()) const
 
TTreeGetClonedTree () const
 Return a clone of the TTree which stores the data or create such a tree if vector storage is used. More...
 
RooArgSet const * getGlobalObservables () const
 Returns snapshot of global observables stored in this data. More...
 
bool getRange (const RooAbsRealLValue &var, double &lowest, double &highest, double marginFrac=0, bool symMode=false) const
 Fill Doubles 'lowest' and 'highest' with the lowest and highest value of observable 'var' in this dataset. More...
 
RooAbsDatagetSimData (const char *idxstate)
 
virtual RooSpan< const doublegetWeightBatch (std::size_t first, std::size_t len, bool sumW2=false) const =0
 Return event weights of all events in range [first, first+len). More...
 
bool hasFilledCache () const
 
TClassIsA () const override
 
virtual bool isNonPoissonWeighted () const
 
virtual bool isWeighted () const
 
double kurtosis (const RooRealVar &var, const char *cutSpec=0, const char *cutRange=0) const
 
double mean (const RooRealVar &var, const char *cutSpec=0, const char *cutRange=0) const
 
RooRealVarmeanVar (const RooRealVar &var, const char *cutSpec=0, const char *cutRange=0) const
 Create a RooRealVar containing the mean of observable 'var' in this dataset. More...
 
double moment (const RooRealVar &var, double order, const char *cutSpec=0, const char *cutRange=0) const
 Calculate moment of requested order. More...
 
double moment (const RooRealVar &var, double order, double offset, const char *cutSpec=0, const char *cutRange=0) const
 Return the 'order'-ed moment of observable 'var' in this dataset. More...
 
const TNamednamePtr () const
 De-duplicated pointer to this object's name. More...
 
virtual Int_t numEntries () const
 Return number of entries in dataset, i.e., count unweighted entries. More...
 
RooAbsDataoperator= (const RooAbsData &other)
 
virtual RooPlotplotOn (RooPlot *frame, const RooCmdArg &arg1=RooCmdArg::none(), const RooCmdArg &arg2=RooCmdArg::none(), const RooCmdArg &arg3=RooCmdArg::none(), const RooCmdArg &arg4=RooCmdArg::none(), const RooCmdArg &arg5=RooCmdArg::none(), const RooCmdArg &arg6=RooCmdArg::none(), const RooCmdArg &arg7=RooCmdArg::none(), const RooCmdArg &arg8=RooCmdArg::none()) const
 
virtual RooPlotplotOn (RooPlot *frame, const RooLinkedList &cmdList) const
 Plot dataset on specified frame. More...
 
void Print (Option_t *options=0) const override
 Print TNamed name and title. More...
 
void printClassName (std::ostream &os) const override
 Print class name of dataset. More...
 
void printMultiline (std::ostream &os, Int_t contents, bool verbose=false, TString indent="") const override
 Interface for detailed printing of object. More...
 
void printName (std::ostream &os) const override
 Print name of dataset. More...
 
void printTitle (std::ostream &os) const override
 Print title of dataset. More...
 
void RecursiveRemove (TObject *obj) override
 If one of the TObject we have a referenced to is deleted, remove the reference. More...
 
RooAbsDatareduce (const char *cut)
 Create a subset of the data set by applying the given cut on the data points. More...
 
RooAbsDatareduce (const RooArgSet &varSubset, const char *cut=0)
 Create a subset of the data set by applying the given cut on the data points and reducing the dimensions to the specified set. More...
 
RooAbsDatareduce (const RooArgSet &varSubset, const RooFormulaVar &cutVar)
 Create a subset of the data set by applying the given cut on the data points and reducing the dimensions to the specified set. More...
 
RooAbsDatareduce (const RooCmdArg &arg1, const RooCmdArg &arg2=RooCmdArg(), const RooCmdArg &arg3=RooCmdArg(), const RooCmdArg &arg4=RooCmdArg(), const RooCmdArg &arg5=RooCmdArg(), const RooCmdArg &arg6=RooCmdArg(), const RooCmdArg &arg7=RooCmdArg(), const RooCmdArg &arg8=RooCmdArg())
 Create a reduced copy of this dataset. More...
 
RooAbsDatareduce (const RooFormulaVar &cutVar)
 Create a subset of the data set by applying the given cut on the data points. More...
 
virtual void reset ()
 
void resetBuffers ()
 
RooRealVarrmsVar (const RooRealVar &var, const char *cutSpec=0, const char *cutRange=0) const
 Create a RooRealVar containing the RMS of observable 'var' in this dataset. More...
 
void setDirtyProp (bool flag)
 Control propagation of dirty flags from observables in dataset. More...
 
void setGlobalObservables (RooArgSet const &globalObservables)
 Sets the global observables stored in this data. More...
 
void SetName (const char *name) override
 Set the name of the TNamed. More...
 
void SetNameTitle (const char *name, const char *title) override
 Set all the TNamed parameters (name and title). More...
 
double sigma (const RooRealVar &var, const char *cutSpec=0, const char *cutRange=0) const
 
double skewness (const RooRealVar &var, const char *cutSpec=0, const char *cutRange=0) const
 
virtual TListsplit (const RooAbsCategory &splitCat, bool createEmptyDataSets=false) const
 Split dataset into subsets based on states of given splitCat in this dataset. More...
 
virtual TListsplit (const RooSimultaneous &simpdf, bool createEmptyDataSets=false) const
 Split dataset into subsets based on the categorisation of the RooSimultaneous A TList of RooDataSets is returned in which each RooDataSet is named after the state name of splitCat of which it contains the dataset subset. More...
 
double standMoment (const RooRealVar &var, double order, const char *cutSpec=0, const char *cutRange=0) const
 Calculate standardized moment. More...
 
virtual RooPlotstatOn (RooPlot *frame, const char *what, const char *label="", Int_t sigDigits=2, Option_t *options="NELU", double xmin=0.15, double xmax=0.65, double ymax=0.85, const char *cutSpec=0, const char *cutRange=0, const RooCmdArg *formatCmd=0)
 Implementation back-end of statOn() method with named arguments. More...
 
virtual RooPlotstatOn (RooPlot *frame, const RooCmdArg &arg1=RooCmdArg::none(), const RooCmdArg &arg2=RooCmdArg::none(), const RooCmdArg &arg3=RooCmdArg::none(), const RooCmdArg &arg4=RooCmdArg::none(), const RooCmdArg &arg5=RooCmdArg::none(), const RooCmdArg &arg6=RooCmdArg::none(), const RooCmdArg &arg7=RooCmdArg::none(), const RooCmdArg &arg8=RooCmdArg::none())
 Add a box with statistics information to the specified frame. More...
 
RooAbsDataStorestore ()
 
const RooAbsDataStorestore () const
 
void Streamer (TBuffer &) override
 Stream an object of class RooAbsData. More...
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
virtual double sumEntries () const =0
 Return effective number of entries in dataset, i.e., sum all weights. More...
 
virtual double sumEntries (const char *cutSpec, const char *cutRange=0) const =0
 Return effective number of entries in dataset inside range or after cuts, i.e., sum certain weights. More...
 
double sumEntriesW2 () const
 Return sum of squared weights of this data. More...
 
virtual Roo1DTabletable (const RooAbsCategory &cat, const char *cuts="", const char *opts="") const
 Create and fill a 1-dimensional table for given category column This functions is the equivalent of plotOn() for category dimensions. More...
 
virtual Roo1DTabletable (const RooArgSet &catSet, const char *cuts="", const char *opts="") const
 Construct table for product of categories in catSet. More...
 
const TTreetree () const
 Return a pointer to the TTree which stores the data. More...
 
RooFit::UniqueId< RooAbsData > const & uniqueId () const
 Returns a unique ID that is different for every instantiated RooAbsData object. More...
 
virtual double weight () const =0
 
virtual void weightError (double &lo, double &hi, ErrorType=Poisson) const
 Return the asymmetric errors on the current weight. More...
 
virtual double weightError (ErrorType=Poisson) const
 Return the symmetric error on the current weight. More...
 
virtual double weightSquared () const =0
 
- Public Member Functions inherited from TNamed
 TNamed ()
 
 TNamed (const char *name, const char *title)
 
 TNamed (const TNamed &named)
 TNamed copy ctor. More...
 
 TNamed (const TString &name, const TString &title)
 
virtual ~TNamed ()
 TNamed destructor. More...
 
void Clear (Option_t *option="") override
 Set name and title to empty strings (""). More...
 
TObjectClone (const char *newname="") const override
 Make a clone of an object using the Streamer facility. More...
 
Int_t Compare (const TObject *obj) const override
 Compare two TNamed objects. More...
 
void Copy (TObject &named) const override
 Copy this to obj. More...
 
virtual void FillBuffer (char *&buffer)
 Encode TNamed into output buffer. More...
 
const char * GetName () const override
 Returns name of object. More...
 
const char * GetTitle () const override
 Returns title of object. More...
 
ULong_t Hash () const override
 Return hash value for this object. More...
 
TClassIsA () const override
 
Bool_t IsSortable () const override
 
void ls (Option_t *option="") const override
 List TNamed name and title. More...
 
TNamedoperator= (const TNamed &rhs)
 TNamed assignment operator. More...
 
void Print (Option_t *option="") const override
 Print TNamed name and title. More...
 
virtual void SetName (const char *name)
 Set the name of the TNamed. More...
 
virtual void SetNameTitle (const char *name, const char *title)
 Set all the TNamed parameters (name and title). More...
 
virtual void SetTitle (const char *title="")
 Set the title of the TNamed. More...
 
virtual Int_t Sizeof () const
 Return size of the TNamed part of the TObject. More...
 
void Streamer (TBuffer &) override
 Stream an object of class TObject. More...
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
- Public Member Functions inherited from TObject
 TObject ()
 TObject constructor. More...
 
 TObject (const TObject &object)
 TObject copy ctor. More...
 
virtual ~TObject ()
 TObject destructor. More...
 
void AbstractMethod (const char *method) const
 Use this method to implement an "abstract" method that you don't want to leave purely abstract. More...
 
virtual void AppendPad (Option_t *option="")
 Append graphics object to current pad. More...
 
virtual void Browse (TBrowser *b)
 Browse object. May be overridden for another default action. More...
 
ULong_t CheckedHash ()
 Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object. More...
 
virtual const char * ClassName () const
 Returns name of class to which the object belongs. More...
 
virtual void Clear (Option_t *="")
 
virtual TObjectClone (const char *newname="") const
 Make a clone of an object using the Streamer facility. More...
 
virtual Int_t Compare (const TObject *obj) const
 Compare abstract method. More...
 
virtual void Copy (TObject &object) const
 Copy this to obj. More...
 
virtual void Delete (Option_t *option="")
 Delete this object. More...
 
virtual Int_t DistancetoPrimitive (Int_t px, Int_t py)
 Computes distance from point (px,py) to the object. More...
 
virtual void Draw (Option_t *option="")
 Default Draw method for all objects. More...
 
virtual void DrawClass () const
 Draw class inheritance tree of the class to which this object belongs. More...
 
virtual TObjectDrawClone (Option_t *option="") const
 Draw a clone of this object in the current selected pad for instance with: gROOT->SetSelectedPad(gPad). More...
 
virtual void Dump () const
 Dump contents of object on stdout. More...
 
virtual void Error (const char *method, const char *msgfmt,...) const
 Issue error message. More...
 
virtual void Execute (const char *method, const char *params, Int_t *error=0)
 Execute method on this object with the given parameter string, e.g. More...
 
virtual void Execute (TMethod *method, TObjArray *params, Int_t *error=0)
 Execute method on this object with parameters stored in the TObjArray. More...
 
virtual void ExecuteEvent (Int_t event, Int_t px, Int_t py)
 Execute action corresponding to an event at (px,py). More...
 
virtual void Fatal (const char *method, const char *msgfmt,...) const
 Issue fatal error message. More...
 
virtual TObjectFindObject (const char *name) const
 Must be redefined in derived classes. More...
 
virtual TObjectFindObject (const TObject *obj) const
 Must be redefined in derived classes. More...
 
virtual Option_tGetDrawOption () const
 Get option used by the graphics system to draw this object. More...
 
virtual const char * GetIconName () const
 Returns mime type name of object. More...
 
virtual const char * GetName () const
 Returns name of object. More...
 
virtual char * GetObjectInfo (Int_t px, Int_t py) const
 Returns string containing info about the object at position (px,py). More...
 
virtual Option_tGetOption () const
 
virtual const char * GetTitle () const
 Returns title of object. More...
 
virtual UInt_t GetUniqueID () const
 Return the unique object id. More...
 
virtual Bool_t HandleTimer (TTimer *timer)
 Execute action in response of a timer timing out. More...
 
virtual ULong_t Hash () const
 Return hash value for this object. More...
 
Bool_t HasInconsistentHash () const
 Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e. More...
 
virtual void Info (const char *method, const char *msgfmt,...) const
 Issue info message. More...
 
virtual Bool_t InheritsFrom (const char *classname) const
 Returns kTRUE if object inherits from class "classname". More...
 
virtual Bool_t InheritsFrom (const TClass *cl) const
 Returns kTRUE if object inherits from TClass cl. More...
 
virtual void Inspect () const
 Dump contents of this object in a graphics canvas. More...
 
void InvertBit (UInt_t f)
 
virtual TClassIsA () const
 
virtual Bool_t IsEqual (const TObject *obj) const
 Default equal comparison (objects are equal if they have the same address in memory). More...
 
virtual Bool_t IsFolder () const
 Returns kTRUE in case object contains browsable objects (like containers or lists of other objects). More...
 
R__ALWAYS_INLINE Bool_t IsOnHeap () const
 
virtual Bool_t IsSortable () const
 
R__ALWAYS_INLINE Bool_t IsZombie () const
 
virtual void ls (Option_t *option="") const
 The ls function lists the contents of a class on stdout. More...
 
void MayNotUse (const char *method) const
 Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary). More...
 
virtual Bool_t Notify ()
 This method must be overridden to handle object notification. More...
 
void Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const
 Use this method to declare a method obsolete. More...
 
void operator delete (void *ptr)
 Operator delete. More...
 
void operator delete[] (void *ptr)
 Operator delete []. More...
 
void * operator new (size_t sz)
 
void * operator new (size_t sz, void *vp)
 
void * operator new[] (size_t sz)
 
void * operator new[] (size_t sz, void *vp)
 
TObjectoperator= (const TObject &rhs)
 TObject assignment operator. More...
 
virtual void Paint (Option_t *option="")
 This method must be overridden if a class wants to paint itself. More...
 
virtual void Pop ()
 Pop on object drawn in a pad to the top of the display list. More...
 
virtual void Print (Option_t *option="") const
 This method must be overridden when a class wants to print itself. More...
 
virtual Int_t Read (const char *name)
 Read contents of object with specified name from the current directory. More...
 
virtual void RecursiveRemove (TObject *obj)
 Recursively remove this object from a list. More...
 
void ResetBit (UInt_t f)
 
virtual void SaveAs (const char *filename="", Option_t *option="") const
 Save this object in the file specified by filename. More...
 
virtual void SavePrimitive (std::ostream &out, Option_t *option="")
 Save a primitive as a C++ statement(s) on output stream "out". More...
 
void SetBit (UInt_t f)
 
void SetBit (UInt_t f, Bool_t set)
 Set or unset the user status bits as specified in f. More...
 
virtual void SetDrawOption (Option_t *option="")
 Set drawing option for object. More...
 
virtual void SetUniqueID (UInt_t uid)
 Set the unique object id. More...
 
virtual void Streamer (TBuffer &)
 Stream an object of class TObject. More...
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
virtual void SysError (const char *method, const char *msgfmt,...) const
 Issue system error message. More...
 
R__ALWAYS_INLINE Bool_t TestBit (UInt_t f) const
 
Int_t TestBits (UInt_t f) const
 
virtual void UseCurrentStyle ()
 Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked. More...
 
virtual void Warning (const char *method, const char *msgfmt,...) const
 Issue warning message. More...
 
virtual Int_t Write (const char *name=0, Int_t option=0, Int_t bufsize=0)
 Write this object to the current directory. More...
 
virtual Int_t Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const
 Write this object to the current directory. More...
 
- Public Member Functions inherited from RooPrintable
 RooPrintable ()
 
virtual ~RooPrintable ()
 
virtual Int_t defaultPrintContents (Option_t *opt) const
 Default choice of contents to be printed (name and value) More...
 
virtual StyleOption defaultPrintStyle (Option_t *opt) const
 
virtual TClassIsA () const
 
virtual void printAddress (std::ostream &os) const
 Print class name of object. More...
 
virtual void printArgs (std::ostream &os) const
 Interface for printing of object arguments. More...
 
virtual void printClassName (std::ostream &os) const
 Print class name of object. More...
 
virtual void printExtras (std::ostream &os) const
 Interface to print extras of object. More...
 
virtual void printMultiline (std::ostream &os, Int_t contents, bool verbose=false, TString indent="") const
 Interface for detailed printing of object. More...
 
virtual void printName (std::ostream &os) const
 Print name of object. More...
 
virtual void printStream (std::ostream &os, Int_t contents, StyleOption style, TString indent="") const
 Print description of object on ostream, printing contents set by contents integer, which is interpreted as an OR of 'enum ContentsOptions' values and in the style given by 'enum StyleOption'. More...
 
virtual void printTitle (std::ostream &os) const
 Print title of object. More...
 
virtual void printTree (std::ostream &os, TString indent="") const
 Interface for tree structure printing of object. More...
 
virtual void printValue (std::ostream &os) const
 Interface to print value of object. More...
 
virtual void Streamer (TBuffer &)
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 

Static Public Member Functions

static void claimVars (RooAbsData *)
 
static TClassClass ()
 
static const char * Class_Name ()
 
static Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static StorageType getDefaultStorageType ()
 
static bool releaseVars (RooAbsData *)
 If return value is true variables can be deleted. More...
 
static void setDefaultStorageType (StorageType s)
 
- Static Public Member Functions inherited from TNamed
static TClassClass ()
 
static const char * Class_Name ()
 
static Version_t Class_Version ()
 
static const char * DeclFileName ()
 
- Static Public Member Functions inherited from TObject
static TClassClass ()
 
static const char * Class_Name ()
 
static Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static Longptr_t GetDtorOnly ()
 Return destructor only flag. More...
 
static Bool_t GetObjectStat ()
 Get status of object stat flag. More...
 
static void SetDtorOnly (void *obj)
 Set destructor only flag. More...
 
static void SetObjectStat (Bool_t stat)
 Turn on/off tracking of objects in the TObjectTable. More...
 
- Static Public Member Functions inherited from RooPrintable
static TClassClass ()
 
static const char * Class_Name ()
 
static Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static std::ostream & defaultPrintStream (std::ostream *os=0)
 Return a reference to the current default stream to use in Print(). More...
 
static void nameFieldLength (Int_t newLen)
 Set length of field reserved from printing name of RooAbsArgs in multi-line collection printing to given amount. More...
 

Public Attributes

TH1 Use the overload of RooAbsData::createHistogram that takes RooFit command arguments
 

Protected Member Functions

bool allClientsCached (RooAbsArg *, const RooArgSet &)
 Utility function that determines if all clients of object 'var' appear in given list of cached nodes. More...
 
virtual void attachCache (const RooAbsArg *newOwner, const RooArgSet &cachedVars)
 Internal method – Attach dataset copied with cache contents to copied instances of functions. More...
 
virtual void cacheArgs (const RooAbsArg *owner, RooArgSet &varSet, const RooArgSet *nset=0, bool skipZeroWeights=false)
 Internal method – Cache given set of functions with data. More...
 
double corrcov (const RooRealVar &x, const RooRealVar &y, const char *cutSpec, const char *cutRange, bool corr) const
 Internal method to calculate single correlation and covariance elements. More...
 
TMatrixDSymcorrcovMatrix (const RooArgList &vars, const char *cutSpec, const char *cutRange, bool corr) const
 Return covariance matrix from data for given list of observables. More...
 
RooRealVardataRealVar (const char *methodname, const RooRealVar &extVar) const
 Internal method to check if given RooRealVar maps to a RooRealVar in this dataset. More...
 
virtual void optimizeReadingWithCaching (RooAbsArg &arg, const RooArgSet &cacheList, const RooArgSet &keepObsList)
 Prepare dataset for use with cached constant terms listed in 'cacheList' of expression 'arg'. More...
 
virtual RooPlotplotAsymOn (RooPlot *frame, const RooAbsCategoryLValue &asymCat, PlotOpt o) const
 Create and fill a histogram with the asymmetry N[+] - N[-] / ( N[+] + N[-] ), where N(+/-) is the number of data points with asymCat=+1 and asymCat=-1 as function of the frames variable. More...
 
virtual RooPlotplotEffOn (RooPlot *frame, const RooAbsCategoryLValue &effCat, PlotOpt o) const
 Create and fill a histogram with the efficiency N[1] / ( N[1] + N[0] ), where N(1/0) is the number of data points with effCat=1 and effCat=0 as function of the frames variable. More...
 
virtual RooPlotplotOn (RooPlot *frame, PlotOpt o) const
 Create and fill a histogram of the frame's variable and append it to the frame. More...
 
virtual RooAbsDatareduceEng (const RooArgSet &varSubset, const RooFormulaVar *cutVar, const char *cutRange=0, std::size_t nStart=0, std::size_t=std::numeric_limits< std::size_t >::max())=0
 
virtual void resetCache ()
 Internal method – Remove cached function values. More...
 
virtual void setArgStatus (const RooArgSet &set, bool active)
 
- Protected Member Functions inherited from TObject
virtual void DoError (int level, const char *location, const char *fmt, va_list va) const
 Interface to ErrorHandler (protected). More...
 
void MakeZombie ()
 

Protected Attributes

RooArgSet _cachedVars
 ! External variables cached with this data set More...
 
RooAbsDataStore_dstore = nullptr
 Data storage implementation. More...
 
std::unique_ptr< RooArgSet_globalObservables
 Snapshot of global observables. More...
 
const TNamed_namePtr = nullptr
 ! De-duplicated name pointer. This will be equal for all objects with the same name. More...
 
std::map< std::string, RooAbsData * > _ownedComponents
 Owned external components. More...
 
RooArgSet _vars
 Dimensions of this data set. More...
 
StorageType storageType
 
- Protected Attributes inherited from TNamed
TString fName
 
TString fTitle
 

Static Protected Attributes

static StorageType defaultStorageType =RooAbsData::Vector
 
- Static Protected Attributes inherited from RooPrintable
static Int_t _nameLength
 

Private Member Functions

void copyGlobalObservables (const RooAbsData &other)
 

Private Attributes

const RooFit::UniqueId< RooAbsData_uniqueId
 ! More...
 

Friends

class RooAbsArg
 
class RooAbsCachedPdf
 
class RooAbsOptTestStatistic
 
class RooAbsReal
 
struct RooFit::TestStatistics::ConstantTermsOptimizer
 
class RooFit::TestStatistics::RooAbsL
 

Additional Inherited Members

- Protected Types inherited from TObject
enum  { kOnlyPrepStep = (1ULL << ( 3 )) }
 

#include <RooAbsData.h>

Inheritance diagram for RooAbsData:
[legend]

Member Typedef Documentation

◆ CategorySpans

◆ RealSpans

Definition at line 136 of file RooAbsData.h.

Member Enumeration Documentation

◆ ErrorType

Enumerator
Poisson 
SumW2 
None 
Auto 
Expected 

Definition at line 113 of file RooAbsData.h.

◆ StorageType

Enumerator
Tree 
Vector 
Composite 

Definition at line 294 of file RooAbsData.h.

Constructor & Destructor Documentation

◆ RooAbsData() [1/3]

RooAbsData::RooAbsData ( )

Default constructor.

Definition at line 173 of file RooAbsData.cxx.

◆ RooAbsData() [2/3]

RooAbsData::RooAbsData ( RooStringView  name,
RooStringView  title,
const RooArgSet vars,
RooAbsDataStore dstore = 0 
)

Constructor from a set of variables.

Only fundamental elements of vars (RooRealVar,RooCategory etc) are stored as part of the dataset

Definition at line 185 of file RooAbsData.cxx.

◆ RooAbsData() [3/3]

RooAbsData::RooAbsData ( const RooAbsData other,
const char *  newname = 0 
)

Copy constructor.

Definition at line 226 of file RooAbsData.cxx.

◆ ~RooAbsData()

RooAbsData::~RooAbsData ( )
override

Destructor.

Definition at line 326 of file RooAbsData.cxx.

Member Function Documentation

◆ add()

virtual void RooAbsData::add ( const RooArgSet row,
double  weight = 1,
double  weightError = 0 
)
pure virtual

Implemented in RooDataHist, and RooDataSet.

◆ addOwnedComponent()

void RooAbsData::addOwnedComponent ( const char *  idxlabel,
RooAbsData data 
)

Definition at line 2503 of file RooAbsData.cxx.

◆ allClientsCached()

bool RooAbsData::allClientsCached ( RooAbsArg var,
const RooArgSet cacheList 
)
protected

Utility function that determines if all clients of object 'var' appear in given list of cached nodes.

Definition at line 2457 of file RooAbsData.cxx.

◆ attachBuffers()

void RooAbsData::attachBuffers ( const RooArgSet extObs)

Definition at line 2474 of file RooAbsData.cxx.

◆ attachCache()

void RooAbsData::attachCache ( const RooAbsArg newOwner,
const RooArgSet cachedVars 
)
protectedvirtual

Internal method – Attach dataset copied with cache contents to copied instances of functions.

Definition at line 419 of file RooAbsData.cxx.

◆ cacheArgs()

void RooAbsData::cacheArgs ( const RooAbsArg owner,
RooArgSet varSet,
const RooArgSet nset = 0,
bool  skipZeroWeights = false 
)
protectedvirtual

Internal method – Cache given set of functions with data.

Definition at line 402 of file RooAbsData.cxx.

◆ canSplitFast()

bool RooAbsData::canSplitFast ( ) const

Definition at line 2488 of file RooAbsData.cxx.

◆ changeObservableName()

bool RooAbsData::changeObservableName ( const char *  from,
const char *  to 
)
virtual

Definition at line 359 of file RooAbsData.cxx.

◆ checkInit()

void RooAbsData::checkInit ( ) const

Definition at line 2529 of file RooAbsData.cxx.

◆ claimVars()

void RooAbsData::claimVars ( RooAbsData data)
static

Definition at line 151 of file RooAbsData.cxx.

◆ Class()

static TClass * RooAbsData::Class ( )
static
Returns
TClass describing this class

◆ Class_Name()

static const char * RooAbsData::Class_Name ( )
static
Returns
Name of this class

◆ Class_Version()

static Version_t RooAbsData::Class_Version ( )
inlinestatic
Returns
Version of this class

Definition at line 381 of file RooAbsData.h.

◆ convertToTreeStore()

void RooAbsData::convertToTreeStore ( )
virtual

Convert vector-based storage to tree-based storage.

Reimplemented in RooDataSet.

Definition at line 2583 of file RooAbsData.cxx.

◆ convertToVectorStore()

void RooAbsData::convertToVectorStore ( )

Convert tree-based storage to vector-based storage.

Definition at line 348 of file RooAbsData.cxx.

◆ copyGlobalObservables()

void RooAbsData::copyGlobalObservables ( const RooAbsData other)
private

Definition at line 312 of file RooAbsData.cxx.

◆ corrcov()

double RooAbsData::corrcov ( const RooRealVar x,
const RooRealVar y,
const char *  cutSpec,
const char *  cutRange,
bool  corr 
) const
protected

Internal method to calculate single correlation and covariance elements.

Definition at line 1057 of file RooAbsData.cxx.

◆ corrcovMatrix()

TMatrixDSym * RooAbsData::corrcovMatrix ( const RooArgList vars,
const char *  cutSpec,
const char *  cutRange,
bool  corr 
) const
protected

Return covariance matrix from data for given list of observables.

Definition at line 1113 of file RooAbsData.cxx.

◆ correlation()

double RooAbsData::correlation ( RooRealVar x,
RooRealVar y,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const
inline

Definition at line 263 of file RooAbsData.h.

◆ correlationMatrix() [1/2]

TMatrixDSym * RooAbsData::correlationMatrix ( const char *  cutSpec = 0,
const char *  cutRange = 0 
) const
inline

Definition at line 266 of file RooAbsData.h.

◆ correlationMatrix() [2/2]

TMatrixDSym * RooAbsData::correlationMatrix ( const RooArgList vars,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const
inline

Definition at line 268 of file RooAbsData.h.

◆ covariance()

double RooAbsData::covariance ( RooRealVar x,
RooRealVar y,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const
inline

Definition at line 262 of file RooAbsData.h.

◆ covarianceMatrix() [1/2]

TMatrixDSym * RooAbsData::covarianceMatrix ( const char *  cutSpec = 0,
const char *  cutRange = 0 
) const
inline

Definition at line 265 of file RooAbsData.h.

◆ covarianceMatrix() [2/2]

TMatrixDSym * RooAbsData::covarianceMatrix ( const RooArgList vars,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const
inline

Definition at line 267 of file RooAbsData.h.

◆ createHistogram() [1/6]

RooAbsData::createHistogram ( const char *  name,
const RooAbsRealLValue xvar,
const RooCmdArg arg1 = RooCmdArg::none(),
const RooCmdArg arg2 = RooCmdArg::none(),
const RooCmdArg arg3 = RooCmdArg::none(),
const RooCmdArg arg4 = RooCmdArg::none(),
const RooCmdArg arg5 = RooCmdArg::none(),
const RooCmdArg arg6 = RooCmdArg::none(),
const RooCmdArg arg7 = RooCmdArg::none(),
const RooCmdArg arg8 = RooCmdArg::none() 
) const

Calls createHistogram(const char *name, const RooAbsRealLValue& xvar, const RooLinkedList& argList) const.

PyROOT

The RooAbsData::createHistogram() function is pythonized with the command argument pythonization. The keywords must correspond to the CmdArgs of the function.

Definition at line 694 of file RooAbsData.cxx.

◆ createHistogram() [2/6]

TH1 * RooAbsData::createHistogram ( const char *  name,
const RooAbsRealLValue xvar,
const RooLinkedList argListIn 
) const

Create and fill a ROOT histogram TH1,TH2 or TH3 with the values of this dataset.

This function accepts the following arguments.

Parameters
[in]nameName of the ROOT histogram
[in]xvarObservable to be mapped on x axis of ROOT histogram
[in]argListInlist of input arguments
Returns
Histogram now owned by user.
AutoBinning(Int_t nbins, Double_y margin) Automatically calculate range with given added fractional margin, set binning to nbins
AutoSymBinning(Int_t nbins, Double_y margin) Automatically calculate range with given added fractional margin, with additional constraint that mean of data is in center of range, set binning to nbins
Binning(const char* name) Apply binning with given name to x axis of histogram
Binning(RooAbsBinning& binning) Apply specified binning to x axis of histogram
Binning(int nbins, double lo, double hi)

Apply specified binning to x axis of histogram

YVar(const RooAbsRealLValue& var,...) Observable to be mapped on y axis of ROOT histogram
ZVar(const RooAbsRealLValue& var,...) Observable to be mapped on z axis of ROOT histogram

The YVar() and ZVar() arguments can be supplied with optional Binning() Auto(Sym)Range() arguments to control the binning of the Y and Z axes, e.g.

createHistogram("histo",x,Binning(-1,1,20), YVar(y,Binning(-1,1,30)), ZVar(z,Binning("zbinning")))
TH1 * createHistogram(const char *name, const RooAbsRealLValue &xvar, const RooCmdArg &arg1=RooCmdArg::none(), const RooCmdArg &arg2=RooCmdArg::none(), const RooCmdArg &arg3=RooCmdArg::none(), const RooCmdArg &arg4=RooCmdArg::none(), const RooCmdArg &arg5=RooCmdArg::none(), const RooCmdArg &arg6=RooCmdArg::none(), const RooCmdArg &arg7=RooCmdArg::none(), const RooCmdArg &arg8=RooCmdArg::none()) const
Calls createHistogram(const char *name, const RooAbsRealLValue& xvar, const RooLinkedList& argList) c...
Definition: RooAbsData.cxx:694
RooCmdArg YVar(const RooAbsRealLValue &var, const RooCmdArg &arg=RooCmdArg::none())
RooCmdArg ZVar(const RooAbsRealLValue &var, const RooCmdArg &arg=RooCmdArg::none())
RooCmdArg Binning(const RooAbsBinning &binning)
Double_t y[n]
Definition: legend1.C:17

The caller takes ownership of the returned histogram

Definition at line 806 of file RooAbsData.cxx.

◆ createHistogram() [3/6]

TH1 * RooAbsData::createHistogram ( const char *  varNameList,
const RooCmdArg binArgX,
const RooCmdArg binArgY = RooCmdArg::none(),
const RooCmdArg binArgZ = RooCmdArg::none() 
) const

Create and fill a ROOT histogram TH1,TH2 or TH3 with the values of this dataset for the variables with given names.

Parameters
[in]varNameListComma-separated variable names.
[in]binArgXControl the binning for the x variable.
[in]binArgYControl the binning for the y variable.
[in]binArgZControl the binning for the z variable.
Returns
Histogram now owned by user.

The possible binning command arguments for each axis are:

AutoBinning(Int_t nbins, Double_y margin) Automatically calculate range with given added fractional margin, set binning to nbins
AutoSymBinning(Int_t nbins, Double_y margin) Automatically calculate range with given added fractional margin, with additional constraint that mean of data is in center of range, set binning to nbins
Binning(const char* name) Apply binning with given name to x axis of histogram
Binning(RooAbsBinning& binning) Apply specified binning to x axis of histogram
Binning(int nbins, double lo, double hi)

Apply specified binning to x axis of histogram

YVar(const RooAbsRealLValue& var,...) Observable to be mapped on y axis of ROOT histogram
ZVar(const RooAbsRealLValue& var,...) Observable to be mapped on z axis of ROOT histogram

Definition at line 731 of file RooAbsData.cxx.

◆ createHistogram() [4/6]

TH1 * RooAbsData::createHistogram ( const char *  varNameList,
Int_t  xbins = 0,
Int_t  ybins = 0,
Int_t  zbins = 0 
) const

Create and fill a ROOT histogram TH1,TH2 or TH3 with the values of this dataset for the variables with given names The range of each observable that is histogrammed is always automatically calculated from the distribution in the dataset.

The number of bins can be controlled using the [xyz]bins parameters. For a greater degree of control use the createHistogram() method below with named arguments

The caller takes ownership of the returned histogram

Deprecated:
This function is deprecated and will be removed in ROOT v6.30. Use the overload RooAbsData::createHistogram(const char*, const RooCmdArg&, const RooCmdArg&, const RooCmdArg&) that takes RooFit command arguments.

Definition at line 632 of file RooAbsData.cxx.

◆ createHistogram() [5/6]

TH2F * RooAbsData::createHistogram ( const RooAbsRealLValue var1,
const RooAbsRealLValue var2,
const char *  cuts = "",
const char *  name = "hist" 
) const

Create a TH2F histogram of the distribution of the specified variable using this dataset.

Apply any cuts to select which events are used. The variable being plotted can either be contained directly in this dataset, or else be a function of the variables in this dataset. The histogram will be created using RooAbsReal::createHistogram() with the name provided (with our dataset name prepended).

Definition at line 2694 of file RooAbsData.cxx.

◆ createHistogram() [6/6]

TH2F * RooAbsData::createHistogram ( const RooAbsRealLValue var1,
const RooAbsRealLValue var2,
int  nx,
int  ny,
const char *  cuts = "",
const char *  name = "hist" 
) const

Create a TH2F histogram of the distribution of the specified variable using this dataset.

Apply any cuts to select which events are used. The variable being plotted can either be contained directly in this dataset, or else be a function of the variables in this dataset. The histogram will be created using RooAbsReal::createHistogram() with the name provided (with our dataset name prepended).

Definition at line 2709 of file RooAbsData.cxx.

◆ dataRealVar()

RooRealVar * RooAbsData::dataRealVar ( const char *  methodname,
const RooRealVar extVar 
) const
protected

Internal method to check if given RooRealVar maps to a RooRealVar in this dataset.

Definition at line 1038 of file RooAbsData.cxx.

◆ DeclFileName()

static const char * RooAbsData::DeclFileName ( )
inlinestatic
Returns
Name of the file containing the class declaration

Definition at line 381 of file RooAbsData.h.

◆ defaultPrintContents()

Int_t RooAbsData::defaultPrintContents ( Option_t opt) const
overridevirtual

Define default print options, for a given print style.

Reimplemented from RooPrintable.

Definition at line 947 of file RooAbsData.cxx.

◆ Draw()

void RooAbsData::Draw ( Option_t option = "")
overridevirtual

Forward draw command to data store.

Reimplemented from TObject.

Definition at line 2537 of file RooAbsData.cxx.

◆ emptyClone()

virtual RooAbsData * RooAbsData::emptyClone ( const char *  newName = 0,
const char *  newTitle = 0,
const RooArgSet vars = 0,
const char *  wgtVarName = 0 
) const
pure virtual

Implemented in RooDataHist, and RooDataSet.

◆ fill()

void RooAbsData::fill ( )
virtual

Definition at line 372 of file RooAbsData.cxx.

◆ fillHistogram()

TH1 * RooAbsData::fillHistogram ( TH1 hist,
const RooArgList plotVars,
const char *  cuts = "",
const char *  cutRange = 0 
) const
virtual

Loop over columns of our tree data and fill the input histogram.

Returns a pointer to the input histogram, or zero in case of an error. The input histogram can be any TH1 subclass, and therefore of arbitrary dimension. Variables are matched with the (x,y,...) dimensions of the input histogram according to the order in which they appear in the input plotVars list.

Definition at line 1399 of file RooAbsData.cxx.

◆ get() [1/2]

virtual const RooArgSet * RooAbsData::get ( ) const
inlinevirtual

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 106 of file RooAbsData.h.

◆ get() [2/2]

const RooArgSet * RooAbsData::get ( Int_t  index) const
virtual

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 393 of file RooAbsData.cxx.

◆ getBatches()

RooAbsData::RealSpans RooAbsData::getBatches ( std::size_t  begin = 0,
std::size_t  len = std::numeric_limits<std::size_t>::max() 
) const

Write information to retrieve data columns into evalData.spans.

All spans belonging to variables of this dataset are overwritten. Spans to other variables remain intact.

Parameters
[out]evalDataStore references to all data batches in this struct's spans. The key to retrieve an item is the pointer of the variable that owns the data.
beginIndex of first event that ends up in the batch.
lenNumber of events in each batch.

Definition at line 2677 of file RooAbsData.cxx.

◆ getCategoryBatches()

RooAbsData::CategorySpans RooAbsData::getCategoryBatches ( std::size_t  first = 0,
std::size_t  len = std::numeric_limits<std::size_t>::max() 
) const

Definition at line 2682 of file RooAbsData.cxx.

◆ GetClonedTree()

TTree * RooAbsData::GetClonedTree ( ) const

Return a clone of the TTree which stores the data or create such a tree if vector storage is used.

The user is responsible for deleting the tree

Definition at line 2569 of file RooAbsData.cxx.

◆ getDefaultStorageType()

RooAbsData::StorageType RooAbsData::getDefaultStorageType ( )
static

Definition at line 144 of file RooAbsData.cxx.

◆ getGlobalObservables()

RooArgSet const * RooAbsData::getGlobalObservables ( ) const
inline

Returns snapshot of global observables stored in this data.

Returns
Pointer to a RooArgSet with the snapshot of global observables stored in the data. Can be nullptr if no global observables are stored.

Definition at line 304 of file RooAbsData.h.

◆ getRange()

bool RooAbsData::getRange ( const RooAbsRealLValue var,
double lowest,
double highest,
double  marginFrac = 0,
bool  symMode = false 
) const

Fill Doubles 'lowest' and 'highest' with the lowest and highest value of observable 'var' in this dataset.

If the return value is true and error occurred

Definition at line 2335 of file RooAbsData.cxx.

◆ getSimData()

RooAbsData * RooAbsData::getSimData ( const char *  idxstate)

Definition at line 2495 of file RooAbsData.cxx.

◆ getWeightBatch()

virtual RooSpan< const double > RooAbsData::getWeightBatch ( std::size_t  first,
std::size_t  len,
bool  sumW2 = false 
) const
pure virtual

Return event weights of all events in range [first, first+len).

If no contiguous structure of weights is stored, an empty batch can be returned. This indicates that the weight is constant. Use weight() to retrieve it.

Implemented in RooDataSet, and RooDataHist.

◆ hasFilledCache()

bool RooAbsData::hasFilledCache ( ) const

Definition at line 2544 of file RooAbsData.cxx.

◆ IsA()

TClass * RooAbsData::IsA ( ) const
inlineoverridevirtual
Returns
TClass describing current object

Reimplemented from TNamed.

Reimplemented in RooDataHist, RooDataSet, and RooTreeData.

Definition at line 381 of file RooAbsData.h.

◆ isNonPoissonWeighted()

virtual bool RooAbsData::isNonPoissonWeighted ( ) const
inlinevirtual

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 161 of file RooAbsData.h.

◆ isWeighted()

virtual bool RooAbsData::isWeighted ( ) const
inlinevirtual

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 157 of file RooAbsData.h.

◆ kurtosis()

double RooAbsData::kurtosis ( const RooRealVar var,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const
inline

Definition at line 260 of file RooAbsData.h.

◆ mean()

double RooAbsData::mean ( const RooRealVar var,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const
inline

Definition at line 257 of file RooAbsData.h.

◆ meanVar()

RooRealVar * RooAbsData::meanVar ( const RooRealVar var,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const

Create a RooRealVar containing the mean of observable 'var' in this dataset.

If cutSpec and/or cutRange are specified the moment is calculated on the subset of the data which pass the C++ cut specification expression 'cutSpec' and/or are inside the range named 'cutRange'

Definition at line 1192 of file RooAbsData.cxx.

◆ moment() [1/2]

double RooAbsData::moment ( const RooRealVar var,
double  order,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const

Calculate moment of requested order.

Parameters
[in]varVariable to be used for calculating the moment.
[in]orderOrder of the moment.
[in]cutSpecIf specified, the moment is calculated on the subset of the data which pass the C++ cut specification expression 'cutSpec'
[in]cutRangeIf specified, calculate inside the range named 'cutRange' (also applies cut spec)
Returns
\( \left< \left( X - \left< X \right> \right)^n \right> \) of order \(n\).

Definition at line 980 of file RooAbsData.cxx.

◆ moment() [2/2]

double RooAbsData::moment ( const RooRealVar var,
double  order,
double  offset,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const

Return the 'order'-ed moment of observable 'var' in this dataset.

If offset is non-zero it is subtracted from the values of 'var' prior to the moment calculation. If cutSpec and/or cutRange are specified the moment is calculated on the subset of the data which pass the C++ cut specification expression 'cutSpec' and/or are inside the range named 'cutRange'

Definition at line 993 of file RooAbsData.cxx.

◆ namePtr()

const TNamed * RooAbsData::namePtr ( ) const
inline

De-duplicated pointer to this object's name.

This can be used for fast name comparisons. like if (namePtr() == other.namePtr()).

Note
TNamed::GetName() will return a pointer that's different for each object, but namePtr() always points to a unique instance.

Definition at line 313 of file RooAbsData.h.

◆ numEntries()

Int_t RooAbsData::numEntries ( ) const
virtual

Return number of entries in dataset, i.e., count unweighted entries.

Reimplemented in RooDataHist.

Definition at line 379 of file RooAbsData.cxx.

◆ operator=()

RooAbsData & RooAbsData::operator= ( const RooAbsData other)

Definition at line 269 of file RooAbsData.cxx.

◆ optimizeReadingWithCaching()

void RooAbsData::optimizeReadingWithCaching ( RooAbsArg arg,
const RooArgSet cacheList,
const RooArgSet keepObsList 
)
protectedvirtual

Prepare dataset for use with cached constant terms listed in 'cacheList' of expression 'arg'.

Deactivate tree branches for any dataset observable that is either not used at all, or is used exclusively by cached branch nodes.

Definition at line 2400 of file RooAbsData.cxx.

◆ plotAsymOn()

RooPlot * RooAbsData::plotAsymOn ( RooPlot frame,
const RooAbsCategoryLValue asymCat,
PlotOpt  o 
) const
protectedvirtual

Create and fill a histogram with the asymmetry N[+] - N[-] / ( N[+] + N[-] ), where N(+/-) is the number of data points with asymCat=+1 and asymCat=-1 as function of the frames variable.

The asymmetry category 'asymCat' must have exactly 2 (or 3) states defined with index values +1,-1 (and 0)

The plot range and the number of plot bins is determined by the parameters of the plot variable of the frame (RooAbsReal::setPlotRange(), RooAbsReal::setPlotBins())

The optional cut string expression can be used to select the events to be plotted. The cut specification may refer to any variable contained in the data set

The drawOptions are passed to the TH1::Draw() method

Definition at line 2107 of file RooAbsData.cxx.

◆ plotEffOn()

RooPlot * RooAbsData::plotEffOn ( RooPlot frame,
const RooAbsCategoryLValue effCat,
PlotOpt  o 
) const
protectedvirtual

Create and fill a histogram with the efficiency N[1] / ( N[1] + N[0] ), where N(1/0) is the number of data points with effCat=1 and effCat=0 as function of the frames variable.

The efficiency category 'effCat' must have exactly 2 +1 and 0.

The plot range and the number of plot bins is determined by the parameters of the plot variable of the frame (RooAbsReal::setPlotRange(), RooAbsReal::setPlotBins())

The optional cut string expression can be used to select the events to be plotted. The cut specification may refer to any variable contained in the data set

The drawOptions are passed to the TH1::Draw() method

Definition at line 2197 of file RooAbsData.cxx.

◆ plotOn() [1/3]

RooAbsData::plotOn ( RooPlot frame,
const RooCmdArg arg1 = RooCmdArg::none(),
const RooCmdArg arg2 = RooCmdArg::none(),
const RooCmdArg arg3 = RooCmdArg::none(),
const RooCmdArg arg4 = RooCmdArg::none(),
const RooCmdArg arg5 = RooCmdArg::none(),
const RooCmdArg arg6 = RooCmdArg::none(),
const RooCmdArg arg7 = RooCmdArg::none(),
const RooCmdArg arg8 = RooCmdArg::none() 
) const
virtual
See also
RooPlot* plotOn(RooPlot* frame, const RooLinkedList& cmdList) const

PyROOT

The RooAbsData::plotOn() function is pythonized with the command argument pythonization. The keywords must correspond to the CmdArgs of the function.

Reimplemented in RooDataHist.

Definition at line 607 of file RooAbsData.cxx.

◆ plotOn() [2/3]

RooPlot * RooAbsData::plotOn ( RooPlot frame,
const RooLinkedList argList 
) const
virtual

Plot dataset on specified frame.

By default:

  • An unbinned dataset will use the default binning of the target frame.
  • A binned dataset will retain its intrinsic binning.

The following optional named arguments can be used to modify the behaviour:

Note
Please follow the function links in the left column to learn about PyROOT specifics for a given option.
Data representation options
RooFit::Asymmetry(const RooCategory& c) Show the asymmetry of the data in given two-state category [F(+)-F(-)] / [F(+)+F(-)]. Category must have two states with indices -1 and +1 or three states with indices -1,0 and +1.
RooFit::Efficiency(const RooCategory& c) Show the efficiency F(acc)/[F(acc)+F(rej)]. Category must have two states with indices 0 and 1
RooFit::DataError(Int_t) Select the type of error drawn:
  • Auto(default) results in Poisson for unweighted data and SumW2 for weighted data
  • Poisson draws asymmetric Poisson confidence intervals.
  • SumW2 draws symmetric sum-of-weights error ( \( \left( \sum w \right)^2 / \sum\left(w^2\right) \) )
  • None draws no error bars
RooFit::Binning(int nbins, double xlo, double xhi) Use specified binning to draw dataset
RooFit::Binning(const RooAbsBinning&) Use specified binning to draw dataset
RooFit::Binning(const char* name) Use binning with specified name to draw dataset
RooFit::RefreshNorm() Force refreshing for PDF normalization information in frame. If set, any subsequent PDF will normalize to this dataset, even if it is not the first one added to the frame. By default only the 1st dataset added to a frame will update the normalization information
RooFit::Rescale(double f) Rescale drawn histogram by given factor.
RooFit::Cut(const char*)

Only plot entries that pass the given cut. Apart from cutting in continuous variables Cut("x>5"), this can also be used to plot a specific category state. Use something like Cut("myCategory == myCategory::stateA"), where myCategory resolves to the state number for a given entry and myCategory::stateA resolves to the state number of the state named "stateA".

RooFit::CutRange(const char*) Only plot data from given range. Separate multiple ranges with ",".
Note
This often requires passing the normalisation when plotting the PDF because RooFit does not save how many events were being plotted (it will only work for cutting slices out of uniformly distributed variables).
data->plotOn(frame01, CutRange("SB1"));
const double nData = data->sumEntries("", "SB1");
// Make clear that the target normalisation is nData. The enumerator NumEvent
// is needed to switch between relative and absolute scaling.
model.plotOn(frame01, Normalization(nData, RooAbsReal::NumEvent),
ProjectionRange("SB1"));
RooCmdArg ProjectionRange(const char *rangeName)
RooCmdArg Normalization(double scaleFactor)
RooCmdArg CutRange(const char *rangeName)
Histogram drawing options
RooFit::DrawOption(const char* opt) Select ROOT draw option for resulting TGraph object
RooFit::LineStyle(Style_t style) Select line style by ROOT line style code, default is solid
RooFit::LineColor(Color_t color) Select line color by ROOT color code, default is black
RooFit::LineWidth(Width_t width) Select line with in pixels, default is 3
RooFit::MarkerStyle(Style_t style) Select the ROOT marker style, default is 21
RooFit::MarkerColor(Color_t color) Select the ROOT marker color, default is black
RooFit::MarkerSize(Size_t size) Select the ROOT marker size
RooFit::FillStyle(Style_t style) Select fill style, default is filled.
RooFit::FillColor(Color_t color) Select fill color by ROOT color code
RooFit::XErrorSize(double frac)

Select size of X error bar as fraction of the bin width, default is 1

Misc. other options
RooFit::Name(const char* name) Give curve specified name in frame. Useful if curve is to be referenced later
RooFit::Invisible() Add curve to frame, but do not display. Useful in combination AddTo()
RooFit::AddTo(const char* name, double wgtSel, double wgtOther)

Add constructed histogram to already existing histogram with given name and relative weight factors

Reimplemented in RooDataHist.

Definition at line 1856 of file RooAbsData.cxx.

◆ plotOn() [3/3]

RooPlot * RooAbsData::plotOn ( RooPlot frame,
PlotOpt  o 
) const
protectedvirtual

Create and fill a histogram of the frame's variable and append it to the frame.

The frame variable must be one of the data sets dimensions.

The plot range and the number of plot bins is determined by the parameters of the plot variable of the frame (RooAbsReal::setPlotRange(), RooAbsReal::setPlotBins()).

The optional cut string expression can be used to select the events to be plotted. The cut specification may refer to any variable contained in the data set.

The drawOptions are passed to the TH1::Draw() method.

See also
RooAbsData::plotOn(RooPlot*,const RooLinkedList&) const

Reimplemented in RooDataHist, and RooDataHist.

Definition at line 1987 of file RooAbsData.cxx.

◆ Print()

void RooAbsData::Print ( Option_t option = 0) const
inlineoverridevirtual

Print TNamed name and title.

Reimplemented from TNamed.

Definition at line 239 of file RooAbsData.h.

◆ printClassName()

void RooAbsData::printClassName ( std::ostream &  os) const
overridevirtual

Print class name of dataset.

Reimplemented from RooPrintable.

Definition at line 932 of file RooAbsData.cxx.

◆ printMultiline()

void RooAbsData::printMultiline ( std::ostream &  os,
Int_t  contents,
bool  verbose = false,
TString  indent = "" 
) const
overridevirtual

Interface for detailed printing of object.

Reimplemented from RooPrintable.

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 939 of file RooAbsData.cxx.

◆ printName()

void RooAbsData::printName ( std::ostream &  os) const
overridevirtual

Print name of dataset.

Reimplemented from RooPrintable.

Definition at line 916 of file RooAbsData.cxx.

◆ printTitle()

void RooAbsData::printTitle ( std::ostream &  os) const
overridevirtual

Print title of dataset.

Reimplemented from RooPrintable.

Definition at line 924 of file RooAbsData.cxx.

◆ RecursiveRemove()

void RooAbsData::RecursiveRemove ( TObject obj)
overridevirtual

If one of the TObject we have a referenced to is deleted, remove the reference.

Reimplemented from TObject.

Definition at line 2597 of file RooAbsData.cxx.

◆ reduce() [1/5]

RooAbsData * RooAbsData::reduce ( const char *  cut)

Create a subset of the data set by applying the given cut on the data points.

The cut expression can refer to any variable in the data set. For cuts involving other variables, such as intermediate formula objects, use the equivalent reduce method specifying the as a RooFormulVar reference.

Definition at line 531 of file RooAbsData.cxx.

◆ reduce() [2/5]

RooAbsData * RooAbsData::reduce ( const RooArgSet varSubset,
const char *  cut = 0 
)

Create a subset of the data set by applying the given cut on the data points and reducing the dimensions to the specified set.

The cut expression can refer to any variable in the data set. For cuts involving other variables, such as intermediate formula objects, use the equivalent reduce method specifying the as a RooFormulVar reference.

Definition at line 559 of file RooAbsData.cxx.

◆ reduce() [3/5]

RooAbsData * RooAbsData::reduce ( const RooArgSet varSubset,
const RooFormulaVar cutVar 
)

Create a subset of the data set by applying the given cut on the data points and reducing the dimensions to the specified set.

The 'cutVar' formula variable is used to select the subset of data points to be retained in the reduced data collection.

Definition at line 589 of file RooAbsData.cxx.

◆ reduce() [4/5]

RooAbsData::reduce ( const RooCmdArg arg1,
const RooCmdArg arg2 = RooCmdArg(),
const RooCmdArg arg3 = RooCmdArg(),
const RooCmdArg arg4 = RooCmdArg(),
const RooCmdArg arg5 = RooCmdArg(),
const RooCmdArg arg6 = RooCmdArg(),
const RooCmdArg arg7 = RooCmdArg(),
const RooCmdArg arg8 = RooCmdArg() 
)

Create a reduced copy of this dataset.

The caller takes ownership of the returned dataset

The following optional named arguments are accepted

SelectVars(const RooArgSet& vars) Only retain the listed observables in the output dataset
Cut(const char* expression) Only retain event surviving the given cut expression
Cut(const RooFormulaVar& expr) Only retain event surviving the given cut formula
CutRange(const char* name) Only retain events inside range with given name. Multiple CutRange arguments may be given to select multiple ranges
EventRange(int lo, int hi) Only retain events with given sequential event numbers
Name(const char* name) Give specified name to output dataset
Title(const char* name) Give specified title to output dataset

PyROOT

The RooAbsData::reduce() function is pythonized with the command argument pythonization. The keywords must correspond to the CmdArgs of the function.

Definition at line 454 of file RooAbsData.cxx.

◆ reduce() [5/5]

RooAbsData * RooAbsData::reduce ( const RooFormulaVar cutVar)

Create a subset of the data set by applying the given cut on the data points.

The 'cutVar' formula variable is used to select the subset of data points to be retained in the reduced data collection.

Definition at line 544 of file RooAbsData.cxx.

◆ reduceEng()

virtual RooAbsData * RooAbsData::reduceEng ( const RooArgSet varSubset,
const RooFormulaVar cutVar,
const char *  cutRange = 0,
std::size_t  nStart = 0,
std::size_t  = std::numeric_limits< std::size_t >::max() 
)
protectedpure virtual

Implemented in RooDataHist, and RooDataSet.

◆ releaseVars()

bool RooAbsData::releaseVars ( RooAbsData data)
static

If return value is true variables can be deleted.

Definition at line 160 of file RooAbsData.cxx.

◆ reset()

void RooAbsData::reset ( )
virtual

Reimplemented in RooDataHist.

Definition at line 386 of file RooAbsData.cxx.

◆ resetBuffers()

void RooAbsData::resetBuffers ( )

Definition at line 2481 of file RooAbsData.cxx.

◆ resetCache()

void RooAbsData::resetCache ( )
protectedvirtual

Internal method – Remove cached function values.

Definition at line 410 of file RooAbsData.cxx.

◆ rmsVar()

RooRealVar * RooAbsData::rmsVar ( const RooRealVar var,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const

Create a RooRealVar containing the RMS of observable 'var' in this dataset.

If cutSpec and/or cutRange are specified the moment is calculated on the subset of the data which pass the C++ cut specification expression 'cutSpec' and/or are inside the range named 'cutRange'

Definition at line 1225 of file RooAbsData.cxx.

◆ setArgStatus()

void RooAbsData::setArgStatus ( const RooArgSet set,
bool  active 
)
protectedvirtual

Definition at line 426 of file RooAbsData.cxx.

◆ setDefaultStorageType()

void RooAbsData::setDefaultStorageType ( RooAbsData::StorageType  s)
static

Definition at line 133 of file RooAbsData.cxx.

◆ setDirtyProp()

void RooAbsData::setDirtyProp ( bool  flag)

Control propagation of dirty flags from observables in dataset.

Definition at line 434 of file RooAbsData.cxx.

◆ setGlobalObservables()

void RooAbsData::setGlobalObservables ( RooArgSet const &  globalObservables)

Sets the global observables stored in this data.

A snapshot of the observables will be saved.

Parameters
[in]globalObservablesThe set of global observables to take a snapshot of.

Definition at line 2612 of file RooAbsData.cxx.

◆ SetName()

void RooAbsData::SetName ( const char *  name)
overridevirtual

Set the name of the TNamed.

WARNING: if the object is a member of a THashTable or THashList container the container must be Rehash()'ed after SetName(). For example the list of objects in the current directory is a THashList.

Reimplemented from TNamed.

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 2627 of file RooAbsData.cxx.

◆ SetNameTitle()

void RooAbsData::SetNameTitle ( const char *  name,
const char *  title 
)
overridevirtual

Set all the TNamed parameters (name and title).

WARNING: if the name is changed and the object is a member of a THashTable or THashList container the container must be Rehash()'ed after SetName(). For example the list of objects in the current directory is a THashList.

Reimplemented from TNamed.

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 2644 of file RooAbsData.cxx.

◆ sigma()

double RooAbsData::sigma ( const RooRealVar var,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const
inline

Definition at line 258 of file RooAbsData.h.

◆ skewness()

double RooAbsData::skewness ( const RooRealVar var,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const
inline

Definition at line 259 of file RooAbsData.h.

◆ split() [1/2]

TList * RooAbsData::split ( const RooAbsCategory splitCat,
bool  createEmptyDataSets = false 
) const
virtual

Split dataset into subsets based on states of given splitCat in this dataset.

A TList of RooDataSets is returned in which each RooDataSet is named after the state name of splitCat of which it contains the dataset subset. The observables splitCat itself is no longer present in the sub datasets. If createEmptyDataSets is false (default) this method only creates datasets for states which have at least one entry The caller takes ownership of the returned list and its contents

Definition at line 1573 of file RooAbsData.cxx.

◆ split() [2/2]

TList * RooAbsData::split ( const RooSimultaneous simpdf,
bool  createEmptyDataSets = false 
) const
virtual

Split dataset into subsets based on the categorisation of the RooSimultaneous A TList of RooDataSets is returned in which each RooDataSet is named after the state name of splitCat of which it contains the dataset subset.

The observables splitCat itself is no longer present in the sub datasets, as well as the observables of the other categories. If createEmptyDataSets is false (default) this method only creates datasets for states which have at least one entry The caller takes ownership of the returned list and its contents

Definition at line 1661 of file RooAbsData.cxx.

◆ standMoment()

double RooAbsData::standMoment ( const RooRealVar var,
double  order,
const char *  cutSpec = 0,
const char *  cutRange = 0 
) const

Calculate standardized moment.

Parameters
[in]varVariable to be used for calculating the moment.
[in]orderOrder of the moment.
[in]cutSpecIf specified, the moment is calculated on the subset of the data which pass the C++ cut specification expression 'cutSpec'
[in]cutRangeIf specified, calculate inside the range named 'cutRange' (also applies cut spec)
Returns
\( \frac{\left< \left( X - \left< X \right> \right)^n \right>}{\sigma^n} \), where n = order.

Definition at line 961 of file RooAbsData.cxx.

◆ statOn() [1/2]

RooPlot * RooAbsData::statOn ( RooPlot frame,
const char *  what,
const char *  label = "",
Int_t  sigDigits = 2,
Option_t options = "NELU",
double  xmin = 0.15,
double  xmax = 0.65,
double  ymax = 0.85,
const char *  cutSpec = 0,
const char *  cutRange = 0,
const RooCmdArg formatCmd = 0 
)
virtual

Implementation back-end of statOn() method with named arguments.

Definition at line 1335 of file RooAbsData.cxx.

◆ statOn() [2/2]

RooAbsData::statOn ( RooPlot frame,
const RooCmdArg arg1 = RooCmdArg::none(),
const RooCmdArg arg2 = RooCmdArg::none(),
const RooCmdArg arg3 = RooCmdArg::none(),
const RooCmdArg arg4 = RooCmdArg::none(),
const RooCmdArg arg5 = RooCmdArg::none(),
const RooCmdArg arg6 = RooCmdArg::none(),
const RooCmdArg arg7 = RooCmdArg::none(),
const RooCmdArg arg8 = RooCmdArg::none() 
)
virtual

Add a box with statistics information to the specified frame.

By default a box with the event count, mean and rms of the plotted variable is added.

The following optional named arguments are accepted

What(const char* whatstr) Controls what is printed: "N" = count, "M" is mean, "R" is RMS.
Format(const char* optStr)
Deprecated:
Classing parameter formatting options, provided for backward compatibility

Format(const char* what,...) Parameter formatting options.
const char* what Controls what is shown:
  • "N" adds name
  • "E" adds error
  • "A" shows asymmetric error
  • "U" shows unit
  • "H" hides the value
FixedPrecision(int n) Controls precision, set fixed number of digits
AutoPrecision(int n) Controls precision. Number of shown digits is calculated from error + n specified additional digits (1 is sensible default)
VerbatimName(bool flag) Put variable name in a \verb+ + clause.
Label(const chat* label) Add header label to parameter box
Layout(double xmin, double xmax, double ymax) Specify relative position of left,right side of box and top of box. Position of bottom of box is calculated automatically from number lines in box
Cut(const char* expression) Apply given cut expression to data when calculating statistics
CutRange(const char* rangeName)

Only consider events within given range when calculating statistics. Multiple CutRange() argument may be specified to combine ranges.

PyROOT

The RooAbsData::statOn() function is pythonized with the command argument pythonization. The keywords must correspond to the CmdArgs of the function.

Definition at line 1282 of file RooAbsData.cxx.

◆ store() [1/2]

RooAbsDataStore * RooAbsData::store ( )
inline

Definition at line 82 of file RooAbsData.h.

◆ store() [2/2]

const RooAbsDataStore * RooAbsData::store ( ) const
inline

Definition at line 83 of file RooAbsData.h.

◆ Streamer()

void RooAbsData::Streamer ( TBuffer R__b)
overridevirtual

Stream an object of class RooAbsData.

Reimplemented from TNamed.

Reimplemented in RooDataHist, RooDataSet, and RooTreeData.

Definition at line 2511 of file RooAbsData.cxx.

◆ StreamerNVirtual()

void RooAbsData::StreamerNVirtual ( TBuffer ClassDef_StreamerNVirtual_b)
inline

Definition at line 381 of file RooAbsData.h.

◆ sumEntries() [1/2]

virtual double RooAbsData::sumEntries ( ) const
pure virtual

Return effective number of entries in dataset, i.e., sum all weights.

Implemented in RooDataHist, and RooDataSet.

◆ sumEntries() [2/2]

virtual double RooAbsData::sumEntries ( const char *  cutSpec,
const char *  cutRange = 0 
) const
pure virtual

Return effective number of entries in dataset inside range or after cuts, i.e., sum certain weights.

Parameters
[in]cutSpecApply given cut when counting (e.g. 0 < x && x < 5). Passing "1" selects all events.
[in]cutRangeIf the observables have a range with this name, only count events inside this range.

Implemented in RooDataHist, and RooDataSet.

◆ sumEntriesW2()

double RooAbsData::sumEntriesW2 ( ) const

Return sum of squared weights of this data.

Definition at line 2655 of file RooAbsData.cxx.

◆ table() [1/2]

Roo1DTable * RooAbsData::table ( const RooAbsCategory cat,
const char *  cuts = "",
const char *  opts = "" 
) const
virtual

Create and fill a 1-dimensional table for given category column This functions is the equivalent of plotOn() for category dimensions.

The optional cut string expression can be used to select the events to be tabulated The cut specification may refer to any variable contained in the data set

The option string is currently not used

Definition at line 2282 of file RooAbsData.cxx.

◆ table() [2/2]

Roo1DTable * RooAbsData::table ( const RooArgSet catSet,
const char *  cuts = "",
const char *  opts = "" 
) const
virtual

Construct table for product of categories in catSet.

Definition at line 889 of file RooAbsData.cxx.

◆ tree()

const TTree * RooAbsData::tree ( ) const

Return a pointer to the TTree which stores the data.

Returns a nullpointer if vector-based storage is used. The RooAbsData remains owner of the tree. GetClonedTree() can be used to get a tree even if the internal storage does not use one.

Definition at line 2554 of file RooAbsData.cxx.

◆ uniqueId()

RooFit::UniqueId< RooAbsData > const & RooAbsData::uniqueId ( ) const
inline

Returns a unique ID that is different for every instantiated RooAbsData object.

This ID can be used whether two RooAbsData are the same object, which is safer than memory address comparisons that might result in false positives when memory is reused.

Definition at line 324 of file RooAbsData.h.

◆ weight()

virtual double RooAbsData::weight ( ) const
pure virtual

Implemented in RooDataHist, and RooDataSet.

◆ weightError() [1/2]

virtual void RooAbsData::weightError ( double lo,
double hi,
ErrorType  = Poisson 
) const
inlinevirtual

Return the asymmetric errors on the current weight.

See also weightError(ErrorType) const for symmetric error.

Parameters
[out]loLow error.
[out]hiHigh error.

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 127 of file RooAbsData.h.

◆ weightError() [2/2]

virtual double RooAbsData::weightError ( ErrorType  = Poisson) const
inlinevirtual

Return the symmetric error on the current weight.

See also weightError(double&,double&,ErrorType) const for asymmetric errors.

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 117 of file RooAbsData.h.

◆ weightSquared()

virtual double RooAbsData::weightSquared ( ) const
pure virtual

Implemented in RooDataHist, and RooDataSet.

Friends And Related Function Documentation

◆ RooAbsArg

friend class RooAbsArg
friend

Definition at line 346 of file RooAbsData.h.

◆ RooAbsCachedPdf

friend class RooAbsCachedPdf
friend

Definition at line 349 of file RooAbsData.h.

◆ RooAbsOptTestStatistic

friend class RooAbsOptTestStatistic
friend

Definition at line 348 of file RooAbsData.h.

◆ RooAbsReal

friend class RooAbsReal
friend

Definition at line 347 of file RooAbsData.h.

◆ RooFit::TestStatistics::ConstantTermsOptimizer

Definition at line 350 of file RooAbsData.h.

◆ RooFit::TestStatistics::RooAbsL

friend class RooFit::TestStatistics::RooAbsL
friend

Definition at line 352 of file RooAbsData.h.

Member Data Documentation

◆ _cachedVars

RooArgSet RooAbsData::_cachedVars
protected

! External variables cached with this data set

Definition at line 366 of file RooAbsData.h.

◆ _dstore

RooAbsDataStore* RooAbsData::_dstore = nullptr
protected

Data storage implementation.

Definition at line 368 of file RooAbsData.h.

◆ _globalObservables

std::unique_ptr<RooArgSet> RooAbsData::_globalObservables
protected

Snapshot of global observables.

Definition at line 372 of file RooAbsData.h.

◆ _namePtr

const TNamed* RooAbsData::_namePtr = nullptr
mutableprotected

! De-duplicated name pointer. This will be equal for all objects with the same name.

Definition at line 374 of file RooAbsData.h.

◆ _ownedComponents

std::map<std::string,RooAbsData*> RooAbsData::_ownedComponents
protected

Owned external components.

Definition at line 370 of file RooAbsData.h.

◆ _uniqueId

const RooFit::UniqueId<RooAbsData> RooAbsData::_uniqueId
private

!

Definition at line 379 of file RooAbsData.h.

◆ _vars

RooArgSet RooAbsData::_vars
protected

Dimensions of this data set.

Definition at line 365 of file RooAbsData.h.

◆ arguments

TH1 Use the overload of RooAbsData::createHistogram that takes RooFit command RooAbsData::arguments

Definition at line 229 of file RooAbsData.h.

◆ defaultStorageType

RooAbsData::StorageType RooAbsData::defaultStorageType =RooAbsData::Vector
staticprotected

Definition at line 328 of file RooAbsData.h.

◆ storageType

StorageType RooAbsData::storageType
protected

Definition at line 330 of file RooAbsData.h.

Libraries for RooAbsData:
[legend]

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