RooVectorDataStore uses std::vectors to store data columns.

Each of these vectors is associated to an instance of a RooAbsReal, whose values it represents. Those RooAbsReal are the observables of the dataset. In addition to the observables, a data column can be bound to a different instance of a RooAbsReal (e.g., the column "x" can be bound to the observable "x" of a computation graph using attachBuffers()). In this case, a get() operation writes the value of the requested column into the bound real.

As a faster alternative to loading values one-by-one, one can use the function getBatches(), which returns spans pointing directly to the data.

Definition at line 40 of file RooVectorDataStore.h.

Classes
class	ArraysStruct
	Output struct for the RooVectorDataStore::getArrays() helper function. More...

class	CatVector

class	RealFullVector

class	RealVector

Public Member Functions
	RooVectorDataStore ()

	RooVectorDataStore (const RooTreeDataStore &other, const RooArgSet &vars, const char *newname=0)

	RooVectorDataStore (const RooVectorDataStore &other, const char *newname=0)
	Regular copy ctor.

	RooVectorDataStore (const RooVectorDataStore &other, const RooArgSet &vars, const char *newname=0)
	Clone ctor, must connect internal storage to given new external set of vars.

	RooVectorDataStore (std::string_view name, std::string_view title, const RooArgSet &vars, const char *wgtVarName=0)

	RooVectorDataStore (std::string_view name, std::string_view title, RooAbsDataStore &tds, const RooArgSet &vars, const RooFormulaVar cutVar, const char cutRange, std::size_t nStart, std::size_t nStop, Bool_t, const char *wgtVarName=0)

virtual	~RooVectorDataStore ()
	Destructor.

virtual RooAbsArg *	addColumn (RooAbsArg &var, Bool_t adjustRange=kTRUE) override
	Add a new column to the data set which holds the pre-calculated values of 'newVar'.

virtual RooArgSet *	addColumns (const RooArgList &varList) override
	Utility function to add multiple columns in one call See addColumn() for details.

virtual void	append (RooAbsDataStore &other) override

virtual void	attachBuffers (const RooArgSet &extObs) override

virtual void	attachCache (const RooAbsArg *newOwner, const RooArgSet &cachedVars) override
	Initialize cache of dataset: attach variables of cache ArgSet to the corresponding TTree branches.

const RooVectorDataStore *	cache () const

virtual void	cacheArgs (const RooAbsArg owner, RooArgSet &varSet, const RooArgSet nset=0, Bool_t skipZeroWeights=kTRUE) override
	Cache given RooAbsArgs: 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.

virtual const RooAbsArg *	cacheOwner () override

std::vector< CatVector * > &	catStoreList ()

virtual Bool_t	changeObservableName (const char from, const char to) override

virtual RooAbsDataStore *	clone (const char *newname=0) const override

virtual RooAbsDataStore *	clone (const RooArgSet &vars, const char *newname=0) const override

void	dump () override

virtual Int_t	fill () override
	Interface function to TTree::Fill.

virtual const RooArgSet *	get () const

virtual const RooArgSet *	get (Int_t index) const override
	Load the n-th data point (n='index') into the variables of this dataset, and return a pointer to the RooArgSet that holds them.

virtual const RooArgSet *	get (Int_t index) const=0

RooAbsData::RealSpans	getBatches (std::size_t first, std::size_t len) const override
	Return batches of the data columns for the requested events.

RooAbsData::CategorySpans	getCategoryBatches (std::size_t, std::size_t len) const override

virtual const RooArgSet *	getNative (Int_t index) const
	Load the n-th data point (n='index') into the variables of this dataset, and return a pointer to the RooArgSet that holds them.

RooSpan< const double >	getWeightBatch (std::size_t first, std::size_t len) const override
	Return the weights of all events in the range [first, first+len).

virtual Bool_t	isWeighted () const override

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

