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

Persistable container for RooFit projects.

A workspace can contain and own variables, p.d.f.s, functions and datasets. All objects that live in the workspace are owned by the workspace. The import() method enforces consistency of objects upon insertion into the workspace (e.g. no duplicate object with the same name are allowed) and makes sure all objects in the workspace are connected to each other. Easy accessor methods like pdf(), var() and data() allow to refer to the contents of the workspace by object name. The entire RooWorkspace can be saved into a ROOT TFile and organises the consistent streaming of its contents without duplication. If a RooWorkspace contains custom classes, i.e. classes not in the ROOT distribution, portability of workspaces can be enhanced by storing the source code of those classes in the workspace as well. This process is also organized by the workspace through the importClassCode() method.

Seemingly random crashes when reading large workspaces

When reading or loading workspaces with deeply nested PDFs, one can encounter ouf-of-memory errors if the stack size is too small. This manifests in crashes at seemingly random locations, or in the process silently ending. Unfortunately, ROOT neither recover from this situation, nor warn or give useful instructions. When suspecting to have run out of stack memory, check

ulimit -s

and try reading again.

PyROOT

The RooWorkspace::import function can't be used in PyROOT because import is a reserved python keyword. For this reason, an alternative with a capitalized name is provided:

workspace.Import(x)

Definition at line 43 of file RooWorkspace.h.

Public Member Functions

 RooWorkspace ()
 Default constructor.
 
 RooWorkspace (const char *name, bool doCINTExport)
 Construct empty workspace with given name and option to export reference to all workspace contents to a CINT namespace with the same name.
 
 RooWorkspace (const char *name, const char *title=nullptr)
 Construct empty workspace with given name and title.
 
 RooWorkspace (const RooWorkspace &other)
 Workspace copy constructor.
 
 ~RooWorkspace () override
 Workspace destructor.
 
RooAbsArgarg (RooStringView name) const
 Return RooAbsArg with given name. A null pointer is returned if none is found.
 
RooArgSet argSet (RooStringView nameList) const
 Return set of RooAbsArgs matching to given list of names.
 
bool cancelTransaction ()
 Cancel an ongoing import transaction.
 
RooCategorycat (RooStringView name) const
 Retrieve discrete variable (RooCategory) with given name. A null pointer is returned if not found.
 
RooAbsCategorycatfunc (RooStringView name) const
 Retrieve discrete function (RooAbsCategory) with given name. A null pointer is returned if not found.
 
TObjectClone (const char *newname="") const override
 TObject::Clone() needs to be overridden.
 
bool commitTransaction ()
 
