Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
RooTreeDataStore Class Reference

TTree-backed data storage.

When a file is opened before creating the data storage, the storage will be file-backed. This reduces memory pressure because it allows storing the data in the file and reading it on demand. For a completely memory-backed storage, which is faster than the file-backed storage, RooVectorDataStore can be used.

With tree-backed storage, the tree can be found in the file with the name RooTreeDataStore_name_title for a dataset created as RooDataSet("name", "title", ...).

Note
A file needs to be opened before creating the data storage to enable file-backed storage.
TFile outputFile("filename.root", "RECREATE");
RooDataSet mydata(...);
static void setDefaultStorageType(StorageType s)
Container class to hold unbinned data.
Definition RooDataSet.h:34
A ROOT file is an on-disk file, usually with extension .root, that stores objects in a file-system-li...
Definition TFile.h:53

One can also change between TTree- and std::vector-backed storage using RooAbsData::convertToTreeStore() and RooAbsData::convertToVectorStore().

Definition at line 34 of file RooTreeDataStore.h.

Public Member Functions

 RooTreeDataStore ()
 
 RooTreeDataStore (const RooTreeDataStore &other, const char *newname=nullptr)
 
 RooTreeDataStore (const RooTreeDataStore &other, const RooArgSet &vars, const char *newname=nullptr)
 
 RooTreeDataStore (RooStringView name, RooStringView title, const RooArgSet &vars, const char *wgtVarName=nullptr)
 
 RooTreeDataStore (RooStringView name, RooStringView title, const RooArgSet &vars, const RooAbsDataStore &tds, const char *selExpr=nullptr, const char *wgtVarName=nullptr)
 
 RooTreeDataStore (RooStringView name, RooStringView title, const RooArgSet &vars, TTree &t, const char *selExpr=nullptr, const char *wgtVarName=nullptr)
 
 RooTreeDataStore (RooStringView name, RooStringView title, RooAbsDataStore &tds, const RooArgSet &vars, const RooFormulaVar *cutVar, const char *cutRange, Int_t nStart, Int_t nStop, const char *wgtVarName=nullptr)
 
 RooTreeDataStore (TTree *t, const RooArgSet &vars, const char *wgtVarName=nullptr)
 Constructor to facilitate reading of legacy RooDataSets.
 
 ~RooTreeDataStore () override
 Destructor.
 
RooAbsArgaddColumn (RooAbsArg &var, bool adjustRange=true) override
 Add a new column to the data set which holds the pre-calculated values of 'newVar'.
 
void append (RooAbsDataStore &other) override
 
void attachBuffers (const RooArgSet &extObs) override
 
void cacheArgs (const RooAbsArg *owner, RooArgSet &varSet, const RooArgSet *nset=nullptr, bool skipZeroWeights=false) override
 Cache given RooAbsArgs with this tree: The tree is given direct write access of the args internal cache the args values is pre-calculated for all data points in this data collection.
 
const RooAbsArgcacheOwner () override
 
bool changeObservableName (const char *from, const char *to) override
 Change name of internal observable named 'from' into 'to'.
 
void checkInit () const override
 
RooAbsDataStoreclone (const char *newname=nullptr) const override
 
RooAbsDataStoreclone (const RooArgSet &vars, const char *newname=nullptr) const override
 
void Draw (Option_t *option="") override
 Default Draw method for all objects.
 
Int_t Fill ()
 Interface function to TTree::Fill.
 
Int_t fill () override
 Interface function to TTree::Fill.
 
virtual const RooArgSetget () const
 
const RooArgSetget (Int_t index) const override
 Load the n-th data point (n='index') in memory and return a pointer to the internal RooArgSet holding its coordinates.
 
virtual const RooArgSetget (Int_t index) const=0
 
RooAbsData::RealSpans getBatches (std::size_t first, std::size_t len) const override
 Retrieve batches for all observables in this data store.
 
Stat_t GetEntries () const
 Interface function to TTree::GetEntries.
 
Int_t GetEntry (Int_t entry=0, Int_t getall=0)
 Interface function to TTree::GetEntry.
 
std::span< const doublegetWeightBatch (std::size_t first, std::size_t len) const override
 Get the weights of the events in the range [first, first+len).
 
TClassIsA () const override
 
bool isWeighted () const override
 
void loadValues (const RooAbsDataStore *tds, const RooFormulaVar *select=nullptr, const char *rangeName=nullptr, std::size_t nStart=0, std::size_t nStop=std::numeric_limits< std::size_t >::max()) override
 Load values from dataset 't' into this data collection, optionally selecting events using 'select' RooFormulaVar.
 
void loadValues (const TTree *t, const RooFormulaVar *select=nullptr, const char *rangeName=nullptr, Int_t nStart=0, Int_t nStop=2000000000)
 Load values from tree 't' into this data collection, optionally selecting events using the RooFormulaVar 'select'.
 
RooAbsDataStoremerge (const RooArgSet &allvars, std::list< RooAbsDataStore * > dstoreList) override
 Merge columns of supplied data set(s) with this data set.
 