RooAbsDataStore *	merge (const RooArgSet &allvars, std::list< RooAbsDataStore * > dstoreList) override
	Merge columns of supplied data set(s) with this data set.

virtual Int_t	numEntries () const override

std::vector< RealFullVector * > &	realfStoreList ()

std::vector< RealVector * > &	realStoreList ()

virtual void	recalculateCache (const RooArgSet *, Int_t firstEvent, Int_t lastEvent, Int_t stepSize, Bool_t skipZeroWeights) override

virtual void	reset () override

virtual void	resetBuffers () override

virtual void	resetCache () override

const RooArgSet &	row ()

virtual void	setArgStatus (const RooArgSet &set, Bool_t active) override
	Disabling of branches is (intentionally) not implemented in vector data stores (as the doesn't result in a net saving of time)

virtual void	setDirtyProp (Bool_t flag) override

void	setExternalWeightArray (const Double_t arrayWgt, const Double_t arrayWgtErrLo, const Double_t arrayWgtErrHi, const Double_t arraySumW2) override

std::size_t	size () const
	Get size of stored dataset.

virtual Double_t	sumEntries () const override

Double_t	weight () const override
	Return the weight of the last-retrieved data point.

virtual Double_t	weight () const=0

double	weight (Int_t index) const

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

virtual Double_t	weightError (RooAbsData::ErrorType etype=RooAbsData::Poisson) const override
	Return the error of the current weight.

Internal RooFit interface.
The classes and functions in the internal RooFit interface are implementaion details and not part of the public user interface. Everything in this group might change without warning.
ArraysStruct	getArrays () const
	Exports all arrays in this RooVectorDataStore into a simple datastructure to be used by RooFit internal export functions.

void	recomputeSumWeight ()
	Trigger a recomputation of the cached weight sums.

Public Member Functions inherited from RooAbsDataStore
	RooAbsDataStore ()

	RooAbsDataStore (const RooAbsDataStore &other, const char *newname=0)

	RooAbsDataStore (const RooAbsDataStore &other, const RooArgSet &vars, const char *newname=0)

	RooAbsDataStore (std::string_view name, std::string_view title, const RooArgSet &vars)

const RooArgSet &	cachedVars () const

virtual void	checkInit () const

virtual int	defaultPrintContents (Option_t *) const override
	Define default print options, for a given print style.

Bool_t	dirtyProp () const

void	Print (Option_t *options=0) const override
	Print TNamed name and title.

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_t 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 const TTree *	tree () const

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.

virtual void	Clear (Option_t *option="")
	Set name and title to empty strings ("").

virtual TObject *	Clone (const char *newname="") const
	Make a clone of an object using the Streamer facility.

virtual Int_t	Compare (const TObject *obj) const
	Compare two TNamed objects.

virtual void	Copy (TObject &named) const
	Copy this to obj.

virtual void	FillBuffer (char *&buffer)
	Encode TNamed into output buffer.

virtual const char *	GetName () const
	Returns name of object.

virtual const char *	GetTitle () const
	Returns title of object.

virtual ULong_t	Hash () const
	Return hash value for this object.

virtual Bool_t	IsSortable () const

virtual void	ls (Option_t *option="") const
	List TNamed name and title.

TNamed &	operator= (const TNamed &rhs)
	TNamed assignment operator.

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.

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	Draw (Option_t *option="")
	Default Draw method for all objects.

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 for instance with: `gROOT->SetSelectedPad(gPad)`.

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=0)
	Execute method on this object with the given parameter string, e.g.

virtual void	Execute (TMethod method, TObjArray params, Int_t *error=0)
	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.

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)
	Operator delete [].

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.

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.

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=0, Int_t option=0, Int_t bufsize=0)
	Write this object to the current directory.