TIteratorcomponentIterator () const R__DEPRECATED(6
 
RooAbsDatadata (RooStringView name) const
 Retrieve dataset (binned or unbinned) with given name. A null pointer is returned if not found.
 
bool defineSet (const char *name, const char *contentList)
 Define a named set in the work space through a comma separated list of names of objects already in the workspace.
 
bool defineSet (const char *name, const RooArgSet &aset, bool importMissing=false)
 Define a named RooArgSet with given constituents.
 
RooAbsDataembeddedData (RooStringView name) const
 Retrieve dataset (binned or unbinned) with given name. A null pointer is returned if not found.
 
bool extendSet (const char *name, const char *newContents)
 Define a named set in the work space through a comma separated list of names of objects already in the workspace.
 
RooAbsRealfunction (RooStringView name) const
 Retrieve function (RooAbsReal) with given name. Note that all RooAbsPdfs are also RooAbsReals. A null pointer is returned if not found.
 
RooAbsArgfundArg (RooStringView name) const
 Return fundamental (i.e.
 
const RooArgSetgetSnapshot (const char *name) const
 Return the RooArgSet containing a snapshot of variables contained in the workspace.
 
RooLinkedList const & getSnapshots () const
 
bool import (const char *fileSpec, 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 RooCmdArg &arg9={})
 Import a RooAbsArg or RooAbsData set from a workspace in a file.
 
bool import (const RooAbsArg &arg, 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 RooCmdArg &arg9={})
 Import a RooAbsArg object, e.g.
 
bool import (const RooArgSet &args, 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 RooCmdArg &arg9={})
 Import multiple RooAbsArg objects into workspace.
 
bool import (RooAbsData const &data, 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 RooCmdArg &arg9={})
 Import a dataset (RooDataSet or RooDataHist) into the work space.
 
bool import (TObject const &object, bool replaceExisting=false)
 Import a clone of a generic TObject into workspace generic object container.
 
bool import (TObject const &object, const char *aliasName, bool replaceExisting=false)
 Import a clone of a generic TObject into workspace generic object container.
 
bool importClassCode (const char *pat="*", bool doReplace=false)
 Import code of all classes in the workspace that have a class name that matches pattern 'pat' and which are not found to be part of the standard ROOT distribution.
 
bool importClassCode (TClass *theClass, bool doReplace=false)
 
bool loadSnapshot (const char *name)
 Load the values and attributes of the parameters in the snapshot saved with the given name.
 
void merge (const RooWorkspace &)
 
RooAbsPdfpdf (RooStringView name) const
 Retrieve p.d.f (RooAbsPdf) with given name. A null pointer is returned if not found.
 
bool removeSet (const char *name)
 Remove a named set from the workspace.
 
bool renameSet (const char *name, const char *newName)
 Rename set to a new name.
 
bool saveSnapshot (RooStringView, const char *paramNames)
 Save snapshot of values and attributes (including "Constant") of given parameters.
 
bool saveSnapshot (RooStringView, const RooArgSet &params, bool importValues=false)
 Save snapshot of values and attributes (including "Constant") of parameters 'params'.
 
const RooArgSetset (RooStringView name)
 Return pointer to previously defined named set with given nmame If no such set is found a null pointer is returned.
 
const std::map< std::string, RooArgSet > & sets () const
 
bool startTransaction ()
 Open an import transaction operations.
 
RooRealVarvar (RooStringView name) const
 Retrieve real-valued variable (RooRealVar) with given name. A null pointer is returned if not found.
 
- 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 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 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)
 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)
 
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.
 

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 ))
}
 
- 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.
 
- 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 TNamed
TString fName
 
TString fTitle
 

#include <RooWorkspace.h>

Inheritance diagram for RooWorkspace:
[legend]

Constructor & Destructor Documentation

◆ RooWorkspace() [1/4]

RooWorkspace::RooWorkspace ( )

Default constructor.

Definition at line 168 of file RooWorkspace.cxx.

◆ RooWorkspace() [2/4]

RooWorkspace::RooWorkspace ( const char *  name,
bool  doCINTExport 
)

Construct empty workspace with given name and option to export reference to all workspace contents to a CINT namespace with the same name.

Definition at line 186 of file RooWorkspace.cxx.

◆ RooWorkspace() [3/4]

RooWorkspace::RooWorkspace ( const char *  name,
const char *  title = nullptr 
)

Construct empty workspace with given name and title.

Definition at line 177 of file RooWorkspace.cxx.

◆ RooWorkspace() [4/4]

RooWorkspace::RooWorkspace ( const RooWorkspace other)

Workspace copy constructor.

Definition at line 195 of file RooWorkspace.cxx.

◆ ~RooWorkspace()

RooWorkspace::~RooWorkspace ( )
override

Workspace destructor.

Definition at line 247 of file RooWorkspace.cxx.

Member Function Documentation

◆ arg()

RooAbsArg * RooWorkspace::arg ( RooStringView  name) const

Return RooAbsArg with given name. A null pointer is returned if none is found.

Definition at line 1260 of file RooWorkspace.cxx.

◆ argSet()

RooArgSet RooWorkspace::argSet ( RooStringView  nameList) const