Int_t numEntries () const override
 
std::unique_ptr< RooAbsDataStorereduce (RooStringView name, RooStringView title, const RooArgSet &vars, const RooFormulaVar *cutVar, const char *cutRange, std::size_t nStart, std::size_t nStop) override
 
void reset () override
 
void Reset (Option_t *option=nullptr)
 Interface function to TTree::Reset.
 
void resetBuffers () override
 
void resetCache () override
 Remove tree with values of cached observables and clear list of cached observables.
 
void restoreAlternateBuffers ()
 
const RooArgSetrow ()
 
void setArgStatus (const RooArgSet &set, bool active) override
 Activate or deactivate the branch status of the TTree branch associated with the given set of dataset observables.
 
void setExternalWeightArray (const double *arrayWgt, const double *arrayWgtErrLo, const double *arrayWgtErrHi, const double *arraySumW2) override
 
void Streamer (TBuffer &) override
 Stream an object of class RooTreeDataStore.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
double sumEntries () const override
 
TTreetree ()
 
const TTreetree () const override
 
double weight () const override
 Return the weight of the n-th data point (n='index') in memory.
 
virtual double weight () const=0
 
double weight (Int_t index) const
 
void weightError (double &lo, double &hi, RooAbsData::ErrorType etype=RooAbsData::Poisson) const override
 
double weightError (RooAbsData::ErrorType etype=RooAbsData::Poisson) const override
 
- Public Member Functions inherited from RooAbsDataStore
 RooAbsDataStore ()
 
 RooAbsDataStore (const RooAbsDataStore &other, const char *newname=nullptr)
 
 RooAbsDataStore (const RooAbsDataStore &other, const RooArgSet &vars, const char *newname=nullptr)
 
 RooAbsDataStore (RooStringView name, RooStringView title, const RooArgSet &vars)
 
RooArgSetaddColumns (const RooArgList &varList)
 
const RooArgSetcachedVars () const
 
int defaultPrintContents (Option_t *) const override
 Define default print options, for a given print style.
 
bool dirtyProp () const
 
virtual void dump ()
 
virtual void forceCacheUpdate ()
 
virtual RooAbsData::CategorySpans getCategoryBatches (std::size_t, std::size_t) const
 
virtual bool hasFilledCache () const
 
void Print (Option_t *options=nullptr) const override
 This method must be overridden when a class wants to print itself.
 
void printArgs (std::ostream &os) const override
 Print argument of dataset, i.e. the observable names.
 
void printClassName (std::ostream &os) const override
 Print class name of dataset.
 
void printMultiline (std::ostream &os, Int_t content, bool verbose, TString indent) const override
 Detailed printing interface.
 
void printName (std::ostream &os) const override
 Print name of dataset.
 
void printTitle (std::ostream &os) const override
 Print title of dataset.
 
void printValue (std::ostream &os) const override
 Print value of the dataset, i.e. the sum of weights contained in the dataset.
 
virtual void recalculateCache (const RooArgSet *, Int_t, Int_t, Int_t, bool)
 
virtual void setDirtyProp (bool flag)
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
double weight (Int_t index) const
 
- Public Member Functions inherited from TNamed
 TNamed ()
 
 TNamed (const char *name, const char *title)
 
 TNamed (const TNamed &named)
 TNamed copy ctor.
 
 TNamed (const TString &name, const TString &title)
 
virtual ~TNamed ()
 TNamed destructor.
 
void Clear (Option_t *option="") override
 Set name and title to empty strings ("").
 
TObjectClone (const char *newname="") const override
 Make a clone of an object using the Streamer facility.
 
Int_t Compare (const TObject *obj) const override
 Compare two TNamed objects.
 
void Copy (TObject &named) const override
 Copy this to obj.
 
virtual void FillBuffer (char *&buffer)
 Encode TNamed into output buffer.
 
const char * GetName () const override
 Returns name of object.
 
const char * GetTitle () const override
 Returns title of object.
 
ULong_t Hash () const override
 Return hash value for this object.
 
TClassIsA () const override
 
Bool_t IsSortable () const override
 
void ls (Option_t *option="") const override
 List TNamed name and title.
 
TNamedoperator= (const TNamed &rhs)
 TNamed assignment operator.
 
void Print (Option_t *option="") const override
 Print TNamed name and title.
 
virtual void SetName (const char *name)
 Set the name of the TNamed.
 
virtual void SetNameTitle (const char *name, const char *title)
 Set all the TNamed parameters (name and title).
 
virtual void SetTitle (const char *title="")
 Set the title of the TNamed.
 
virtual Int_t Sizeof () const
 Return size of the TNamed part of the TObject.
 
void Streamer (TBuffer &) override
 Stream an object of class TObject.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
- Public Member Functions inherited from TObject
 TObject ()
 TObject constructor.
 
 TObject (const TObject &object)
 TObject copy ctor.
 
virtual ~TObject ()
 TObject destructor.
 
void AbstractMethod (const char *method) const
 Use this method to implement an "abstract" method that you don't want to leave purely abstract.
 