virtual Int_t	Write (const char *name=0, 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.

Protected Member Functions
CatVector *	addCategory (RooAbsCategory *cat)

RealVector *	addReal (RooAbsReal *real)

RealFullVector *	addRealFull (RooAbsReal *real)

void	forceCacheUpdate () override

Bool_t	hasAsymError (RooAbsReal *real)

Bool_t	hasError (RooAbsReal *real)

virtual Bool_t	hasFilledCache () const override

Bool_t	isFullReal (RooAbsReal *real)

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

Private Member Functions
void	reserve (Int_t nEvt)

void	setAllBuffersNative ()

RooArgSet	varsNoWeight (const RooArgSet &allVars, const char *wgtName)
	Utility function for constructors Return RooArgSet that is copy of allVars minus variable matching wgtName if specified.

RooRealVar *	weightVar (const RooArgSet &allVars, const char *wgtName)
	Utility function for constructors Return pointer to weight variable if it is defined.

Private Attributes
RooVectorDataStore *	_cache

RooAbsArg *	_cacheOwner
	Optimization cache.

std::vector< CatVector * >	_catStoreList

ULong64_t	_currentWeightIndex {0}
	External sum of weights array.

const Double_t *	_extSumW2Array
	External weight array - high error.

const Double_t *	_extWgtArray

const Double_t *	_extWgtErrHiArray
	External weight array - low error.

const Double_t *	_extWgtErrLoArray
	External weight array.

Bool_t	_forcedUpdate
	Cache owner.

std::vector< RealFullVector * >	_realfStoreList

std::vector< RealVector * >	_realStoreList

Double_t	_sumWeight

Double_t	_sumWeightCarry

RooArgSet	_varsww

RooRealVar *	_wgtVar

Friends
class	RooAbsCategory

class	RooAbsReal

class	RooRealVar

Additional Inherited Members
Public Types inherited from TObject
enum	{ kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 , kBitMask = 0x00ffffff }

enum	{ kSingleKey = BIT(0) , kOverwrite = BIT(1) , kWriteDelete = BIT(2) }

enum	EDeprecatedStatusBits { kObjInCanvas = BIT(3) }

enum	EStatusBits { kCanDelete = BIT(0) , kMustCleanup = BIT(3) , kIsReferenced = BIT(4) , kHasUUID = BIT(5) , kCannotPick = BIT(6) , kNoContextMenu = BIT(8) , kInvalidObject = BIT(13) }

Public Types inherited from RooPrintable
enum	ContentsOption { kName =1 , kClassName =2 , kValue =4 , kArgs =8 , kExtras =16 , kAddress =32 , kTitle =64 , kCollectionHeader =128 }

enum	StyleOption { kInline =1 , kSingleLine =2 , kStandard =3 , kVerbose =4 , kTreeStructure =5 }

Static Public Member Functions inherited from TObject
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 std::ostream &	defaultPrintStream (std::ostream *os=0)
	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.

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

Protected Attributes inherited from RooAbsDataStore
RooArgSet	_cachedVars

Bool_t	_doDirtyProp = true

RooArgSet	_vars

Protected Attributes inherited from TNamed
TString	fName

TString	fTitle

Static Protected Attributes inherited from RooPrintable
static Int_t	_nameLength

#include <RooVectorDataStore.h>

Inheritance diagram for RooVectorDataStore:

[legend]

Constructor & Destructor Documentation

◆ RooVectorDataStore() [1/6]

RooVectorDataStore::RooVectorDataStore ( )

Definition at line 60 of file RooVectorDataStore.cxx.

◆ RooVectorDataStore() [2/6]

RooVectorDataStore::RooVectorDataStore	(	std::string_view	name,
		std::string_view	title,
		const RooArgSet &	vars,
		const char *	wgtVarName = `0`
	)

Definition at line 79 of file RooVectorDataStore.cxx.

◆ RooVectorDataStore() [3/6]

RooVectorDataStore::RooVectorDataStore	(	const RooVectorDataStore &	other,
		const char *	newname = `0`
	)

Regular copy ctor.

Definition at line 160 of file RooVectorDataStore.cxx.

◆ RooVectorDataStore() [4/6]

RooVectorDataStore::RooVectorDataStore	(	const RooTreeDataStore &	other,
		const RooArgSet &	vars,
		const char *	newname = `0`
	)

Definition at line 195 of file RooVectorDataStore.cxx.

◆ RooVectorDataStore() [5/6]

RooVectorDataStore::RooVectorDataStore	(	const RooVectorDataStore &	other,
		const RooArgSet &	vars,
		const char *	newname = `0`
	)

Clone ctor, must connect internal storage to given new external set of vars.

Definition at line 231 of file RooVectorDataStore.cxx.

◆ RooVectorDataStore() [6/6]

RooVectorDataStore::RooVectorDataStore	(	std::string_view	name,
		std::string_view	title,
		RooAbsDataStore &	tds,
		const RooArgSet &	vars,
		const RooFormulaVar *	cutVar,
		const char *	cutRange,
		std::size_t	nStart,
		std::size_t	nStop,
		Bool_t	,
		const char *	wgtVarName = `0`
	)

Definition at line 289 of file RooVectorDataStore.cxx.

◆ ~RooVectorDataStore()

RooVectorDataStore::~RooVectorDataStore ( )

virtual

Destructor.

Definition at line 337 of file RooVectorDataStore.cxx.

Member Function Documentation

◆ addCategory()

RooVectorDataStore::CatVector * RooVectorDataStore::addCategory ( RooAbsCategory * cat )

protected

Definition at line 1405 of file RooVectorDataStore.cxx.

◆ addColumn()

RooAbsArg * RooVectorDataStore::addColumn	(	RooAbsArg &	newVar,
		Bool_t	adjustRange = `kTRUE`
	)

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.

[in]	first	First event in the batches.
[in]	len	Number of events in batches.

Classes

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Friends

Additional Inherited Members

Constructor & Destructor Documentation

◆ RooVectorDataStore() [1/6]

◆ RooVectorDataStore() [2/6]

◆ RooVectorDataStore() [3/6]

◆ RooVectorDataStore() [4/6]

◆ RooVectorDataStore() [5/6]

◆ RooVectorDataStore() [6/6]

◆ ~RooVectorDataStore()

Member Function Documentation

◆ addCategory()

◆ addColumn()

◆ addColumns()

◆ addReal()

◆ addRealFull()

◆ append()

◆ attachBuffers()

◆ attachCache()

◆ cache()

◆ cacheArgs()

◆ cacheOwner()

◆ catStoreList()

◆ changeObservableName()

◆ clone() [1/2]

◆ clone() [2/2]

◆ dump()

◆ fill()

◆ forceCacheUpdate()

◆ get() [1/3]

◆ get() [2/3]

◆ get() [3/3]

◆ getArrays()

◆ getBatches()

◆ getCategoryBatches()

◆ getNative()

◆ getWeightBatch()

◆ hasAsymError()

◆ hasError()

◆ hasFilledCache()

◆ isFullReal()

◆ isWeighted()

◆ loadValues()

◆ merge()

◆ numEntries()

◆ realfStoreList()

◆ realStoreList()

◆ recalculateCache()

◆ recomputeSumWeight()

◆ reserve()

◆ reset()

◆ resetBuffers()

◆ resetCache()

◆ row()

◆ setAllBuffersNative()

◆ setArgStatus()

◆ setDirtyProp()

◆ setExternalWeightArray()

◆ size()

◆ sumEntries()

◆ varsNoWeight()

◆ weight() [1/3]

◆ weight() [2/3]

◆ weight() [3/3]

◆ weightError() [1/2]

◆ weightError() [2/2]

◆ weightVar()

Friends And Related Symbol Documentation

◆ RooAbsCategory

◆ RooAbsReal

◆ RooRealVar

Member Data Documentation

◆ _cache

◆ _cacheOwner

◆ _catStoreList