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).

Definition at line 47 of file RooAbsData.h.

Classes

struct  PlotOpt
 

Public Types

enum  ErrorType {
  Poisson, SumW2, None, Auto,
  Expected
}
 
enum  StorageType { Tree, Vector, Composite }
 
- Public Types inherited from TObject
enum  {
  kIsOnHeap = 0x01000000, kNotDeleted = 0x02000000, kZombie = 0x04000000, kInconsistent = 0x08000000,
  kBitMask = 0x00ffffff
}
 
enum  { kSingleKey = BIT(0), kOverwrite = BIT(1), kWriteDelete = BIT(2) }
 
enum  EDeprecatedStatusBits { kObjInCanvas = BIT(3) }
 
enum  EStatusBits {
  kCanDelete = BIT(0), kMustCleanup = BIT(3), kIsReferenced = BIT(4), kHasUUID = BIT(5),
  kCannotPick = BIT(6), kNoContextMenu = BIT(8), kInvalidObject = BIT(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 char *name, const char *title, const RooArgSet &vars, RooAbsDataStore *store=0)
 Constructor from a set of variables. More...
 
 RooAbsData (const RooAbsData &other, const char *newname=0)
 Copy constructor. More...
 
virtual ~RooAbsData ()
 Destructor. More...
 
virtual void add (const RooArgSet &row, Double_t weight=1, Double_t weightError=0)=0
 
void addOwnedComponent (const char *idxlabel, RooAbsData &data)
 
void attachBuffers (const RooArgSet &extObs)
 
Bool_t canSplitFast () const
 
virtual Bool_t 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_t 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_t 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, 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. More...
 
virtual Int_t defaultPrintContents (Option_t *opt) const
 Define default print options, for a given print style. More...
 
virtual void Draw (Option_t *option="")
 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
 
virtual void getBatches (BatchHelpers::RunContext &evalData, std::size_t first=0, std::size_t len=std::numeric_limits< std::size_t >::max()) const =0
 Retrieve batches of data for each real-valued variable in this dataset. More...
 
TTreeGetClonedTree () const
 Return a clone of the TTree which stores the data or create such a tree if vector storage is used. More...
 
Bool_t getRange (const RooAbsRealLValue &var, Double_t &lowest, Double_t &highest, Double_t marginFrac=0, Bool_t symMode=kFALSE) 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) const =0
 Return event weights of all events in range [first, first+len). More...
 
Bool_t hasFilledCache () const
 
virtual Bool_t isNonPoissonWeighted () const
 
virtual Bool_t isWeighted () const
 
Double_t kurtosis (const RooRealVar &var, const char *cutSpec=0, const char *cutRange=0) const
 
Double_t 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_t moment (const RooRealVar &var, Double_t order, const char *cutSpec=0, const char *cutRange=0) const
 Calculate moment of requested order. More...
 
Double_t moment (const RooRealVar &var, Double_t order, Double_t offset, const char *cutSpec=0, const char *cutRange=0) const
 Return the 'order'-ed moment of observable 'var' in this dataset. 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...
 
virtual void Print (Option_t *options=0) const
 Print TNamed name and title. More...
 
virtual void printClassName (std::ostream &os) const
 Print class name of dataset. More...
 
void printMultiline (std::ostream &os, Int_t contents, Bool_t verbose=kFALSE, TString indent="") const
 Interface for detailed printing of object. More...
 
virtual void printName (std::ostream &os) const
 Print name of dataset. More...
 
virtual void printTitle (std::ostream &os) const
 Print title of dataset. More...
 
virtual void RecursiveRemove (TObject *obj)
 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_t flag)
 Control propagation of dirty flags from observables in dataset. More...
 
Double_t sigma (const RooRealVar &var, const char *cutSpec=0, const char *cutRange=0) const
 
Double_t skewness (const RooRealVar &var, const char *cutSpec=0, const char *cutRange=0) const
 
virtual TListsplit (const RooAbsCategory &splitCat, Bool_t createEmptyDataSets=kFALSE) const
 Split dataset into subsets based on states of given splitCat in this dataset. More...
 
