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 44 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
 
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
 
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
 Calls RooPlot* plotOn(RooPlot* frame, const RooLinkedList& cmdList) const ;. More...
 
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
 
virtual Double_t sumEntries (const char *cutSpec, const char *cutRange=0) const =0
 
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 Print (Option_t *option="") const
 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...
 
- 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 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...
 
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 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 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 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_t verbose=kFALSE, 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...
 

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
 

Additional Inherited Members

- Protected Types inherited from TObject
enum  { kOnlyPrepStep = BIT(3) }
 

#include <RooAbsData.h>

Inheritance diagram for RooAbsData:
[legend]

Member Enumeration Documentation

◆ ErrorType

Enumerator
Poisson 
SumW2 
None 
Auto 
Expected 

Definition at line 94 of file RooAbsData.h.

◆ StorageType

Enumerator
Tree 
Vector 
Composite 

Definition at line 230 of file RooAbsData.h.

Constructor & Destructor Documentation

◆ RooAbsData() [1/3]

RooAbsData::RooAbsData ( )

Default constructor.

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

◆ RooAbsData() [3/3]

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

Copy constructor.

Definition at line 170 of file RooAbsData.cxx.

◆ ~RooAbsData()

RooAbsData::~RooAbsData ( )
virtual

Destructor.

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

◆ addOwnedComponent()

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

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

◆ attachBuffers()

void RooAbsData::attachBuffers ( const RooArgSet extObs)

Definition at line 2263 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 346 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 329 of file RooAbsData.cxx.

◆ cacheClone()

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

Implemented in RooDataHist, and RooDataSet.

◆ canSplitFast()

Bool_t RooAbsData::canSplitFast ( ) const

Definition at line 2277 of file RooAbsData.cxx.

◆ changeObservableName()

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

Definition at line 286 of file RooAbsData.cxx.

◆ checkInit()

void RooAbsData::checkInit ( ) const

Definition at line 2321 of file RooAbsData.cxx.

◆ claimVars()

void RooAbsData::claimVars ( RooAbsData data)
static

Definition at line 95 of file RooAbsData.cxx.

◆ convertToTreeStore()

void RooAbsData::convertToTreeStore ( )
virtual

Convert vector-based storage to tree-based storage.

Reimplemented in RooDataSet.

Definition at line 2375 of file RooAbsData.cxx.

◆ convertToVectorStore()

void RooAbsData::convertToVectorStore ( )

Convert tree-based storage to vector-based storage.

Definition at line 274 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 919 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 975 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 199 of file RooAbsData.h.

◆ correlationMatrix() [1/2]

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

Definition at line 202 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 204 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 198 of file RooAbsData.h.

◆ covarianceMatrix() [1/2]

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

Definition at line 201 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 203 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")))
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:628
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
Double_t x[n]
Definition: legend1.C:17

The caller takes ownership of the returned histogram

Definition at line 668 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 566 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 900 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 809 of file RooAbsData.cxx.

◆ Draw()

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

Forward draw command to data store.

Reimplemented from TObject.

Definition at line 2329 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 299 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 1288 of file RooAbsData.cxx.

◆ get() [1/2]

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

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 87 of file RooAbsData.h.

◆ get() [2/2]

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

Reimplemented in RooDataSet, and RooDataHist.

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

◆ getDefaultStorageType()

RooAbsData::StorageType RooAbsData::getDefaultStorageType ( )
static

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

◆ getSimData()

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

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

◆ isNonPoissonWeighted()

virtual Bool_t RooAbsData::isNonPoissonWeighted ( ) const
inlinevirtual

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 112 of file RooAbsData.h.

◆ isWeighted()

virtual Bool_t RooAbsData::isWeighted ( ) const
inlinevirtual

Reimplemented in RooDataHist, and RooDataSet.

Definition at line 108 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 196 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 193 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 1071 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 842 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 855 of file RooAbsData.cxx.

◆ numEntries()

Int_t RooAbsData::numEntries ( ) const
virtual

Reimplemented in RooDataHist.

Definition at line 306 of file RooAbsData.cxx.

◆ operator=()

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

Definition at line 210 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 2179 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 1870 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 1964 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

Calls RooPlot* plotOn(RooPlot* frame, const RooLinkedList& cmdList) const ;.

Reimplemented in RooDataHist.

Definition at line 546 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 by default retain its intrinsic binning.

