RooDataSet is a container class to hold unbinned data.
The binned equivalent is RooDataHist. In RooDataSet, each data point in N-dimensional space is represented by a RooArgSet of RooRealVar, RooCategory or RooStringVar objects, which can be retrieved using get().
Since RooDataSet saves every event, it allows for fits with highest precision. With a large amount of data, however, it could be beneficial to represent them in binned form, i.e., RooDataHist. Binning the data will incur a loss of information, though. RooDataHist on the other hand may suffer from the curse of dimensionality if a high-dimensional problem with a lot of bins on each axis is tackled.
Inspect a dataset using Print() with the "verbose" option:
See RooAbsData::plotOn().
There are two storage backends:
For the inverse conversion, see RooAbsData::convertToVectorStore()
.
RooAbsData::uniqueId()
.
Some member functions of RooDataSet that take a RooCmdArg as argument also support keyword arguments. So far, this applies to RooDataSet() constructor and RooDataSet::plotOnXY. For example, the following code is equivalent in PyROOT:
Definition at line 57 of file RooDataSet.h.
Public Member Functions | |
RooDataSet () | |
Default constructor for persistence. | |
RooDataSet (RooDataSet const &other, const char *newname=nullptr) | |
Copy constructor. | |
RooDataSet (RooStringView name, RooStringView title, const RooArgSet &vars, const char *wgtVarName) | |
Constructor of an empty data set from a RooArgSet defining the dimensions of the data space. | |
RooDataSet (RooStringView name, RooStringView title, const RooArgSet &vars, const RooCmdArg &arg1={}, const RooCmdArg &arg2={}, const RooCmdArg &arg3={}, const RooCmdArg &arg4={}, const RooCmdArg &arg5={}, const RooCmdArg &arg6={}, const RooCmdArg &arg7={}, const RooCmdArg &arg8={}) | |
Construct an unbinned dataset from a RooArgSet defining the dimensions of the data space. | |
RooDataSet (RooStringView name, RooStringView title, RooDataSet *data, const RooArgSet &vars, const char *cuts=nullptr, const char *wgtVarName=nullptr) | |
Constructor of a data set from (part of) an existing data set. | |
RooDataSet (RooStringView name, RooStringView title, RooDataSet *data, const RooArgSet &vars, const RooFormulaVar &cutVar, const char *wgtVarName=nullptr) | |
Constructor of a data set from (part of) an existing data set. | |
RooDataSet (RooStringView name, RooStringView title, TTree *tree, const RooArgSet &vars, const char *cuts=nullptr, const char *wgtVarName=nullptr) | |
Constructor of a data set from (part of) a ROOT TTree. | |
RooDataSet (RooStringView name, RooStringView title, TTree *tree, const RooArgSet &vars, const RooFormulaVar &cutVar, const char *wgtVarName=nullptr) | |
Constructor of a data set from (part of) an ROOT TTree. | |
~RooDataSet () override | |
Destructor. | |
void | add (const RooArgSet &row, double weight, double weightError) |
Add one ore more rows of data. | |
virtual void | add (const RooArgSet &row, double weight, double weightErrorLo, double weightErrorHi) |
Add a data point, with its coordinates specified in the 'data' argset, to the data set. | |
void | add (const RooArgSet &row, double weight=1.0) override |
virtual RooAbsArg * | addColumn (RooAbsArg &var, bool adjustRange=true) |
Add a column with the values of the given (function) argument to this dataset. | |
virtual RooArgSet * | addColumns (const RooArgList &varList) |
Add a column with the values of the given list of (function) argument to this dataset. | |
virtual void | addFast (const RooArgSet &row, double weight=1.0, double weightError=0.0) |
Add a data point, with its coordinates specified in the 'data' argset, to the data set. | |
void | append (RooDataSet &data) |
Add all data points of given data set to this data set. | |
RooFit::OwningPtr< RooDataHist > | binnedClone (const char *newName=nullptr, const char *newTitle=nullptr) const |
Return binned clone of this dataset. | |
TObject * | Clone (const char *newname="") const override |
Make a clone of an object using the Streamer facility. | |
void | convertToTreeStore () override |
Convert vector-based storage to tree-based storage. | |
RooFit::OwningPtr< RooAbsData > | emptyClone (const char *newName=nullptr, const char *newTitle=nullptr, const RooArgSet *vars=nullptr, const char *wgtVarName=nullptr) const override |
Return an empty clone of this dataset. | |
const RooArgSet * | get () const override |
Return a RooArgSet with the coordinates of the current event. | |
const RooArgSet * | get (Int_t index) const override |
Return RooArgSet with coordinates of event 'index'. | |
std::span< const double > | getWeightBatch (std::size_t first, std::size_t len, bool sumW2) const override |
TClass * | IsA () const override |
bool | isNonPoissonWeighted () const override |
Returns true if histogram contains bins with entries with a non-integer weight. | |
bool | isWeighted () const override |
Return true if dataset contains weighted events. | |
bool | merge (RooDataSet *data1, RooDataSet *data2=nullptr, RooDataSet *data3=nullptr, RooDataSet *data4=nullptr, RooDataSet *data5=nullptr, RooDataSet *data6=nullptr) |
bool | merge (std::list< RooDataSet * > dsetList) |
Merge columns of supplied data set(s) with this data set. | |
virtual RooPlot * | plotOnXY (RooPlot *frame, const RooCmdArg &arg1={}, const RooCmdArg &arg2={}, const RooCmdArg &arg3={}, const RooCmdArg &arg4={}, const RooCmdArg &arg5={}, const RooCmdArg &arg6={}, const RooCmdArg &arg7={}, const RooCmdArg &arg8={}) const |
Special plot method for 'X-Y' datasets used in \( \chi^2 \) fitting. | |
void | printArgs (std::ostream &os) const override |
Print argument of dataset, i.e. the observable names. | |
void | printMultiline (std::ostream &os, Int_t contents, bool verbose=false, TString indent="") const override |
Print info about this dataset to the specified output stream. | |
void | printValue (std::ostream &os) const override |
Print value of the dataset, i.e. the sum of weights contained in the dataset. | |
void | SetName (const char *name) override |
Change the name of this dataset into the given name. | |
void | SetNameTitle (const char *name, const char *title) override |
Change the title of this dataset into the given name. | |
void | Streamer (TBuffer &) override |
Stream an object of class RooDataSet. | |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
double | sumEntries () const override |
Return effective number of entries in dataset, i.e., sum all weights. | |
double | sumEntries (const char *cutSpec, const char *cutRange=nullptr) const override |
Return the sum of weights in all entries matching cutSpec (if specified) and in named range cutRange (if specified) | |
double | weight () const override |
Return event weight of current event. | |
void | weightError (double &lo, double &hi, ErrorType etype=SumW2) const override |
Return the asymmetric errors on the current weight. | |
double | weightError (ErrorType etype=SumW2) const override |
double | weightSquared () const override |
Return squared event weight of the current event. | |
RooRealVar * | weightVar () const |
Returns a pointer to the weight variable (if set). | |
bool | write (const char *filename) const |
Write the contents of this dataset to an ASCII file with the specified name. | |
bool | write (std::ostream &ofs) const |
Write the contents of this dataset to the stream. | |
Public Member Functions inherited from RooAbsData | |
RooAbsData () | |
Default constructor. | |
RooAbsData (const RooAbsData &other, const char *newname=nullptr) | |
Copy constructor. | |
RooAbsData (RooStringView name, RooStringView title, const RooArgSet &vars, RooAbsDataStore *store=nullptr) | |
Constructor from a set of variables. | |
~RooAbsData () override | |
Destructor. | |
void | addOwnedComponent (const char *idxlabel, RooAbsData &data) |
void | attachBuffers (const RooArgSet &extObs) |
bool | canSplitFast () const |
virtual bool | changeObservableName (const char *from, const char *to) |
void | checkInit () const |
void | convertToVectorStore () |
Convert tree-based storage to vector-based storage. | |
double | correlation (RooRealVar &x, RooRealVar &y, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
RooFit::OwningPtr< TMatrixDSym > | correlationMatrix (const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
RooFit::OwningPtr< TMatrixDSym > | correlationMatrix (const RooArgList &vars, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
double | covariance (RooRealVar &x, RooRealVar &y, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
RooFit::OwningPtr< TMatrixDSym > | covarianceMatrix (const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
RooFit::OwningPtr< TMatrixDSym > | covarianceMatrix (const RooArgList &vars, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
TH1 * | createHistogram (const char *name, const RooAbsRealLValue &xvar, const RooCmdArg &arg1={}, const RooCmdArg &arg2={}, const RooCmdArg &arg3={}, const RooCmdArg &arg4={}, const RooCmdArg &arg5={}, const RooCmdArg &arg6={}, const RooCmdArg &arg7={}, const RooCmdArg &arg8={}) const |
Calls createHistogram(const char *name, const RooAbsRealLValue& xvar, const RooLinkedList& argList) const. | |
TH1 * | createHistogram (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. | |
TH1 * | createHistogram (const char *varNameList, const RooCmdArg &binArgX={}, const RooCmdArg &binArgY={}, const RooCmdArg &binArgZ={}) const |
Create and fill a ROOT histogram TH1,TH2 or TH3 with the values of this dataset for the variables with given names. | |
TH2F * | createHistogram (const RooAbsRealLValue &var1, const RooAbsRealLValue &var2, const char *cuts="", const char *name="hist") const |
Create a TH2F histogram of the distribution of the specified variable using this dataset. | |
TH2F * | createHistogram (const RooAbsRealLValue &var1, const RooAbsRealLValue &var2, int nx, int ny, const char *cuts="", const char *name="hist") const |
Create a TH2F histogram of the distribution of the specified variable using this dataset. | |
Int_t | defaultPrintContents (Option_t *opt) const override |
Define default print options, for a given print style. | |
void | Draw (Option_t *option="") override |
Forward draw command to data store. | |
virtual void | fill () |
virtual TH1 * | fillHistogram (TH1 *hist, const RooArgList &plotVars, const char *cuts="", const char *cutRange=nullptr) const |
Loop over columns of our tree data and fill the input histogram. | |
RealSpans | getBatches (std::size_t first=0, std::size_t len=std::numeric_limits< std::size_t >::max()) const |
Write information to retrieve data columns into evalData.spans . | |
CategorySpans | getCategoryBatches (std::size_t first=0, std::size_t len=std::numeric_limits< std::size_t >::max()) const |
TTree * | GetClonedTree () const |
Return a clone of the TTree which stores the data or create such a tree if vector storage is used. | |
RooArgSet const * | getGlobalObservables () const |
Returns snapshot of global observables stored in this data. | |
bool | getRange (const RooAbsRealLValue &var, double &lowest, double &highest, double marginFrac=0.0, bool symMode=false) const |
Fill Doubles 'lowest' and 'highest' with the lowest and highest value of observable 'var' in this dataset. | |
RooAbsData * | getSimData (const char *idxstate) |
bool | hasFilledCache () const |
double | kurtosis (const RooRealVar &var, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
double | mean (const RooRealVar &var, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
RooRealVar * | meanVar (const RooRealVar &var, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
Create a RooRealVar containing the mean of observable 'var' in this dataset. | |
double | moment (const RooRealVar &var, double order, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
Calculate moment of requested order. | |
double | moment (const RooRealVar &var, double order, double offset, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
Return the 'order'-ed moment of observable 'var' in this dataset. | |
const TNamed * | namePtr () const |
De-duplicated pointer to this object's name. | |
virtual Int_t | numEntries () const |
Return number of entries in dataset, i.e., count unweighted entries. | |
RooAbsData & | operator= (const RooAbsData &other) |
virtual RooPlot * | plotOn (RooPlot *frame, const RooCmdArg &arg1={}, const RooCmdArg &arg2={}, const RooCmdArg &arg3={}, const RooCmdArg &arg4={}, const RooCmdArg &arg5={}, const RooCmdArg &arg6={}, const RooCmdArg &arg7={}, const RooCmdArg &arg8={}) const |
virtual RooPlot * | plotOn (RooPlot *frame, const RooLinkedList &cmdList) const |
Plot dataset on specified frame. | |
void | Print (Option_t *options=nullptr) const override |
This method must be overridden when a class wants to print itself. | |
void | printClassName (std::ostream &os) const override |
Print class name of dataset. | |
void | printName (std::ostream &os) const override |
Print name of dataset. | |
void | printTitle (std::ostream &os) const override |
Print title of dataset. | |
void | RecursiveRemove (TObject *obj) override |
If one of the TObject we have a referenced to is deleted, remove the reference. | |
RooFit::OwningPtr< RooAbsData > | reduce (const char *cut) |
Create a subset of the data set by applying the given cut on the data points. | |
RooFit::OwningPtr< RooAbsData > | reduce (const RooArgSet &varSubset, const char *cut=nullptr) |
Create a subset of the data set by applying the given cut on the data points and reducing the dimensions to the specified set. | |
RooFit::OwningPtr< 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. | |
RooFit::OwningPtr< RooAbsData > | reduce (const RooCmdArg &arg1, const RooCmdArg &arg2={}, const RooCmdArg &arg3={}, const RooCmdArg &arg4={}, const RooCmdArg &arg5={}, const RooCmdArg &arg6={}, const RooCmdArg &arg7={}, const RooCmdArg &arg8={}) |
Create a reduced copy of this dataset. | |
RooFit::OwningPtr< RooAbsData > | reduce (const RooFormulaVar &cutVar) |
Create a subset of the data set by applying the given cut on the data points. | |
virtual void | reset () |
void | resetBuffers () |
RooRealVar * | rmsVar (const RooRealVar &var, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
Create a RooRealVar containing the RMS of observable 'var' in this dataset. | |
void | setDirtyProp (bool flag) |
Control propagation of dirty flags from observables in dataset. | |
void | setGlobalObservables (RooArgSet const &globalObservables) |
Sets the global observables stored in this data. | |
double | sigma (const RooRealVar &var, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
double | skewness (const RooRealVar &var, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
virtual RooFit::OwningPtr< TList > | split (const RooAbsCategory &splitCat, bool createEmptyDataSets=false) const |
Split the dataset into subsets based on states of a categorical variable in this dataset. | |
virtual RooFit::OwningPtr< TList > | split (const RooSimultaneous &simpdf, bool createEmptyDataSets=false) const |
Split the dataset into subsets based on the channels of a RooSimultaneous. | |
double | standMoment (const RooRealVar &var, double order, const char *cutSpec=nullptr, const char *cutRange=nullptr) const |
Calculate standardized moment. | |
virtual RooPlot * | statOn (RooPlot *frame, const char *what, const char *label="", Int_t sigDigits=2, Option_t *options="NELU", double xmin=0.15, double xmax=0.65, double ymax=0.85, const char *cutSpec=nullptr, const char *cutRange=nullptr, const RooCmdArg *formatCmd=nullptr) |
Implementation back-end of statOn() method with named arguments. | |
virtual RooPlot * | statOn (RooPlot *frame, const RooCmdArg &arg1={}, const RooCmdArg &arg2={}, const RooCmdArg &arg3={}, const RooCmdArg &arg4={}, const RooCmdArg &arg5={}, const RooCmdArg &arg6={}, const RooCmdArg &arg7={}, const RooCmdArg &arg8={}) |
Add a box with statistics information to the specified frame. | |
RooAbsDataStore * | store () |
const RooAbsDataStore * | store () const |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
double | sumEntriesW2 () const |
Return sum of squared weights of this data. | |
virtual Roo1DTable * | table (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. | |
virtual Roo1DTable * | table (const RooArgSet &catSet, const char *cuts="", const char *opts="") const |
Construct table for product of categories in catSet. | |
const TTree * | tree () const |
Return a pointer to the TTree which stores the data. | |
RooFit::UniqueId< RooAbsData > const & | uniqueId () const |
Returns a unique ID that is different for every instantiated RooAbsData object. | |
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 (""). | |
TObject * | Clone (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. | |
TClass * | IsA () const override |
Bool_t | IsSortable () const override |
void | ls (Option_t *option="") const override |
List TNamed name and title. | |
TNamed & | operator= (const TNamed &rhs) |
TNamed assignment operator. | |
void | Print (Option_t *option="") const override |
Print TNamed 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 TObject * | DrawClone (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 TObject * | FindObject (const char *name) const |
Must be redefined in derived classes. | |
virtual TObject * | FindObject (const TObject *obj) const |
Must be redefined in derived classes. | |
virtual Option_t * | GetDrawOption () 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_t * | GetOption () 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) |
TObject & | operator= (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. | |
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) |
Public Member Functions inherited from RooDirItem | |
RooDirItem () | |
RooDirItem (const RooDirItem &) | |
virtual | ~RooDirItem () |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
Static Public Member Functions | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static void | cleanup () |
static const char * | DeclFileName () |
static RooDataSet * | read (const char *filename, const RooArgList &variables, const char *opts="", const char *commonPath="", const char *indexCatName=nullptr) |
Read data from a text file and create a dataset from it. | |
Static Public Member Functions inherited from RooAbsData | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
static StorageType | getDefaultStorageType () |
static void | setDefaultStorageType (StorageType s) |
Static Public Member Functions inherited from TNamed | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
Static Public Member Functions inherited from TObject | |
static TClass * | Class () |
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 TClass * | Class () |
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. | |
Static Public Member Functions inherited from RooDirItem | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
Protected Member Functions | |
void | initialize (const char *wgtVarName) |
Initialize the dataset. | |
std::unique_ptr< RooAbsData > | reduceEng (const RooArgSet &varSubset, const RooFormulaVar *cutVar, const char *cutRange=nullptr, std::size_t nStart=0, std::size_t nStop=std::numeric_limits< std::size_t >::max()) override |
Implementation of RooAbsData virtual method that drives the RooAbsData::reduce() methods. | |
Protected Member Functions inherited from RooAbsData | |
bool | allClientsCached (RooAbsArg *, const RooArgSet &) |
Utility function that determines if all clients of object 'var' appear in given list of cached nodes. | |
virtual void | attachCache (const RooAbsArg *newOwner, const RooArgSet &cachedVars) |
Internal method – Attach dataset copied with cache contents to copied instances of functions. | |
virtual void | cacheArgs (const RooAbsArg *owner, RooArgSet &varSet, const RooArgSet *nset=nullptr, bool skipZeroWeights=false) |
Internal method – Cache given set of functions with data. | |
double | corrcov (const RooRealVar &x, const RooRealVar &y, const char *cutSpec, const char *cutRange, bool corr) const |
Internal method to calculate single correlation and covariance elements. | |
RooFit::OwningPtr< TMatrixDSym > | corrcovMatrix (const RooArgList &vars, const char *cutSpec, const char *cutRange, bool corr) const |
Return covariance matrix from data for given list of observables. | |
RooRealVar * | dataRealVar (const char *methodname, const RooRealVar &extVar) const |
Internal method to check if given RooRealVar maps to a RooRealVar in this dataset. | |
void | initializeVars (RooArgSet const &vars) |
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'. | |
virtual RooPlot * | plotAsymOn (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. | |
virtual RooPlot * | plotEffOn (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. | |
virtual RooPlot * | plotOn (RooPlot *frame, PlotOpt o) const |
Create and fill a histogram of the frame's variable and append it to the frame. | |
virtual void | resetCache () |
Internal method – Remove cached function values. | |
virtual void | setArgStatus (const RooArgSet &set, bool active) |
Protected Member Functions inherited from TObject | |
virtual void | DoError (int level, const char *location, const char *fmt, va_list va) const |
Interface to ErrorHandler (protected). | |
void | MakeZombie () |
Protected Member Functions inherited from RooDirItem | |
void | appendToDir (TObject *obj, bool forceMemoryResident=false) |
Append object to directory. | |
void | removeFromDir (TObject *obj) |
Remove object from directory it was added to. | |
Protected Attributes | |
RooArgSet | _varsNoWgt |
Vars without weight variable. | |
RooRealVar * | _wgtVar = nullptr |
Pointer to weight variable (if set) | |
Protected Attributes inherited from RooAbsData | |
RooArgSet | _cachedVars |
! External variables cached with this data set | |
std::unique_ptr< RooAbsDataStore > | _dstore |
Data storage implementation. | |
std::unique_ptr< RooArgSet > | _globalObservables |
Snapshot of global observables. | |
const TNamed * | _namePtr = nullptr |
! De-duplicated name pointer. This will be equal for all objects with the same name. | |
std::map< std::string, RooAbsData * > | _ownedComponents |
Owned external components. | |
RooArgSet | _vars |
Dimensions of this data set. | |
StorageType | storageType |
Protected Attributes inherited from TNamed | |
TString | fName |
TString | fTitle |
Protected Attributes inherited from RooDirItem | |
TDirectory * | _dir {nullptr} |
! Associated directory | |
Private Member Functions | |
void | loadValuesFromSlices (RooCategory &indexCat, std::map< std::string, RooAbsData * > const &slices, const char *rangeName, RooFormulaVar const *cutVar, const char *cutSpec) |
Private Attributes | |
bool | _doWeightErrorCheck {true} |
! When adding events with weights, check that weights can actually be stored. | |
unsigned short | _errorMsgCount {0} |
! Counter to silence error messages when filling dataset. | |
std::unique_ptr< std::vector< double > > | _sumW2Buffer |
! Buffer for sumW2 in case a batch of values is requested. | |
Friends | |
class | RooProdGenContext |
Additional Inherited Members | |
Public Types inherited from RooAbsData | |
using | CategorySpans = std::map< RooFit::Detail::DataKey, std::span< const RooAbsCategory::value_type > > |
enum | ErrorType { Poisson , SumW2 , None , Auto , Expected } |
using | RealSpans = std::map< RooFit::Detail::DataKey, std::span< const double > > |
enum | StorageType { Tree , Vector , Composite } |
Public Types inherited from TObject | |
enum | { kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 , kBitMask = 0x00ffffff } |
enum | { kSingleKey = (1ULL << ( 0 )) , kOverwrite = (1ULL << ( 1 )) , kWriteDelete = (1ULL << ( 2 )) } |
enum | EDeprecatedStatusBits { kObjInCanvas = (1ULL << ( 3 )) } |
enum | EStatusBits { kCanDelete = (1ULL << ( 0 )) , kMustCleanup = (1ULL << ( 3 )) , kIsReferenced = (1ULL << ( 4 )) , kHasUUID = (1ULL << ( 5 )) , kCannotPick = (1ULL << ( 6 )) , kNoContextMenu = (1ULL << ( 8 )) , kInvalidObject = (1ULL << ( 13 )) } |
Public Types inherited from RooPrintable | |
enum | ContentsOption { kName =1 , kClassName =2 , kValue =4 , kArgs =8 , kExtras =16 , kAddress =32 , kTitle =64 , kCollectionHeader =128 } |
enum | StyleOption { kInline =1 , kSingleLine =2 , kStandard =3 , kVerbose =4 , kTreeStructure =5 } |
Protected Types inherited from TObject | |
enum | { kOnlyPrepStep = (1ULL << ( 3 )) } |
Static Protected Attributes inherited from RooAbsData | |
static StorageType | defaultStorageType =RooAbsData::Vector |
Static Protected Attributes inherited from RooPrintable | |
static Int_t | _nameLength |
#include <RooDataSet.h>
RooDataSet::RooDataSet | ( | ) |
Default constructor for persistence.
Definition at line 184 of file RooDataSet.cxx.
RooDataSet::RooDataSet | ( | RooStringView | name, |
RooStringView | title, | ||
const RooArgSet & | vars, | ||
const char * | wgtVarName | ||
) |
Constructor of an empty data set from a RooArgSet defining the dimensions of the data space.
RooDataSet(name, title, vars, RooFit::WeightVar(wgtVarName))
. Definition at line 585 of file RooDataSet.cxx.
RooDataSet::RooDataSet | ( | RooStringView | name, |
RooStringView | title, | ||
const RooArgSet & | vars, | ||
const RooCmdArg & | arg1 = {} , |
||
const RooCmdArg & | arg2 = {} , |
||
const RooCmdArg & | arg3 = {} , |
||
const RooCmdArg & | arg4 = {} , |
||
const RooCmdArg & | arg5 = {} , |
||
const RooCmdArg & | arg6 = {} , |
||
const RooCmdArg & | arg7 = {} , |
||
const RooCmdArg & | arg8 = {} |
||
) |
Construct an unbinned dataset from a RooArgSet defining the dimensions of the data space.
Optionally, data can be imported at the time of construction.
RooCmdArg | Effect |
---|---|
Import(TTree*) | Import contents of given TTree. Only branches of the TTree that have names corresponding to those of the RooAbsArgs that define the RooDataSet are imported. |
ImportFromFile(const char* fileName, const char* treeName) | Import tree with given name from file with given name. |
Import(RooAbsData&) | Import contents of given RooDataSet or RooDataHist. Only observables that are common with the definition of this dataset will be imported |
Index(RooCategory&) | Prepare import of datasets into a N+1 dimensional RooDataSet where the extra discrete dimension labels the source of the imported histogram. |
Import(const char*, RooAbsData&) | Import a RooDataSet or RooDataHist to be associated with the given state name of the index category specified in Index(). If the given state name is not yet defined in the index category it will be added on the fly. The import command can be specified multiple times. |
Link(const char*, RooDataSet&) | Link contents of supplied RooDataSet to this dataset for given index category state name. In this mode, no data is copied and the linked dataset must be remain live for the duration of this dataset. Note that link is active for both reading and writing, so modifications to the aggregate dataset will also modify its components. Link() and Import() are mutually exclusive. |
OwnLinked() | Take ownership of all linked datasets |
Import(std::map<string,RooAbsData*>&) | As above, but allows specification of many imports in a single operation |
Link(std::map<string,RooDataSet*>&) | As above, but allows specification of many links in a single operation |
Cut(const char*) Cut(RooFormulaVar&) | Apply the given cut specification when importing data |
CutRange(const char*) | Only accept events in the observable range with the given name |
WeightVar(const char*) WeightVar(const RooAbsArg&) | Interpret the given variable as event weight rather than as observable |
StoreError(const RooArgSet&) | Store symmetric error along with value for given subset of observables |
StoreAsymError(const RooArgSet&) | Store asymmetric error along with value for given subset of observables |
GlobalObservables(const RooArgSet&) | Define the set of global observables to be stored in this RooDataSet. A snapshot of the passed RooArgSet is stored, meaning the values wont't change unexpectedly. |
Definition at line 332 of file RooDataSet.cxx.
RooDataSet::RooDataSet | ( | RooStringView | name, |
RooStringView | title, | ||
RooDataSet * | dset, | ||
const RooArgSet & | vars, | ||
const char * | cuts = nullptr , |
||
const char * | wgtVarName = nullptr |
||
) |
Constructor of a data set from (part of) an existing data set.
The dimensions of the data set are defined by the 'vars' RooArgSet, which can be identical to 'dset' dimensions, or a subset thereof. The 'cuts' string is an optional RooFormula expression and can be used to select the subset of the data points in 'dset' to be copied. The cut expression can refer to any variable in the source dataset. For cuts involving variables other than those contained in the source data set, such as intermediate formula objects, use the equivalent constructor accepting RooFormulaVar reference as cut specification.
For most uses the RooAbsData::reduce() wrapper function, which uses this constructor, is the most convenient way to create a subset of an existing data
Definition at line 607 of file RooDataSet.cxx.
RooDataSet::RooDataSet | ( | RooStringView | name, |
RooStringView | title, | ||
RooDataSet * | dset, | ||
const RooArgSet & | vars, | ||
const RooFormulaVar & | cutVar, | ||
const char * | wgtVarName = nullptr |
||
) |
Constructor of a data set from (part of) an existing data set.
The dimensions of the data set are defined by the 'vars' RooArgSet, which can be identical to 'dset' dimensions, or a subset thereof. The 'cutVar' formula variable is used to select the subset of data points to be copied. For subsets without selection on the data points, or involving cuts operating exclusively and directly on the data set dimensions, the equivalent constructor with a string based cut expression is recommended.
For most uses the RooAbsData::reduce() wrapper function, which uses this constructor, is the most convenient way to create a subset of an existing data
Definition at line 662 of file RooDataSet.cxx.
RooDataSet::RooDataSet | ( | RooStringView | name, |
RooStringView | title, | ||
TTree * | theTree, | ||
const RooArgSet & | vars, | ||
const char * | cuts = nullptr , |
||
const char * | wgtVarName = nullptr |
||
) |
Constructor of a data set from (part of) a ROOT TTree.
[in] | name | Name of this dataset. |
[in] | title | Title for e.g. plotting. |
[in] | theTree | Tree to be imported. |
[in] | vars | Defines the columns of the data set. For each dimension specified, the TTree must have a branch with the same name. For category branches, this branch should contain the numeric index value. Real dimensions can be constructed from either 'double' or 'Float_t' tree branches. In the latter case, an automatic conversion is applied. |
[in] | cuts | Optional RooFormula expression to select the subset of the data points to be imported. The cut expression can refer to any variable in vars . |
vars
. Passing e.g. x
from the tree, but leave y
at an undefined value. If other expressions are needed, such as intermediate formula objects, use RooDataSet::RooDataSet(const char*,const char*,TTree*,const RooArgSet&,const RooFormulaVar&,const char*) [in] | wgtVarName | Name of the variable in vars that represents an event weight. |
Definition at line 710 of file RooDataSet.cxx.
RooDataSet::RooDataSet | ( | RooStringView | name, |
RooStringView | title, | ||
TTree * | theTree, | ||
const RooArgSet & | vars, | ||
const RooFormulaVar & | cutVar, | ||
const char * | wgtVarName = nullptr |
||
) |
Constructor of a data set from (part of) an ROOT TTree.
The dimensions of the data set are defined by the 'vars' RooArgSet. For each dimension specified, the TTree must have a branch with the same name. For category branches, this branch should contain the numeric index value. Real dimensions can be constructed from either 'double' or 'Float_t' tree branches. In the latter case, an automatic conversion is applied.
The 'cutVar' formula variable is used to select the subset of data points to be copied. For subsets without selection on the data points, or involving cuts operating exclusively and directly on the data set dimensions, the equivalent constructor with a string based cut expression is recommended.
Definition at line 682 of file RooDataSet.cxx.
RooDataSet::RooDataSet | ( | RooDataSet const & | other, |
const char * | newname = nullptr |
||
) |
Copy constructor.
Definition at line 736 of file RooDataSet.cxx.
|
override |
Destructor.
Definition at line 859 of file RooDataSet.cxx.
Add one ore more rows of data.
Add a data point, with its coordinates specified in the 'data' argset, to the data set.
Any variables present in 'data' but not in the dataset will be silently ignored.
[in] | data | Data point. |
[in] | wgt | Event weight. Defaults to 1. The current value of the weight variable is ignored. |
WeightVar
in the constructor. [in] | wgtError | Optional weight error. |
StoreError
variables when constructing the dataset. Definition at line 1069 of file RooDataSet.cxx.
|
virtual |
Add a data point, with its coordinates specified in the 'data' argset, to the data set.
Any variables present in 'data' but not in the dataset will be silently ignored.
[in] | indata | Data point. |
[in] | inweight | Event weight. The current value of the weight variable is ignored. |
WeightVar
in the constructor. [in] | weightErrorLo | Asymmetric weight error. |
[in] | weightErrorHi | Asymmetric weight error. |
StoreAsymError
variables when constructing the dataset. Definition at line 1121 of file RooDataSet.cxx.
Implements RooAbsData.
Definition at line 136 of file RooDataSet.h.
Add a column with the values of the given (function) argument to this dataset.
The function value is calculated for each event using the observable values of each event in case the function depends on variables with names that are identical to the observable names in the dataset
Definition at line 1287 of file RooDataSet.cxx.
|
virtual |
Add a column with the values of the given list of (function) argument to this dataset.
Each function value is calculated for each event using the observable values of the event in case the function depends on variables with names that are identical to the observable names in the dataset
Definition at line 1305 of file RooDataSet.cxx.
|
virtual |
Add a data point, with its coordinates specified in the 'data' argset, to the data set.
[in] | data | Data point. |
[in] | wgt | Event weight. Defaults to 1. The current value of the weight variable is ignored. |
WeightVar
in the constructor. [in] | wgtError | Optional weight error. |
StoreError
variables when constructing the dataset. Definition at line 1171 of file RooDataSet.cxx.
void RooDataSet::append | ( | RooDataSet & | data | ) |
Add all data points of given data set to this data set.
Observable in 'data' that are not in this dataset with not be transferred
Definition at line 1272 of file RooDataSet.cxx.
RooFit::OwningPtr< RooDataHist > RooDataSet::binnedClone | ( | const char * | newName = nullptr , |
const char * | newTitle = nullptr |
||
) | const |
Return binned clone of this dataset.
Definition at line 870 of file RooDataSet.cxx.
|
static |
|
inlinestaticconstexpr |
Definition at line 187 of file RooDataSet.h.
|
static |
Definition at line 125 of file RooDataSet.cxx.
|
inlineoverridevirtual |
Make a clone of an object using the Streamer facility.
If the object derives from TNamed, this function is called by TNamed::Clone. TNamed::Clone uses the optional argument to set a new name to the newly created object.
If the object class has a DirectoryAutoAdd function, it will be called at the end of the function with the parameter gDirectory. This usually means that the object will be appended to the current ROOT directory.
Reimplemented from TObject.
Definition at line 91 of file RooDataSet.h.
|
overridevirtual |
Convert vector-based storage to tree-based storage.
This implementation overrides the base class implementation because the latter doesn't transfer weights.
Reimplemented from RooAbsData.
Definition at line 1855 of file RooDataSet.cxx.
|
inlinestatic |
Definition at line 187 of file RooDataSet.h.
|
overridevirtual |
Return an empty clone of this dataset.
If vars is not null, only the variables in vars are added to the definition of the empty clone
Implements RooAbsData.
Definition at line 749 of file RooDataSet.cxx.
|
overridevirtual |
Return a RooArgSet with the coordinates of the current event.
Reimplemented from RooAbsData.
Definition at line 1051 of file RooDataSet.cxx.
Return RooArgSet with coordinates of event 'index'.
Reimplemented from RooAbsData.
Definition at line 969 of file RooDataSet.cxx.
|
overridevirtual |
Implements RooAbsData.
Definition at line 917 of file RooDataSet.cxx.
|
protected |
Initialize the dataset.
If wgtVarName is not null, interpret the observable with that name as event weight
Definition at line 791 of file RooDataSet.cxx.
|
inlineoverridevirtual |
Reimplemented from RooAbsData.
Definition at line 187 of file RooDataSet.h.
|
overridevirtual |
Returns true if histogram contains bins with entries with a non-integer weight.
Reimplemented from RooAbsData.
Definition at line 1029 of file RooDataSet.cxx.
|
overridevirtual |
Return true if dataset contains weighted events.
Reimplemented from RooAbsData.
Definition at line 1019 of file RooDataSet.cxx.
|
private |
Definition at line 1879 of file RooDataSet.cxx.
bool RooDataSet::merge | ( | RooDataSet * | data1, |
RooDataSet * | data2 = nullptr , |
||
RooDataSet * | data3 = nullptr , |
||
RooDataSet * | data4 = nullptr , |
||
RooDataSet * | data5 = nullptr , |
||
RooDataSet * | data6 = nullptr |
||
) |
Definition at line 1213 of file RooDataSet.cxx.
bool RooDataSet::merge | ( | std::list< RooDataSet * > | dsetList | ) |
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
Definition at line 1235 of file RooDataSet.cxx.
|
virtual |
Special plot method for 'X-Y' datasets used in \( \chi^2 \) fitting.
For general plotting, see RooAbsData::plotOn().
These datasets have one observable (X) and have weights (Y) and associated errors.
Contents options | Effect |
---|---|
YVar(RooRealVar& var) | Designate specified observable as 'y' variable If not specified, the event weight will be the y variable |
Histogram drawing options | Effect |
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 size) | Select the ROOT marker size |
Rescale(double factor) | Apply global rescaling factor to histogram |
Misc. other options | Effect |
Name(const chat* name) | Give curve specified name in frame. Useful if curve is to be referenced later |
Invisible(bool flag) | Add curve to frame, but do not display. Useful in combination AddTo() |
The RooDataSet::plotOnXY() function is pythonized with the command argument pythonization. The keywords must correspond to the CmdArgs of the function.
Definition at line 1342 of file RooDataSet.cxx.
|
overridevirtual |
Print argument of dataset, i.e. the observable names.
Reimplemented from RooPrintable.
Definition at line 1756 of file RooDataSet.cxx.
|
overridevirtual |
Print info about this dataset to the specified output stream.
Standard: number of entries Shape: list of variables we define & were generated with
Reimplemented from RooAbsData.
Definition at line 1730 of file RooDataSet.cxx.
|
overridevirtual |
Print value of the dataset, i.e. the sum of weights contained in the dataset.
Reimplemented from RooPrintable.
Definition at line 1743 of file RooDataSet.cxx.
|
static |
Read data from a text file and create a dataset from it.
Read given list of ascii files, and construct a data set, using the given ArgList as structure definition.
The possible options are: (D)ebug, (Q)uiet.
fileList | Multiple file names, comma separated. Each file is optionally prefixed with 'commonPath' if such a path is provided |
varList | Specify the dimensions of the dataset to be built. This list describes the order in which these dimensions appear in the ascii files to be read. Each line in the ascii file should contain N white-space separated tokens, with N the number of args in varList . Any text beyond N tokens will be ignored with a warning message. (NB: This is the default output of RooArgList::writeToStream()) |
verbOpt | Q be quiet, D debug mode (verbose) |
commonPath | All filenames in fileList will be prefixed with this optional path. |
indexCatName | Interpret the data as belonging to category indexCatName . When multiple files are read, a RooCategory arg in varList can optionally be designated to hold information about the source file of each data point. This feature is enabled by giving the name of the (already existing) category variable in indexCatName . |
Q
verbose option is given. The number of events read and skipped is always summarized at the end.If no further information is given a label name 'fileNNN' will be assigned to each event, where NNN is the sequential number of the source file in fileList
.
Alternatively, it is possible to override the default label names of the index category by specifying them in the fileList string: When instead of file1.txt,file2.txt
the string file1.txt:FOO,file2.txt:BAR
is specified, a state named "FOO" is assigned to the index category for each event originating from file1.txt. The labels FOO,BAR may be predefined in the index category via defineType(), but don't have to be.
Finally, one can also assign the same label to multiple files, either by specifying file1.txt:FOO,file2,txt:FOO,file3.txt:BAR
or file1.txt,file2.txt:FOO,file3.txt:BAR
.
Definition at line 1504 of file RooDataSet.cxx.
|
overrideprotectedvirtual |
Implementation of RooAbsData virtual method that drives the RooAbsData::reduce() methods.
Implements RooAbsData.
Definition at line 818 of file RooDataSet.cxx.
|
overridevirtual |
Change the name of this dataset into the given name.
Reimplemented from RooAbsData.
Definition at line 1779 of file RooDataSet.cxx.
|
overridevirtual |
Change the title of this dataset into the given name.
Reimplemented from RooAbsData.
Definition at line 1791 of file RooDataSet.cxx.
|
overridevirtual |
Stream an object of class RooDataSet.
Reimplemented from RooAbsData.
Definition at line 1801 of file RooDataSet.cxx.
|
inline |
Definition at line 187 of file RooDataSet.h.
|
overridevirtual |
Return effective number of entries in dataset, i.e., sum all weights.
Implements RooAbsData.
Definition at line 978 of file RooDataSet.cxx.
|
overridevirtual |
Return the sum of weights in all entries matching cutSpec (if specified) and in named range cutRange (if specified)
Implements RooAbsData.
Definition at line 988 of file RooDataSet.cxx.
|
overridevirtual |
Return event weight of current event.
Implements RooAbsData.
Definition at line 893 of file RooDataSet.cxx.
|
overridevirtual |
Return the asymmetric errors on the current weight.
See also weightError(ErrorType) const for symmetric error.
[out] | lo | Low error. |
[out] | hi | High error. |
etype | error type |
Reimplemented from RooAbsData.
Definition at line 951 of file RooDataSet.cxx.
etype | error type |
Reimplemented from RooAbsData.
Definition at line 960 of file RooDataSet.cxx.
|
overridevirtual |
Return squared event weight of the current event.
If this RooDataSet has no weight errors set, this will be the same as weight() * weight()
, like expected for an unbinned dataset. When weight errors are set, it is assumed that the RooDataSet represents a weighted binned dataset and weightSquared() is the corresponding sum of weight squares for the bin.
Implements RooAbsData.
Definition at line 907 of file RooDataSet.cxx.
|
inline |
Returns a pointer to the weight variable (if set).
Definition at line 124 of file RooDataSet.h.
bool RooDataSet::write | ( | const char * | filename | ) | const |
Write the contents of this dataset to an ASCII file with the specified name.
Each event will be written as a single line containing the written values of each observable in the order they were declared in the dataset and separated by whitespaces
Definition at line 1689 of file RooDataSet.cxx.
bool RooDataSet::write | ( | std::ostream & | ofs | ) | const |
Write the contents of this dataset to the stream.
Each event will be written as a single line containing the written values of each observable in the order they were declared in the dataset and separated by whitespaces
Definition at line 1709 of file RooDataSet.cxx.
|
friend |
Definition at line 162 of file RooDataSet.h.
|
private |
! When adding events with weights, check that weights can actually be stored.
Definition at line 183 of file RooDataSet.h.
|
private |
! Counter to silence error messages when filling dataset.
Definition at line 182 of file RooDataSet.h.
|
mutableprivate |
! Buffer for sumW2 in case a batch of values is requested.
Definition at line 185 of file RooDataSet.h.
|
protected |
Vars without weight variable.
Definition at line 170 of file RooDataSet.h.
|
protected |
Pointer to weight variable (if set)
Definition at line 171 of file RooDataSet.h.