Return set of RooAbsArgs matching to given list of names.

Definition at line 1270 of file RooWorkspace.cxx.

◆ cancelTransaction()

bool RooWorkspace::cancelTransaction ( )

Cancel an ongoing import transaction.

All objects imported since startTransaction() will be removed and the transaction will be terminated. Return true if cancel operation succeeds, return false if there was no open transaction

Definition at line 1049 of file RooWorkspace.cxx.

◆ cat()

RooCategory * RooWorkspace::cat ( RooStringView  name) const

Retrieve discrete variable (RooCategory) with given name. A null pointer is returned if not found.

Definition at line 1241 of file RooWorkspace.cxx.

◆ catfunc()

RooAbsCategory * RooWorkspace::catfunc ( RooStringView  name) const

Retrieve discrete function (RooAbsCategory) with given name. A null pointer is returned if not found.

Definition at line 1250 of file RooWorkspace.cxx.

◆ Clone()

TObject * RooWorkspace::Clone ( const char *  newname = "") const
overridevirtual

TObject::Clone() needs to be overridden.

Reimplemented from TObject.

Definition at line 234 of file RooWorkspace.cxx.

◆ commitTransaction()

bool RooWorkspace::commitTransaction ( )

Definition at line 1068 of file RooWorkspace.cxx.

◆ componentIterator()

TIterator * RooWorkspace::componentIterator ( ) const

Definition at line 2945 of file RooWorkspace.cxx.

◆ data()

RooAbsData * RooWorkspace::data ( RooStringView  name) const

Retrieve dataset (binned or unbinned) with given name. A null pointer is returned if not found.

Definition at line 1309 of file RooWorkspace.cxx.

◆ defineSet() [1/2]

bool RooWorkspace::defineSet ( const char *  name,
const char *  contentList 
)

Define a named set in the work space through a comma separated list of names of objects already in the workspace.

Definition at line 902 of file RooWorkspace.cxx.

◆ defineSet() [2/2]

bool RooWorkspace::defineSet ( const char *  name,
const RooArgSet aset,
bool  importMissing = false 
)

Define a named RooArgSet with given constituents.

If importMissing is true, any constituents of aset that are not in the workspace will be imported, otherwise an error is returned for missing components

Definition at line 844 of file RooWorkspace.cxx.

◆ embeddedData()

RooAbsData * RooWorkspace::embeddedData ( RooStringView  name) const

Retrieve dataset (binned or unbinned) with given name. A null pointer is returned if not found.

Definition at line 1318 of file RooWorkspace.cxx.

◆ extendSet()

bool RooWorkspace::extendSet ( const char *  name,
const char *  newContents 
)

Define a named set in the work space through a comma separated list of names of objects already in the workspace.

Definition at line 937 of file RooWorkspace.cxx.

◆ function()

RooAbsReal * RooWorkspace::function ( RooStringView  name) const

Retrieve function (RooAbsReal) with given name. Note that all RooAbsPdfs are also RooAbsReals. A null pointer is returned if not found.

Definition at line 1223 of file RooWorkspace.cxx.

◆ fundArg()

RooAbsArg * RooWorkspace::fundArg ( RooStringView  name) const

Return fundamental (i.e.

non-derived) RooAbsArg with given name. Fundamental types are e.g. RooRealVar, RooCategory. A null pointer is returned if none is found.

Definition at line 1295 of file RooWorkspace.cxx.

◆ getSnapshot()

const RooArgSet * RooWorkspace::getSnapshot ( const char *  name) const

Return the RooArgSet containing a snapshot of variables contained in the workspace.

Note that the variables of the objects in the snapshots are copies of the variables in the workspace. To load the values of a snapshot in the workspace variables, use loadSnapshot() instead.

Definition at line 1205 of file RooWorkspace.cxx.

◆ getSnapshots()