The following optional named arguments can be used to modify the default behavior

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 ( sum(w)^2/sum(w^2) )
  • 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
CutRange(const char*) Apply cuts to dataset.
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 CutRange(const char *rangeName)
RooCmdArg Normalization(Double_t scaleFactor)
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

Reimplemented in RooDataHist.

Definition at line 1614 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

Reimplemented in RooDataHist, and RooDataHist.

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

◆ printClassName()

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

Print class name of dataset.

Reimplemented from RooPrintable.

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

Definition at line 801 of file RooAbsData.cxx.

◆ printName()

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

Print name of dataset.

Reimplemented from RooPrintable.

Definition at line 778 of file RooAbsData.cxx.

◆ printTitle()

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

Print title of dataset.

Reimplemented from RooPrintable.

Definition at line 786 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 2389 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 461 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 485 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 511 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 381 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 472 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 RooDataHist, and RooDataSet.

◆ releaseVars()

Bool_t RooAbsData::releaseVars ( RooAbsData data)
static

If return value is true variables can be deleted.

Definition at line 104 of file RooAbsData.cxx.

◆ reset()

void RooAbsData::reset ( )
virtual

Reimplemented in RooDataHist.

Definition at line 313 of file RooAbsData.cxx.

◆ resetBuffers()

void RooAbsData::resetBuffers ( )

Definition at line 2270 of file RooAbsData.cxx.

◆ resetCache()

void RooAbsData::resetCache ( )
protectedvirtual

Internal method – Remove cached function values.

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

◆ setArgStatus()

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

Definition at line 353 of file RooAbsData.cxx.

◆ setDefaultStorageType()

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

Definition at line 77 of file RooAbsData.cxx.

◆ setDirtyProp()

void RooAbsData::setDirtyProp ( Bool_t  flag)

Control propagation of dirty flags from observables in dataset.

Definition at line 361 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 194 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 195 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 1478 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 823 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 1217 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 1164 of file RooAbsData.cxx.

◆ store() [1/2]

RooAbsDataStore * RooAbsData::store ( )
inline

Definition at line 63 of file RooAbsData.h.

◆ store() [2/2]

const RooAbsDataStore * RooAbsData::store ( ) const
inline

Definition at line 64 of file RooAbsData.h.

◆ sumEntries() [1/2]

virtual Double_t RooAbsData::sumEntries ( ) const
pure virtual

Implemented in RooDataHist, and RooDataSet.

◆ sumEntries() [2/2]

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

Implemented in RooDataHist, and RooDataSet.

◆ 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 2053 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 748 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 2346 of file RooAbsData.cxx.

◆ valid()

virtual Bool_t RooAbsData::valid ( ) const
inlinevirtual

Reimplemented in RooDataHist.

Definition at line 93 of file RooAbsData.h.

◆ weight()

virtual Double_t RooAbsData::weight ( ) const
pure virtual

Implemented in RooDataHist, and RooDataSet.

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

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

Definition at line 532 of file RooAbsData.cxx.

◆ weightSquared()

virtual Double_t RooAbsData::weightSquared ( ) const
pure virtual

Implemented in RooDataHist, and RooDataSet.

Friends And Related Function Documentation

◆ RooAbsArg

friend class RooAbsArg
friend

Definition at line 256 of file RooAbsData.h.

◆ RooAbsCachedPdf

friend class RooAbsCachedPdf
friend

Definition at line 259 of file RooAbsData.h.

◆ RooAbsOptTestStatistic

friend class RooAbsOptTestStatistic
friend

Definition at line 258 of file RooAbsData.h.

◆ RooAbsReal

friend class RooAbsReal
friend

Definition at line 257 of file RooAbsData.h.

Member Data Documentation

◆ _cachedVars

RooArgSet RooAbsData::_cachedVars
protected

Definition at line 274 of file RooAbsData.h.

◆ _dstore

RooAbsDataStore* RooAbsData::_dstore
protected

External variables cached with this data set.

Definition at line 276 of file RooAbsData.h.

◆ _ownedComponents

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

Definition at line 278 of file RooAbsData.h.

◆ _vars

RooArgSet RooAbsData::_vars
protected

Definition at line 273 of file RooAbsData.h.

◆ defaultStorageType

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

Definition at line 238 of file RooAbsData.h.

◆ storageType

StorageType RooAbsData::storageType
protected

Definition at line 240 of file RooAbsData.h.

Libraries for RooAbsData:
[legend]

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