Double_t standMoment (const RooRealVar &var, Double_t 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_t xmin=0.15, Double_t xmax=0.65, Double_t 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
 
virtual Double_t sumEntries () const =0
 Return effective number of entries in dataset, i.e., sum all weights. More...
 
virtual Double_t sumEntries (const char *cutSpec, const char *cutRange=0) const =0
 Return effective number of entries in dataset inside range or after cuts, i.e. 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...
 
virtual Bool_t valid () const
 
virtual Double_t weight () const =0
 
virtual void weightError (Double_t &lo, Double_t &hi, ErrorType etype=Poisson) const
 Return asymmetric error on weight. (Dummy implementation returning zero) More...
 
virtual Double_t weightError (ErrorType etype=Poisson) const
 Return error on current weight (dummy implementation returning zero) More...
 
virtual Double_t 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...
 
virtual void Clear (Option_t *option="")
 Set name and title to empty strings (""). More...
 
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 two TNamed objects. More...
 
virtual void Copy (TObject &named) const
 Copy this to obj. More...
 
virtual void FillBuffer (char *&buffer)
 Encode TNamed into output buffer. More...
 
virtual const char * GetName () const
 Returns name of object. More...
 
virtual const char * GetTitle () const
 Returns title of object. More...
 
virtual ULong_t Hash () const
 Return hash value for this object. More...
 
virtual Bool_t IsSortable () const
 
virtual void ls (Option_t *option="") const
 List TNamed name and title. More...
 
TNamedoperator= (const TNamed &rhs)
 TNamed assignment operator. 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...
 
- 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 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 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 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 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...
 
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 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
 
R__ALWAYS_INLINE Bool_t IsZombie () const
 
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...
 
voidoperator new (size_t sz)
 
voidoperator new (size_t sz, void *vp)
 
voidoperator new[] (size_t sz)
 
voidoperator 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 Int_t Read (const char *name)
 Read contents of object with specified name from the current directory. 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 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 StyleOption defaultPrintStyle (Option_t *opt) 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 printExtras (std::ostream &os) const
 Interface to print extras 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 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...
 

Static Public Member Functions

static void claimVars (RooAbsData *)
 
static StorageType getDefaultStorageType ()
 
static Bool_t releaseVars (RooAbsData *)
 If return value is true variables can be deleted. More...
 
static void setDefaultStorageType (StorageType s)
 
- Static Public Member Functions inherited from TObject
static Long_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 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...
 

Protected Member Functions

Bool_t 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_t skipZeroWeights=kFALSE)
 Internal method – Cache given set of functions with data. More...
 
virtual RooAbsDatacacheClone (const RooAbsArg *newCacheOwner, const RooArgSet *newCacheVars, const char *newName=0)=0
 
Double_t corrcov (const RooRealVar &x, const RooRealVar &y, const char *cutSpec, const char *cutRange, Bool_t corr) const
 Internal method to calculate single correlation and covariance elements. More...
 
TMatrixDSymcorrcovMatrix (const RooArgList &vars, const char *cutSpec, const char *cutRange, Bool_t 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(), Bool_t copyCache=kTRUE)=0
 
virtual void resetCache ()
 Internal method – Remove cached function values. More...
 