RooLinkedList const & RooWorkspace::getSnapshots ( ) const
inline

Definition at line 100 of file RooWorkspace.h.

◆ import() [1/6]

RooWorkspace::import ( const char *  fileSpec,
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 RooCmdArg arg9 = {} 
)

Import a RooAbsArg or RooAbsData set from a workspace in a file.

Filespec should be constructed as "filename:wspacename:objectname" The arguments will be passed to the relevant import() or import(RooAbsData&, ...) import calls

Note
From python, use Import(), since import is a reserved keyword.

PyROOT

Support the C++ import() as Import() in python

Definition at line 271 of file RooWorkspace.cxx.

◆ import() [2/6]

RooWorkspace::import ( const RooAbsArg arg,
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 RooCmdArg arg9 = {} 
)

Import a RooAbsArg object, e.g.

function, p.d.f or variable into the workspace. This import function clones the input argument and will own the clone. If a composite object is offered for import, e.g. a p.d.f with parameters and observables, the complete tree of objects is imported. If any of the variables of a composite object (parameters/observables) are already in the workspace the imported p.d.f. is connected to the already existing variables. If any of the function objects (p.d.f, formulas) to be imported already exists in the workspace an error message is printed and the import of the entire tree of objects is cancelled. Several optional arguments can be provided to modify the import procedure.

Accepted arguments
RenameConflictNodes(const char* suffix) Add suffix to branch node name if name conflicts with existing node in workspace
RenameAllNodes(const char* suffix) Add suffix to all branch node names including top level node.
RenameAllVariables(const char* suffix) Add suffix to all variables of objects being imported.
RenameAllVariablesExcept(const char* suffix, const char* exceptionList) Add suffix to all variables names, except ones listed
RenameVariable(const char* inputName, const char* outputName) Rename a single variable as specified upon import.
RecycleConflictNodes() If any of the function objects to be imported already exist in the name space, connect the imported expression to the already existing nodes.
Attention
Use with care! If function definitions do not match, this alters the definition of your function upon import
Silence() Do not issue any info message

The RenameConflictNodes, RenameNodes and RecycleConflictNodes arguments are mutually exclusive. The RenameVariable argument can be repeated as often as necessary to rename multiple variables. Alternatively, a single RenameVariable argument can be given with two comma separated lists.

Note
From python, use Import(), since import is a reserved keyword.

PyROOT

Support the C++ import() as Import() in python

PyROOT

The RooWorkspace constructor is pythonized with the command argument pythonization. The keywords must correspond to the CmdArgs of the constructor.

Definition at line 371 of file RooWorkspace.cxx.

◆ import() [3/6]

bool RooWorkspace::import ( const RooArgSet args,
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 RooCmdArg arg9 = {} 
)

Import multiple RooAbsArg objects into workspace.

For details on arguments see documentation of import() method for single RooAbsArg

Note
From python, use Import(), since import is a reserved keyword.

Definition at line 331 of file RooWorkspace.cxx.

◆ import() [4/6]

bool RooWorkspace::import ( RooAbsData const &  inData,
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 RooCmdArg arg9 = {} 
)

Import a dataset (RooDataSet or RooDataHist) into the work space.

The workspace will contain a copy of the data. The dataset and its variables can be renamed upon insertion with the options below

Accepted arguments
Rename(const char* suffix) Rename dataset upon insertion
RenameVariable(const char* inputName, const char* outputName) Change names of observables in dataset upon insertion
Silence Be quiet, except in case of errors
Note
From python, use Import(), since import is a reserved keyword.

Definition at line 726 of file RooWorkspace.cxx.

◆ import() [5/6]

bool RooWorkspace::import ( TObject const &  object,
bool  replaceExisting = false 
)

Import a clone of a generic TObject into workspace generic object container.

Imported object can be retrieved by name through the obj() method. The object is cloned upon importation and the input argument does not need to live beyond the import call

Returns true if an error has occurred.