virtual void AppendPad (Option_t *option="")
 Append graphics object to current pad.
 
virtual void Browse (TBrowser *b)
 Browse object. May be overridden for another default action.
 
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.
 
virtual const char * ClassName () const
 Returns name of class to which the object belongs.
 
virtual void Delete (Option_t *option="")
 Delete this object.
 
virtual Int_t DistancetoPrimitive (Int_t px, Int_t py)
 Computes distance from point (px,py) to the object.
 
virtual void DrawClass () const
 Draw class inheritance tree of the class to which this object belongs.
 
virtual TObjectDrawClone (Option_t *option="") const
 Draw a clone of this object in the current selected pad with: gROOT->SetSelectedPad(c1).
 
virtual void Dump () const
 Dump contents of object on stdout.
 
virtual void Error (const char *method, const char *msgfmt,...) const
 Issue error message.
 
virtual void Execute (const char *method, const char *params, Int_t *error=nullptr)
 Execute method on this object with the given parameter string, e.g.
 
virtual void Execute (TMethod *method, TObjArray *params, Int_t *error=nullptr)
 Execute method on this object with parameters stored in the TObjArray.
 
virtual void ExecuteEvent (Int_t event, Int_t px, Int_t py)
 Execute action corresponding to an event at (px,py).
 
virtual void Fatal (const char *method, const char *msgfmt,...) const
 Issue fatal error message.
 
virtual TObjectFindObject (const char *name) const
 Must be redefined in derived classes.
 
virtual TObjectFindObject (const TObject *obj) const
 Must be redefined in derived classes.
 
virtual Option_tGetDrawOption () const
 Get option used by the graphics system to draw this object.
 
virtual const char * GetIconName () const
 Returns mime type name of object.
 
virtual char * GetObjectInfo (Int_t px, Int_t py) const
 Returns string containing info about the object at position (px,py).
 
virtual Option_tGetOption () const
 
virtual UInt_t GetUniqueID () const
 Return the unique object id.
 
virtual Bool_t HandleTimer (TTimer *timer)
 Execute action in response of a timer timing out.
 
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.
 
virtual void Info (const char *method, const char *msgfmt,...) const
 Issue info message.
 
virtual Bool_t InheritsFrom (const char *classname) const
 Returns kTRUE if object inherits from class "classname".
 
virtual Bool_t InheritsFrom (const TClass *cl) const
 Returns kTRUE if object inherits from TClass cl.
 
virtual void Inspect () const
 Dump contents of this object in a graphics canvas.
 
void InvertBit (UInt_t f)
 
Bool_t IsDestructed () const
 IsDestructed.
 
virtual Bool_t IsEqual (const TObject *obj) const
 Default equal comparison (objects are equal if they have the same address in memory).
 
virtual Bool_t IsFolder () const
 Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).
 
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).
 
virtual Bool_t Notify ()
 This method must be overridden to handle object notification (the base implementation is no-op).
 
void Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const
 Use this method to declare a method obsolete.
 
void operator delete (void *ptr)
 Operator delete.
 
void operator delete (void *ptr, void *vp)
 Only called by placement new when throwing an exception.
 
void operator delete[] (void *ptr)
 Operator delete [].
 
void operator delete[] (void *ptr, void *vp)
 Only called by placement new[] when throwing an exception.
 
void * operator new (size_t sz)
 
void * operator new (size_t sz, void *vp)
 
void * operator new[] (size_t sz)
 
void * operator new[] (size_t sz, void *vp)
 
TObjectoperator= (const TObject &rhs)
 TObject assignment operator.
 
virtual void Paint (Option_t *option="")
 This method must be overridden if a class wants to paint itself.
 
virtual void Pop ()
 Pop on object drawn in a pad to the top of the display list.
 
virtual Int_t Read (const char *name)
 Read contents of object with specified name from the current directory.
 
virtual void RecursiveRemove (TObject *obj)
 Recursively remove this object from a list.
 
void ResetBit (UInt_t f)
 
virtual void SaveAs (const char *filename="", Option_t *option="") const
 Save this object in the file specified by filename.
 
virtual void SavePrimitive (std::ostream &out, Option_t *option="")
 Save a primitive as a C++ statement(s) on output stream "out".
 
void SetBit (UInt_t f)
 
void SetBit (UInt_t f, Bool_t set)
 Set or unset the user status bits as specified in f.
 
virtual void SetDrawOption (Option_t *option="")
 Set drawing option for object.
 
virtual void SetUniqueID (UInt_t uid)
 Set the unique object id.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
virtual void SysError (const char *method, const char *msgfmt,...) const
 Issue system error message.
 
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.
 
virtual void Warning (const char *method, const char *msgfmt,...) const
 Issue warning message.
 
virtual Int_t Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0)
 Write this object to the current directory.
 
virtual Int_t Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0) const
 Write this object to the current directory.
 
- 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.
 
virtual void printExtras (std::ostream &os) const
 Interface to print extras of object.
 
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'.
 
virtual void printTree (std::ostream &os, TString indent="") const
 Interface for tree structure printing of object.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 