virtual void setArgStatus (const RooArgSet &set, Bool_t 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
 
RooAbsDataStore_dstore
 External variables cached with this data set. More...
 
std::map< std::string, RooAbsData * > _ownedComponents
 
RooArgSet _vars
 
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
 

Friends

class RooAbsArg
 
class RooAbsCachedPdf
 
class RooAbsOptTestStatistic
 
class RooAbsReal
 

#include <RooAbsData.h>

Inheritance diagram for RooAbsData:
[legend]

Member Enumeration Documentation

◆ ErrorType

Enumerator
Poisson 
SumW2 
None 
Auto 
Expected 

Definition at line 97 of file RooAbsData.h.

◆ StorageType

Enumerator
Tree 
Vector 
Composite 

Definition at line 246 of file RooAbsData.h.

Constructor & Destructor Documentation

◆ RooAbsData() [1/3]

RooAbsData::RooAbsData ( )

Default constructor.

Definition at line 118 of file RooAbsData.cxx.

◆ RooAbsData() [2/3]

RooAbsData::RooAbsData ( const char *  name,
const char *  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 131 of file RooAbsData.cxx.

◆ RooAbsData() [3/3]

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

Copy constructor.

Definition at line 171 of file RooAbsData.cxx.

◆ ~RooAbsData()

RooAbsData::~RooAbsData ( )
virtual

Destructor.

Definition at line 253 of file RooAbsData.cxx.

Member Function Documentation

◆ add()

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

Implemented in RooDataSet, and RooDataHist.

◆ addOwnedComponent()

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

Definition at line 2306 of file RooAbsData.cxx.

◆ allClientsCached()

Bool_t 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 2256 of file RooAbsData.cxx.

◆ attachBuffers()

void RooAbsData::attachBuffers ( const RooArgSet extObs)

Definition at line 2273 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 347 of file RooAbsData.cxx.

◆ cacheArgs()

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

Internal method – Cache given set of functions with data.

Definition at line 330 of file RooAbsData.cxx.

◆ cacheClone()

virtual RooAbsData* RooAbsData::cacheClone ( const RooAbsArg newCacheOwner,
const RooArgSet newCacheVars,
const char *  newName = 0 
)
protectedpure virtual

Implemented in RooDataSet, and RooDataHist.

◆ canSplitFast()

Bool_t RooAbsData::canSplitFast ( ) const

Definition at line 2287 of file RooAbsData.cxx.

◆ changeObservableName()

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

Definition at line 287 of file RooAbsData.cxx.

◆ checkInit()

void RooAbsData::checkInit ( ) const

Definition at line 2331 of file RooAbsData.cxx.

◆ claimVars()

void RooAbsData::claimVars ( RooAbsData data)
static

Definition at line 96 of file RooAbsData.cxx.

◆ convertToTreeStore()

void RooAbsData::convertToTreeStore ( )
virtual

Convert vector-based storage to tree-based storage.

Reimplemented in RooDataSet.

Definition at line 2385 of file RooAbsData.cxx.

◆ convertToVectorStore()

void RooAbsData::convertToVectorStore ( )

Convert tree-based storage to vector-based storage.

Definition at line 275 of file RooAbsData.cxx.

◆ corrcov()

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

Internal method to calculate single correlation and covariance elements.

Definition at line 920 of file RooAbsData.cxx.

◆ corrcovMatrix()

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

Return covariance matrix from data for given list of observables.

Definition at line 976 of file RooAbsData.cxx.

◆ correlation()

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

Definition at line 215 of file RooAbsData.h.

◆ correlationMatrix() [1/2]

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

Definition at line 218 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 220 of file RooAbsData.h.

◆ covariance()

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

Definition at line 214 of file RooAbsData.h.

◆ covarianceMatrix() [1/2]

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

Definition at line 217 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 219 of file RooAbsData.h.

◆ createHistogram() [1/3]

TH1 * 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

◆ createHistogram() [2/3]

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
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")))

The caller takes ownership of the returned histogram

Definition at line 669 of file RooAbsData.cxx.

◆ createHistogram() [3/3]

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

Definition at line 567 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 901 of file RooAbsData.cxx.

◆ defaultPrintContents()

Int_t RooAbsData::defaultPrintContents ( Option_t opt) const
virtual

Define default print options, for a given print style.

Reimplemented from RooPrintable.

Definition at line 810 of file RooAbsData.cxx.

◆ Draw()

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

Forward draw command to data store.

Reimplemented from TObject.

Definition at line 2339 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 RooDataSet, and RooDataHist.

◆ fill()

void RooAbsData::fill ( )
virtual

Definition at line 300 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 1289 of file RooAbsData.cxx.

◆ get() [1/2]

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

Reimplemented in RooDataSet, and RooDataHist.

Definition at line 90 of file RooAbsData.h.

◆ get() [2/2]

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

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 321 of file RooAbsData.cxx.

◆ getBatches()

virtual void RooAbsData::getBatches ( BatchHelpers::RunContext evalData,
std::size_t  first = 0,
std::size_t  len = std::numeric_limits< std::size_t >::max() 
) const
pure virtual

Retrieve batches of data for each real-valued variable in this dataset.

Parameters
[out]evalDataStore references to all data batches in this struct.
firstIndex of first event that ends up in the batch.
lenNumber of events in each batch. Needs to be overridden by derived classes. This implementation returns an empty RunContext.

Implemented in RooDataSet, and RooDataHist.

◆ 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 2371 of file RooAbsData.cxx.

◆ getDefaultStorageType()

RooAbsData::StorageType RooAbsData::getDefaultStorageType ( )
static

Definition at line 89 of file RooAbsData.cxx.

◆ getRange()

Bool_t RooAbsData::getRange ( const RooAbsRealLValue var,
Double_t lowest,
Double_t highest,
Double_t  marginFrac = 0,
Bool_t  symMode = kFALSE 
) const

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

If the return value is kTRUE and error occurred

Definition at line 2124 of file RooAbsData.cxx.

◆ getSimData()

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

Definition at line 2297 of file RooAbsData.cxx.

◆ getWeightBatch()

virtual RooSpan<const double> RooAbsData::getWeightBatch ( std::size_t  first,
std::size_t  len 
) 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_t RooAbsData::hasFilledCache ( ) const

Definition at line 2346 of file RooAbsData.cxx.

◆ isNonPoissonWeighted()

virtual Bool_t RooAbsData::isNonPoissonWeighted ( ) const
inlinevirtual

Reimplemented in RooDataSet, and RooDataHist.

Definition at line 128 of file RooAbsData.h.

◆ isWeighted()

virtual Bool_t RooAbsData::isWeighted ( ) const
inlinevirtual

Reimplemented in RooDataSet, and RooDataHist.

Definition at line 124 of file RooAbsData.h.

◆ kurtosis()

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

Definition at line 212 of file RooAbsData.h.

◆ mean()

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

Definition at line 209 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 1072 of file RooAbsData.cxx.

◆ moment() [1/2]

Double_t RooAbsData::moment ( const RooRealVar var,
Double_t  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 843 of file RooAbsData.cxx.

◆ moment() [2/2]

Double_t RooAbsData::moment ( const RooRealVar var,
Double_t  order,
Double_t  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 856 of file RooAbsData.cxx.

◆ numEntries()

Int_t RooAbsData::numEntries ( ) const
virtual

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

Reimplemented in RooDataHist.

Definition at line 307 of file RooAbsData.cxx.

◆ operator=()

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

Definition at line 211 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 2189 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 1880 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 1974 of file RooAbsData.cxx.

◆ plotOn() [1/3]

RooPlot * 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

◆ 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:

Data representation options
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.
Efficiency(const RooCategory& c) Show the efficiency F(acc)/[F(acc)+F(rej)]. Category must have two states with indices 0 and 1
DataError(RooAbsData::EType) 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
Binning(int nbins, double xlo, double xhi) Use specified binning to draw dataset
Binning(const RooAbsBinning&) Use specified binning to draw dataset
Binning(const char* name) Use binning with specified name to draw dataset
RefreshNorm(Bool_t flag) 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
Rescale(Double_t f) Rescale drawn histogram by given factor.
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".

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"));
Histogram drawing options
DrawOption(const char* opt) Select ROOT draw option for resulting TGraph object
LineStyle(Int_t style) Select line style by ROOT line style code, default is solid
LineColor(Int_t color) Select line color by ROOT color code, default is black
LineWidth(Int_t width) Select line with in pixels, default is 3
MarkerStyle(Int_t style) Select the ROOT marker style, default is 21
MarkerColor(Int_t color) Select the ROOT marker color, default is black
MarkerSize(Double_t size) Select the ROOT marker size
FillStyle(Int_t style) Select fill style, default is filled.
FillColor(Int_t color) Select fill color by ROOT color code
XErrorSize(Double_t frac)

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

Misc. other options
Name(const chat* name) Give curve specified name in frame. Useful if curve is to be referenced later
Invisible() Add curve to frame, but do not display. Useful in combination AddTo()
AddTo(const char* name, double_t wgtSelf, double_t wgtOther) Add constructed histogram to already existing histogram with given name and relative weight factors

Definition at line 1624 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.

Definition at line 1755 of file RooAbsData.cxx.

◆ Print()

virtual void RooAbsData::Print ( Option_t option = 0) const
inlinevirtual

Print TNamed name and title.

Reimplemented from TNamed.

Definition at line 191 of file RooAbsData.h.

◆ printClassName()

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

Print class name of dataset.

Reimplemented from RooPrintable.

Definition at line 795 of file RooAbsData.cxx.

◆ printMultiline()

void RooAbsData::printMultiline ( std::ostream &  os,
Int_t  contents,
Bool_t  verbose = kFALSE,
TString  indent = "" 
) const
virtual

Interface for detailed printing of object.

Reimplemented from RooPrintable.

Reimplemented in RooDataSet, and RooDataHist.

Definition at line 802 of file RooAbsData.cxx.

◆ printName()

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

Print name of dataset.

Reimplemented from RooPrintable.

Definition at line 779 of file RooAbsData.cxx.

◆ printTitle()

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

Print title of dataset.

Reimplemented from RooPrintable.

Definition at line 787 of file RooAbsData.cxx.

◆ RecursiveRemove()

void RooAbsData::RecursiveRemove ( TObject obj)
virtual

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

Reimplemented from TObject.

Definition at line 2399 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 462 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 486 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 512 of file RooAbsData.cxx.

◆ reduce() [4/5]

RooAbsData * 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

Definition at line 382 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 473 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(),
Bool_t  copyCache = kTRUE 
)
protectedpure virtual

Implemented in RooDataSet, and RooDataHist.

◆ releaseVars()

Bool_t RooAbsData::releaseVars ( RooAbsData data)
static

If return value is true variables can be deleted.

Definition at line 105 of file RooAbsData.cxx.

◆ reset()

void RooAbsData::reset ( )
virtual

Reimplemented in RooDataHist.

Definition at line 314 of file RooAbsData.cxx.

◆ resetBuffers()

void RooAbsData::resetBuffers ( )

Definition at line 2280 of file RooAbsData.cxx.

◆ resetCache()

void RooAbsData::resetCache ( )
protectedvirtual

Internal method – Remove cached function values.

Definition at line 338 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 1108 of file RooAbsData.cxx.

◆ setArgStatus()

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

Definition at line 354 of file RooAbsData.cxx.

◆ setDefaultStorageType()

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

Definition at line 78 of file RooAbsData.cxx.

◆ setDirtyProp()

void RooAbsData::setDirtyProp ( Bool_t  flag)

Control propagation of dirty flags from observables in dataset.

Definition at line 362 of file RooAbsData.cxx.

◆ sigma()

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

Definition at line 210 of file RooAbsData.h.

◆ skewness()

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

Definition at line 211 of file RooAbsData.h.

◆ split()

TList * RooAbsData::split ( const RooAbsCategory splitCat,
Bool_t  createEmptyDataSets = kFALSE 
) 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 kFALSE (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 1479 of file RooAbsData.cxx.

◆ standMoment()

Double_t RooAbsData::standMoment ( const RooRealVar var,
Double_t  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 824 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_t  xmin = 0.15,
Double_t  xmax = 0.65,
Double_t  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 1218 of file RooAbsData.cxx.

◆ statOn() [2/2]

RooPlot * 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_t flag) Put variable name in a \verb+ + clause.
Label(const chat* label) Add header label to parameter box
Layout(Double_t xmin, Double_t xmax, Double_t 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.

Definition at line 1165 of file RooAbsData.cxx.

◆ store() [1/2]

RooAbsDataStore* RooAbsData::store ( )
inline

Definition at line 66 of file RooAbsData.h.

◆ store() [2/2]

const RooAbsDataStore* RooAbsData::store ( ) const
inline

Definition at line 67 of file RooAbsData.h.

◆ sumEntries() [1/2]

virtual Double_t RooAbsData::sumEntries ( ) const
pure virtual

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

Implemented in RooDataSet, and RooDataHist.

◆ sumEntries() [2/2]

virtual Double_t 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 RooDataSet, and RooDataHist.

◆ 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 2063 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 749 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 2356 of file RooAbsData.cxx.

◆ valid()

virtual Bool_t RooAbsData::valid ( ) const
inlinevirtual

Reimplemented in RooDataHist.

Definition at line 96 of file RooAbsData.h.

◆ weight()

virtual Double_t RooAbsData::weight ( ) const
pure virtual

Implemented in RooDataSet, and RooDataHist.

◆ weightError() [1/2]

void RooAbsData::weightError ( Double_t lo,
Double_t hi,
ErrorType  etype = Poisson 
) const
virtual

Return asymmetric error on weight. (Dummy implementation returning zero)

Reimplemented in RooDataSet, and RooDataHist.

Definition at line 541 of file RooAbsData.cxx.

◆ weightError() [2/2]

Double_t RooAbsData::weightError ( ErrorType  etype = Poisson) const
virtual

Return error on current weight (dummy implementation returning zero)

Reimplemented in RooDataSet, and RooDataHist.

Definition at line 533 of file RooAbsData.cxx.

◆ weightSquared()

virtual Double_t RooAbsData::weightSquared ( ) const
pure virtual

Implemented in RooDataSet, and RooDataHist.

Friends And Related Function Documentation

◆ RooAbsArg

friend class RooAbsArg
friend

Definition at line 272 of file RooAbsData.h.

◆ RooAbsCachedPdf

friend class RooAbsCachedPdf
friend

Definition at line 275 of file RooAbsData.h.

◆ RooAbsOptTestStatistic

friend class RooAbsOptTestStatistic
friend

Definition at line 274 of file RooAbsData.h.

◆ RooAbsReal

friend class RooAbsReal
friend

Definition at line 273 of file RooAbsData.h.

Member Data Documentation

◆ _cachedVars

RooArgSet RooAbsData::_cachedVars
protected

Definition at line 290 of file RooAbsData.h.

◆ _dstore

RooAbsDataStore* RooAbsData::_dstore
protected

External variables cached with this data set.

Definition at line 292 of file RooAbsData.h.

◆ _ownedComponents

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

Definition at line 294 of file RooAbsData.h.

◆ _vars

RooArgSet RooAbsData::_vars
protected

Definition at line 289 of file RooAbsData.h.

◆ defaultStorageType

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

Definition at line 254 of file RooAbsData.h.

◆ storageType

StorageType RooAbsData::storageType
protected

Definition at line 256 of file RooAbsData.h.

Libraries for RooAbsData:
[legend]

The documentation for this class was generated from the following files:
RooAbsReal::NumEvent
@ NumEvent
Definition: RooAbsReal.h:255
RooFit::Normalization
RooCmdArg Normalization(Double_t scaleFactor)
Definition: RooGlobalFunc.cxx:52
x
Double_t x[n]
Definition: legend1.C:17
RooFit::YVar
RooCmdArg YVar(const RooAbsRealLValue &var, const RooCmdArg &arg=RooCmdArg::none())
Definition: RooGlobalFunc.cxx:246
RooFit::Binning
RooCmdArg Binning(const RooAbsBinning &binning)
Definition: RooGlobalFunc.cxx:83
RooFit::CutRange
RooCmdArg CutRange(const char *rangeName)
Definition: RooGlobalFunc.cxx:89
RooFit::ZVar
RooCmdArg ZVar(const RooAbsRealLValue &var, const RooCmdArg &arg=RooCmdArg::none())
Definition: RooGlobalFunc.cxx:247
RooAbsData::createHistogram
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:629
y
Double_t y[n]
Definition: legend1.C:17
RooFit::ProjectionRange
RooCmdArg ProjectionRange(const char *rangeName)
Definition: RooGlobalFunc.cxx:62
make_cnn_model.model
model
Definition: make_cnn_model.py:6