Definition at line 1912 of file RooWorkspace.cxx.

◆ import() [6/6]

bool RooWorkspace::import ( TObject const &  object,
const char *  aliasName,
bool  replaceExisting = false 
)

Import a clone of a generic TObject into workspace generic object container.

The imported object will be stored under the given alias name rather than its own name. Imported object can be retrieved its alias name through the obj() method. The object is cloned upon importation and the input argument does not need to live beyond the import call This method is mostly useful for importing objects that do not have a settable name such as TMatrix

Returns true if an error has occurred.

Definition at line 1952 of file RooWorkspace.cxx.

◆ importClassCode() [1/2]

bool RooWorkspace::importClassCode ( const char *  pat = "*",
bool  doReplace = false 
)

Import code of all classes in the workspace that have a class name that matches pattern 'pat' and which are not found to be part of the standard ROOT distribution.

If doReplace is true any existing class code saved in the workspace is replaced

Definition at line 1112 of file RooWorkspace.cxx.

◆ importClassCode() [2/2]

bool RooWorkspace::importClassCode ( TClass theClass,
bool  doReplace = false 
)

Definition at line 1099 of file RooWorkspace.cxx.

◆ loadSnapshot()

bool RooWorkspace::loadSnapshot ( const char *  name)

Load the values and attributes of the parameters in the snapshot saved with the given name.

Definition at line 1182 of file RooWorkspace.cxx.

◆ merge()

void RooWorkspace::merge ( const RooWorkspace )
inline

Definition at line 102 of file RooWorkspace.h.

◆ pdf()

RooAbsPdf * RooWorkspace::pdf ( RooStringView  name) const

Retrieve p.d.f (RooAbsPdf) with given name. A null pointer is returned if not found.

Definition at line 1214 of file RooWorkspace.cxx.

◆ removeSet()

bool RooWorkspace::removeSet ( const char *  name)

Remove a named set from the workspace.

Definition at line 1007 of file RooWorkspace.cxx.

◆ renameSet()

bool RooWorkspace::renameSet ( const char *  name,
const char *  newName 
)

Rename set to a new name.

Definition at line 976 of file RooWorkspace.cxx.

◆ saveSnapshot() [1/2]

bool RooWorkspace::saveSnapshot ( RooStringView  name,
const char *  paramNames 
)

Save snapshot of values and attributes (including "Constant") of given parameters.

Parameters
[in]nameName of the snapshot.
[in]paramNamesComma-separated list of parameter names to be snapshot.

Definition at line 1137 of file RooWorkspace.cxx.

◆ saveSnapshot() [2/2]

bool RooWorkspace::saveSnapshot ( RooStringView  name,
const RooArgSet params,
bool  importValues = false 
)

Save snapshot of values and attributes (including "Constant") of parameters 'params'.

If importValues is FALSE, the present values from the object in the workspace are saved. If importValues is TRUE, the values of the objects passed in the 'params' argument are saved

Definition at line 1152 of file RooWorkspace.cxx.

◆ set()

const RooArgSet * RooWorkspace::set ( RooStringView  name)

Return pointer to previously defined named set with given nmame If no such set is found a null pointer is returned.

Definition at line 964 of file RooWorkspace.cxx.

◆ sets()

const std::map< std::string, RooArgSet > & RooWorkspace::sets ( ) const
inline

Definition at line 91 of file RooWorkspace.h.

◆ startTransaction()

bool RooWorkspace::startTransaction ( )

Open an import transaction operations.

Returns true if successful, false if there is already an ongoing transaction

Definition at line 1029 of file RooWorkspace.cxx.

◆ var()

RooRealVar * RooWorkspace::var ( RooStringView  name) const

Retrieve real-valued variable (RooRealVar) with given name. A null pointer is returned if not found.

Definition at line 1232 of file RooWorkspace.cxx.

Libraries for RooWorkspace:

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