Static Public Member Functions

static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
- Static Public Member Functions inherited from RooAbsDataStore
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
- Static Public Member Functions inherited from TNamed
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
- Static Public Member Functions inherited from TObject
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static Longptr_t GetDtorOnly ()
 Return destructor only flag.
 
static Bool_t GetObjectStat ()
 Get status of object stat flag.
 
static void SetDtorOnly (void *obj)
 Set destructor only flag.
 
static void SetObjectStat (Bool_t stat)
 Turn on/off tracking of objects in the TObjectTable.
 
- Static Public Member Functions inherited from RooPrintable
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static std::ostream & defaultPrintStream (std::ostream *os=nullptr)
 Return a reference to the current default stream to use in Print().
 
static void nameFieldLength (Int_t newLen)
 Set length of field reserved from printing name of RooAbsArgs in multi-line collection printing to given amount.
 

Private Member Functions

void attachCache (const RooAbsArg *newOwner, const RooArgSet &cachedVars) override
 Initialize cache of dataset: attach variables of cache ArgSet to the corresponding TTree branches.
 
void createTree (RooStringView name, RooStringView title)
 Create TTree object that lives in memory, independent of current location of gDirectory.
 
Int_t getBranchBufferSize () const
 
void initialize ()
 One-time initialization common to all constructor forms.
 
std::string makeTreeName () const
 Generate a name for the storage tree from the name and title of this instance.
 
void setBranchBufferSize (Int_t size)
 
RooArgSet varsNoWeight (const RooArgSet &allVars, const char *wgtName=nullptr)
 Utility function for constructors Return RooArgSet that is copy of allVars minus variable matching wgtName if specified.
 
RooRealVarweightVar (const RooArgSet &allVars, const char *wgtName=nullptr)
 Utility function for constructors Return pointer to weight variable if it is defined.
 

Private Attributes

RooArgSet _attachedBuffers
 ! Currently attached buffers (if different from _varsww)
 
const RooAbsArg_cacheOwner = nullptr
 TTree holding the cached function values.
 
TTree_cacheTree = nullptr
 
double _curWgt = 1.0
 Buffer for weights in case a batch of values is requested.
 
double _curWgtErr = 0.0
 Weight of current event.
 
double _curWgtErrHi = 0.0
 Weight of current event.
 
double _curWgtErrLo = 0.0
 Weight of current event.
 
bool _defCtor = false
 Object owning cache contents.
 
const double_extSumW2Array {nullptr}
 ! External sum of weights array
 
const double_extWgtArray {nullptr}
 ! External weight array
 
const double_extWgtErrHiArray {nullptr}
 ! External weight array - high error
 
const double_extWgtErrLoArray {nullptr}
 ! External weight array - low error
 
TTree_tree = nullptr
 
RooArgSet _varsww
 Was object constructed with default ctor?
 
std::unique_ptr< std::vector< double > > _weightBuffer
 
RooRealVar_wgtVar = nullptr
 

Static Private Attributes

static Int_t _defTreeBufSize = 10*1024*1024
 

Friends

class RooVectorDataStore
 

Additional Inherited Members

- Public Types inherited from TObject
enum  {
  kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 ,
  kBitMask = 0x00ffffff
}
 
enum  { kSingleKey = (1ULL << ( 0 )) , kOverwrite = (1ULL << ( 1 )) , kWriteDelete = (1ULL << ( 2 )) }
 
enum  EDeprecatedStatusBits { kObjInCanvas = (1ULL << ( 3 )) }
 
enum  EStatusBits {
  kCanDelete = (1ULL << ( 0 )) , kMustCleanup = (1ULL << ( 3 )) , kIsReferenced = (1ULL << ( 4 )) , kHasUUID = (1ULL << ( 5 )) ,
  kCannotPick = (1ULL << ( 6 )) , kNoContextMenu = (1ULL << ( 8 )) , kInvalidObject = (1ULL << ( 13 ))
}
 
- Public Types inherited from RooPrintable
enum  ContentsOption {
  kName =1 , kClassName =2 , kValue =4 , kArgs =8 ,
  kExtras =16 , kAddress =32 , kTitle =64 , kCollectionHeader =128
}
 
enum  StyleOption {
  kInline =1 , kSingleLine =2 , kStandard =3 , kVerbose =4 ,
  kTreeStructure =5
}
 
- Protected Types inherited from TObject
enum  { kOnlyPrepStep = (1ULL << ( 3 )) }
 
- 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).
 
void MakeZombie ()
 
- Protected Attributes inherited from RooAbsDataStore
RooArgSet _cachedVars
 
bool _doDirtyProp = true
 Switch do (de)activate dirty state propagation when loading a data point.
 
RooArgSet _vars
 
- Protected Attributes inherited from TNamed
TString fName
 
TString fTitle
 
- Static Protected Attributes inherited from RooPrintable
static Int_t _nameLength
 

#include <RooTreeDataStore.h>

Inheritance diagram for RooTreeDataStore:
[legend]

Constructor & Destructor Documentation

◆ RooTreeDataStore() [1/8]

RooTreeDataStore::RooTreeDataStore ( )

Definition at line 74 of file RooTreeDataStore.cxx.

◆ RooTreeDataStore() [2/8]

RooTreeDataStore::RooTreeDataStore ( TTree t,
const RooArgSet vars,
const char *  wgtVarName = nullptr 
)

Constructor to facilitate reading of legacy RooDataSets.

Definition at line 81 of file RooTreeDataStore.cxx.

◆ RooTreeDataStore() [3/8]

RooTreeDataStore::RooTreeDataStore ( RooStringView  name,
RooStringView  title,
const RooArgSet vars,
const char *  wgtVarName = nullptr 
)

Definition at line 95 of file RooTreeDataStore.cxx.

◆ RooTreeDataStore() [4/8]

RooTreeDataStore::RooTreeDataStore ( RooStringView  name,
RooStringView  title,
const RooArgSet vars,
TTree t,
const char *  selExpr = nullptr,
const char *  wgtVarName = nullptr 
)

Definition at line 106 of file RooTreeDataStore.cxx.

◆ RooTreeDataStore() [5/8]

RooTreeDataStore::RooTreeDataStore ( RooStringView  name,
RooStringView  title,
const RooArgSet vars,
const RooAbsDataStore tds,
const char *  selExpr = nullptr,
const char *  wgtVarName = nullptr 
)

Definition at line 125 of file RooTreeDataStore.cxx.

◆ RooTreeDataStore() [6/8]

RooTreeDataStore::RooTreeDataStore ( RooStringView  name,
RooStringView  title,
RooAbsDataStore tds,
const RooArgSet vars,
const RooFormulaVar cutVar,
const char *  cutRange,
Int_t  nStart,
Int_t  nStop,
const char *  wgtVarName = nullptr 
)

Definition at line 146 of file RooTreeDataStore.cxx.

◆ RooTreeDataStore() [7/8]

RooTreeDataStore::RooTreeDataStore ( const RooTreeDataStore other,
const char *  newname = nullptr 
)

Definition at line 248 of file RooTreeDataStore.cxx.

◆ RooTreeDataStore() [8/8]

RooTreeDataStore::RooTreeDataStore ( const RooTreeDataStore other,
const RooArgSet vars,
const char *  newname = nullptr 
)

Definition at line 268 of file RooTreeDataStore.cxx.

◆ ~RooTreeDataStore()

RooTreeDataStore::~RooTreeDataStore ( )
override

Destructor.

Definition at line 291 of file RooTreeDataStore.cxx.

Member Function Documentation

◆ addColumn()

RooAbsArg * RooTreeDataStore::addColumn ( RooAbsArg newVar,
bool  adjustRange = true 
)
overridevirtual

Add a new column to the data set which holds the pre-calculated values of 'newVar'.

This operation is only meaningful if 'newVar' is a derived value.

The return value points to the added element holding 'newVar's value in the data collection. The element is always the corresponding fundamental type of 'newVar' (e.g. a RooRealVar if 'newVar' is a RooFormulaVar)

Note: This function is explicitly NOT intended as a speed optimization opportunity for the user. Components of complex PDFs that can be precalculated with the dataset are automatically identified as such and will be precalculated when fitting to a dataset

By forcibly precalculating functions with non-trivial Jacobians, or functions of multiple variables occurring in the data set, using addColumn(), you may alter the outcome of the fit.

Only in cases where such a modification of fit behaviour is intentional, this function should be used.

Implements RooAbsDataStore.

Definition at line 782 of file RooTreeDataStore.cxx.

◆ append()

void RooTreeDataStore::append ( RooAbsDataStore other)
overridevirtual

Implements RooAbsDataStore.

Definition at line 867 of file RooTreeDataStore.cxx.

◆ attachBuffers()

void RooTreeDataStore::attachBuffers ( const RooArgSet extObs)
overridevirtual

Implements RooAbsDataStore.

Definition at line 1036 of file RooTreeDataStore.cxx.

◆ attachCache()

void RooTreeDataStore::attachCache ( const RooAbsArg newOwner,
const RooArgSet cachedVars 
)
overrideprivatevirtual

Initialize cache of dataset: attach variables of cache ArgSet to the corresponding TTree branches.

Implements RooAbsDataStore.

Definition at line 229 of file RooTreeDataStore.cxx.

◆ cacheArgs()

void RooTreeDataStore::cacheArgs ( const RooAbsArg owner,
RooArgSet newVarSet,
const RooArgSet nset = nullptr,
bool  skipZeroWeights = false 
)
overridevirtual

Cache given RooAbsArgs with this tree: The tree is given direct write access of the args internal cache the args values is pre-calculated for all data points in this data collection.

Upon a get() call, the internal cache of 'newVar' will be loaded with the precalculated value and it's dirty flag will be cleared.

Implements RooAbsDataStore.

Definition at line 950 of file RooTreeDataStore.cxx.

◆ cacheOwner()

const RooAbsArg * RooTreeDataStore::cacheOwner ( )
inlineoverridevirtual

Implements RooAbsDataStore.

Definition at line 121 of file RooTreeDataStore.h.

◆ changeObservableName()

bool RooTreeDataStore::changeObservableName ( const char *  from,
const char *  to 
)
overridevirtual

Change name of internal observable named 'from' into 'to'.

Implements RooAbsDataStore.

Definition at line 712 of file RooTreeDataStore.cxx.

◆ checkInit()

void RooTreeDataStore::checkInit ( ) const
overridevirtual

Reimplemented from RooAbsDataStore.

Definition at line 1080 of file RooTreeDataStore.cxx.

◆ Class()

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

◆ Class_Name()

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

◆ Class_Version()

static constexpr Version_t RooTreeDataStore::Class_Version ( )
inlinestaticconstexpr
Returns
Version of this class

Definition at line 181 of file RooTreeDataStore.h.

◆ clone() [1/2]

RooAbsDataStore * RooTreeDataStore::clone ( const char *  newname = nullptr) const
inlineoverridevirtual

Implements RooAbsDataStore.

Definition at line 42 of file RooTreeDataStore.h.

◆ clone() [2/2]

RooAbsDataStore * RooTreeDataStore::clone ( const RooArgSet vars,
const char *  newname = nullptr 
) const
inlineoverridevirtual

Implements RooAbsDataStore.

Definition at line 43 of file RooTreeDataStore.h.

◆ createTree()

void RooTreeDataStore::createTree ( RooStringView  name,
RooStringView  title 
)
private

Create TTree object that lives in memory, independent of current location of gDirectory.

Definition at line 326 of file RooTreeDataStore.cxx.

◆ DeclFileName()

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

Definition at line 181 of file RooTreeDataStore.h.

◆ Draw()

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

Default Draw method for all objects.

Reimplemented from TObject.

Definition at line 1133 of file RooTreeDataStore.cxx.

◆ Fill()

Int_t RooTreeDataStore::Fill ( )

Interface function to TTree::Fill.

Definition at line 1113 of file RooTreeDataStore.cxx.

◆ fill()

Int_t RooTreeDataStore::fill ( )
overridevirtual

Interface function to TTree::Fill.

Implements RooAbsDataStore.

Definition at line 541 of file RooTreeDataStore.cxx.

◆ get() [1/3]

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

Reimplemented from RooAbsDataStore.

Definition at line 60 of file RooAbsDataStore.h.

◆ get() [2/3]

const RooArgSet * RooTreeDataStore::get ( Int_t  index) const
overridevirtual

Load the n-th data point (n='index') in memory and return a pointer to the internal RooArgSet holding its coordinates.

Implements RooAbsDataStore.

Definition at line 553 of file RooTreeDataStore.cxx.

◆ get() [3/3]

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

Implements RooAbsDataStore.

◆ getBatches()

RooAbsData::RealSpans RooTreeDataStore::getBatches ( std::size_t  first,
std::size_t  len 
) const
inlineoverridevirtual

Retrieve batches for all observables in this data store.

Implements RooAbsDataStore.

Definition at line 76 of file RooTreeDataStore.h.

◆ getBranchBufferSize()

Int_t RooTreeDataStore::getBranchBufferSize ( ) const
inlineprivate

Definition at line 153 of file RooTreeDataStore.h.

◆ GetEntries()

Stat_t RooTreeDataStore::GetEntries ( ) const

Interface function to TTree::GetEntries.

Definition at line 1095 of file RooTreeDataStore.cxx.

◆ GetEntry()

Int_t RooTreeDataStore::GetEntry ( Int_t  entry = 0,
Int_t  getall = 0 
)

Interface function to TTree::GetEntry.

Definition at line 1122 of file RooTreeDataStore.cxx.

◆ getWeightBatch()

std::span< const double > RooTreeDataStore::getWeightBatch ( std::size_t  first,
std::size_t  len 
) const
overridevirtual

Get the weights of the events in the range [first, first+len).

This implementation will fill a vector with every event retrieved one by one (even if the weight is constant). Then, it returns a span.

Implements RooAbsDataStore.

Definition at line 1197 of file RooTreeDataStore.cxx.

◆ initialize()

void RooTreeDataStore::initialize ( )
private

One-time initialization common to all constructor forms.

Attach variables of internal ArgSet to the corresponding TTree branches

Definition at line 307 of file RooTreeDataStore.cxx.

◆ IsA()

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

Reimplemented from RooAbsDataStore.

Definition at line 181 of file RooTreeDataStore.h.

◆ isWeighted()

bool RooTreeDataStore::isWeighted ( ) const
inlineoverridevirtual

Implements RooAbsDataStore.

Definition at line 74 of file RooTreeDataStore.h.

◆ loadValues() [1/2]

void RooTreeDataStore::loadValues ( const RooAbsDataStore tds,
const RooFormulaVar select = nullptr,
const char *  rangeName = nullptr,
std::size_t  nStart = 0,
std::size_t  nStop = std::numeric_limits<std::size_t>::max() 
)
overridevirtual

Load values from dataset 't' into this data collection, optionally selecting events using 'select' RooFormulaVar.

Implements RooAbsDataStore.

Definition at line 470 of file RooTreeDataStore.cxx.

◆ loadValues() [2/2]

void RooTreeDataStore::loadValues ( const TTree t,
const RooFormulaVar select = nullptr,
const char *  rangeName = nullptr,
Int_t  nStart = 0,
Int_t  nStop = 2000000000 
)

Load values from tree 't' into this data collection, optionally selecting events using the RooFormulaVar 'select'.

The source tree 't' is cloned to not disturb its branch structure when retrieving information from it.

Definition at line 367 of file RooTreeDataStore.cxx.

◆ makeTreeName()

std::string RooTreeDataStore::makeTreeName ( ) const
private

Generate a name for the storage tree from the name and title of this instance.

Definition at line 1185 of file RooTreeDataStore.cxx.

◆ merge()

RooAbsDataStore * RooTreeDataStore::merge ( const RooArgSet allVars,
std::list< RooAbsDataStore * >  dstoreList 
)
overridevirtual

Merge columns of supplied data set(s) with this data set.

All data sets must have equal number of entries. In case of duplicate columns the column of the last dataset in the list prevails

Implements RooAbsDataStore.

Definition at line 840 of file RooTreeDataStore.cxx.

◆ numEntries()

Int_t RooTreeDataStore::numEntries ( ) const
overridevirtual

Implements RooAbsDataStore.

Definition at line 926 of file RooTreeDataStore.cxx.

◆ reduce()

std::unique_ptr< RooAbsDataStore > RooTreeDataStore::reduce ( RooStringView  name,
RooStringView  title,
const RooArgSet vars,
const RooFormulaVar cutVar,
const char *  cutRange,
std::size_t  nStart,
std::size_t  nStop 
)
overridevirtual

Implements RooAbsDataStore.

Definition at line 179 of file RooTreeDataStore.cxx.

◆ reset()

void RooTreeDataStore::reset ( )
overridevirtual

Implements RooAbsDataStore.

Definition at line 935 of file RooTreeDataStore.cxx.

◆ Reset()

void RooTreeDataStore::Reset ( Option_t option = nullptr)

Interface function to TTree::Reset.

Definition at line 1104 of file RooTreeDataStore.cxx.

◆ resetBuffers()

void RooTreeDataStore::resetBuffers ( )
overridevirtual

Implements RooAbsDataStore.

Definition at line 1058 of file RooTreeDataStore.cxx.

◆ resetCache()

void RooTreeDataStore::resetCache ( )
overridevirtual

Remove tree with values of cached observables and clear list of cached observables.

Implements RooAbsDataStore.

Definition at line 1018 of file RooTreeDataStore.cxx.

◆ restoreAlternateBuffers()

void RooTreeDataStore::restoreAlternateBuffers ( )

Definition at line 1069 of file RooTreeDataStore.cxx.

◆ row()

const RooArgSet & RooTreeDataStore::row ( )
inline

Definition at line 139 of file RooTreeDataStore.h.

◆ setArgStatus()

void RooTreeDataStore::setArgStatus ( const RooArgSet set,
bool  active 
)
overridevirtual

Activate or deactivate the branch status of the TTree branch associated with the given set of dataset observables.

Implements RooAbsDataStore.

Definition at line 999 of file RooTreeDataStore.cxx.

◆ setBranchBufferSize()

void RooTreeDataStore::setBranchBufferSize ( Int_t  size)
inlineprivate

Definition at line 152 of file RooTreeDataStore.h.

◆ setExternalWeightArray()

void RooTreeDataStore::setExternalWeightArray ( const double arrayWgt,
const double arrayWgtErrLo,
const double arrayWgtErrHi,
const double arraySumW2 
)
inlineoverridevirtual

Reimplemented from RooAbsDataStore.

Definition at line 131 of file RooTreeDataStore.h.

◆ Streamer()

void RooTreeDataStore::Streamer ( TBuffer R__b)
overridevirtual

Stream an object of class RooTreeDataStore.

Reimplemented from RooAbsDataStore.

Definition at line 1141 of file RooTreeDataStore.cxx.

◆ StreamerNVirtual()

void RooTreeDataStore::StreamerNVirtual ( TBuffer ClassDef_StreamerNVirtual_b)
inline

Definition at line 181 of file RooTreeDataStore.h.

◆ sumEntries()

double RooTreeDataStore::sumEntries ( ) const
overridevirtual

Reimplemented from RooAbsDataStore.

Definition at line 883 of file RooTreeDataStore.cxx.

◆ tree() [1/2]

TTree & RooTreeDataStore::tree ( )
inline

Definition at line 108 of file RooTreeDataStore.h.

◆ tree() [2/2]

const TTree * RooTreeDataStore::tree ( ) const
inlineoverridevirtual

Reimplemented from RooAbsDataStore.

Definition at line 109 of file RooTreeDataStore.h.

◆ varsNoWeight()

RooArgSet RooTreeDataStore::varsNoWeight ( const RooArgSet allVars,
const char *  wgtName = nullptr 
)
private

Utility function for constructors Return RooArgSet that is copy of allVars minus variable matching wgtName if specified.

Definition at line 195 of file RooTreeDataStore.cxx.

◆ weight() [1/3]

double RooTreeDataStore::weight ( ) const
overridevirtual

Return the weight of the n-th data point (n='index') in memory.

Implements RooAbsDataStore.

Definition at line 607 of file RooTreeDataStore.cxx.

◆ weight() [2/3]

virtual double RooAbsDataStore::weight ( ) const
virtual

Implements RooAbsDataStore.

◆ weight() [3/3]

double RooAbsDataStore::weight ( Int_t  index) const
inline

Definition at line 66 of file RooAbsDataStore.h.

◆ weightError() [1/2]

void RooTreeDataStore::weightError ( double lo,
double hi,
RooAbsData::ErrorType  etype = RooAbsData::Poisson 
) const
overridevirtual

Implements RooAbsDataStore.

Definition at line 646 of file RooTreeDataStore.cxx.

◆ weightError() [2/2]

double RooTreeDataStore::weightError ( RooAbsData::ErrorType  etype = RooAbsData::Poisson) const
overridevirtual

Implements RooAbsDataStore.

Definition at line 615 of file RooTreeDataStore.cxx.

◆ weightVar()

RooRealVar * RooTreeDataStore::weightVar ( const RooArgSet allVars,
const char *  wgtName = nullptr 
)
private

Utility function for constructors Return pointer to weight variable if it is defined.

Definition at line 213 of file RooTreeDataStore.cxx.

Friends And Related Symbol Documentation

◆ RooVectorDataStore

friend class RooVectorDataStore
friend

Definition at line 143 of file RooTreeDataStore.h.

Member Data Documentation

◆ _attachedBuffers

RooArgSet RooTreeDataStore::_attachedBuffers
private

! Currently attached buffers (if different from _varsww)

Definition at line 179 of file RooTreeDataStore.h.

◆ _cacheOwner

const RooAbsArg* RooTreeDataStore::_cacheOwner = nullptr
private

TTree holding the cached function values.

Definition at line 162 of file RooTreeDataStore.h.

◆ _cacheTree

TTree* RooTreeDataStore::_cacheTree = nullptr
private

Definition at line 161 of file RooTreeDataStore.h.

◆ _curWgt

double RooTreeDataStore::_curWgt = 1.0
mutableprivate

Buffer for weights in case a batch of values is requested.

Weight of current event

Definition at line 174 of file RooTreeDataStore.h.

◆ _curWgtErr

double RooTreeDataStore::_curWgtErr = 0.0
mutableprivate

Weight of current event.

Definition at line 177 of file RooTreeDataStore.h.

◆ _curWgtErrHi

double RooTreeDataStore::_curWgtErrHi = 0.0
mutableprivate

Weight of current event.

Definition at line 176 of file RooTreeDataStore.h.

◆ _curWgtErrLo

double RooTreeDataStore::_curWgtErrLo = 0.0
mutableprivate

Weight of current event.

Definition at line 175 of file RooTreeDataStore.h.

◆ _defCtor

bool RooTreeDataStore::_defCtor = false
mutableprivate

Object owning cache contents.

Definition at line 163 of file RooTreeDataStore.h.

◆ _defTreeBufSize

Int_t RooTreeDataStore::_defTreeBufSize = 10*1024*1024
staticprivate

Definition at line 157 of file RooTreeDataStore.h.

◆ _extSumW2Array

const double* RooTreeDataStore::_extSumW2Array {nullptr}
private

! External sum of weights array

Definition at line 171 of file RooTreeDataStore.h.

◆ _extWgtArray

const double* RooTreeDataStore::_extWgtArray {nullptr}
private

! External weight array

Definition at line 168 of file RooTreeDataStore.h.

◆ _extWgtErrHiArray

const double* RooTreeDataStore::_extWgtErrHiArray {nullptr}
private

! External weight array - high error

Definition at line 170 of file RooTreeDataStore.h.

◆ _extWgtErrLoArray

const double* RooTreeDataStore::_extWgtErrLoArray {nullptr}
private

! External weight array - low error

Definition at line 169 of file RooTreeDataStore.h.

◆ _tree

TTree* RooTreeDataStore::_tree = nullptr
private

Definition at line 160 of file RooTreeDataStore.h.

◆ _varsww

RooArgSet RooTreeDataStore::_varsww
private

Was object constructed with default ctor?

Definition at line 165 of file RooTreeDataStore.h.

◆ _weightBuffer

std::unique_ptr<std::vector<double> > RooTreeDataStore::_weightBuffer
mutableprivate

Definition at line 172 of file RooTreeDataStore.h.

◆ _wgtVar

RooRealVar* RooTreeDataStore::_wgtVar = nullptr
private

Definition at line 166 of file RooTreeDataStore.h.

Libraries for RooTreeDataStore:

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