Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
RooAbsArg.h
Go to the documentation of this file.
1/*****************************************************************************
2 * Project: RooFit *
3 * Package: RooFitCore *
4 * File: $Id: RooAbsArg.h,v 1.93 2007/07/16 21:04:28 wouter Exp $
5 * Authors: *
6 * WV, Wouter Verkerke, UC Santa Barbara, verkerke@slac.stanford.edu *
7 * DK, David Kirkby, UC Irvine, dkirkby@uci.edu *
8 * *
9 * Copyright (c) 2000-2005, Regents of the University of California *
10 * and Stanford University. All rights reserved. *
11 * *
12 * Redistribution and use in source and binary forms, *
13 * with or without modification, are permitted according to the terms *
14 * listed in LICENSE (http://roofit.sourceforge.net/license.txt) *
15 *****************************************************************************/
16#ifndef ROO_ABS_ARG
17#define ROO_ABS_ARG
18
19#include <RooAbsCache.h>
20#include <RooFit/Config.h>
22#include <RooLinkedListIter.h>
23#include <RooNameReg.h>
24#include <RooPrintable.h>
25#include <RooSTLRefCountList.h>
26#include <RooStringView.h>
27
28#include <TNamed.h>
29#include <TObjArray.h>
30#include <TRefArray.h>
31
32#include <iostream>
33#include <limits>
34#include <map>
35#include <memory>
36#include <set>
37#include <string>
38#include <unordered_map>
39
40class TTree;
41class RooArgSet;
44class RooAbsData;
45class RooAbsDataStore;
46class RooAbsProxy;
47class RooArgProxy;
48template <class RooCollection_t>
53class RooWorkspace;
54namespace RooFit {
55class Evaluator;
56namespace Experimental {
57class CodegenContext;
58}
59} // namespace RooFit
60
61class RooRefArray : public TObjArray {
62public:
63 RooRefArray() = default;
66
67protected:
68 ClassDefOverride(RooRefArray, 1) // Helper class for proxy lists
69};
70
71class RooAbsArg;
72/// Print at the prompt
73namespace cling {
74std::string printValue(RooAbsArg *);
75}
76
77class RooAbsArg : public TNamed, public RooPrintable {
78public:
81
82 // Constructors, cloning and assignment
83 RooAbsArg();
84 ~RooAbsArg() override;
85 RooAbsArg(const char *name, const char *title);
86 RooAbsArg(const RooAbsArg &other, const char *name = nullptr);
88 virtual TObject *clone(const char *newname = nullptr) const = 0;
89 TObject *Clone(const char *newname = nullptr) const override
90 {
91 return clone(newname && newname[0] != '\0' ? newname : nullptr);
92 }
93 virtual RooAbsArg *cloneTree(const char *newname = nullptr) const;
94
95 // Accessors to client-server relation information
96
97 /// Does value or shape of this arg depend on any other arg?
98 virtual bool isDerived() const { return true; }
99
100 /// Check whether this object depends on values from an element in the `serverList`.
101 ///
102 /// @param serverList Test if one of the elements in this list serves values to `this`.
103 /// @param ignoreArg Ignore values served by this object.
104 /// @return True if values are served.
105 bool dependsOnValue(const RooAbsCollection &serverList, const RooAbsArg *ignoreArg = nullptr) const
106 {
107 return dependsOn(serverList, ignoreArg, true);
108 }
109 /// Check whether this object depends on values served from the object passed as `server`.
110 ///
111 /// @param server Test if `server` serves values to `this`.
112 /// @param ignoreArg Ignore values served by this object.
113 /// @return True if values are served.
114 bool dependsOnValue(const RooAbsArg &server, const RooAbsArg *ignoreArg = nullptr) const
115 {
116 return dependsOn(server, ignoreArg, true);
117 }
118 bool
119 dependsOn(const RooAbsCollection &serverList, const RooAbsArg *ignoreArg = nullptr, bool valueOnly = false) const;
120 /// Test whether we depend on (ie, are served by) the specified object.
121 /// Note that RooAbsArg objects are considered equivalent if they have
122 /// the same name.
123 inline bool dependsOn(const RooAbsArg &server, const RooAbsArg *ignoreArg = nullptr, bool valueOnly = false) const
124 {
125 return dependsOn(server.namePtr(), ignoreArg, valueOnly);
126 }
127 bool dependsOn(TNamed const *namePtr, const RooAbsArg *ignoreArg = nullptr, bool valueOnly = false) const;
128 bool overlaps(const RooAbsArg &testArg, bool valueOnly = false) const;
129 bool hasClients() const { return !_clientList.empty(); }
130
131 ////////////////////////////////////////////////////////////////////////////
132 /// \anchor clientServerInterface
133 /// \name Client-Server Interface
134 /// These functions allow RooFit to figure out who is serving values to whom.
135 /// @{
136
137 /// List of all clients of this object.
138 const RefCountList_t &clients() const { return _clientList; }
139 /// List of all value clients of this object. Value clients receive value updates.
141 /// List of all shape clients of this object. Shape clients receive property information such as
142 /// changes of a value range.
144
145 /// List of all servers of this object.
146 const RefCountList_t &servers() const { return _serverList; }
147 /// Return server of `this` with name `name`. Returns nullptr if not found.
148 inline RooAbsArg *findServer(const char *name) const
149 {
150 const auto serverIt = _serverList.findByName(name);
151 return serverIt != _serverList.end() ? *serverIt : nullptr;
152 }
153 /// Return server of `this` that has the same name as `arg`. Returns `nullptr` if not found.
154 inline RooAbsArg *findServer(const RooAbsArg &arg) const { return _serverList.findByNamePointer(&arg); }
155 /// Return i-th server from server list.
156 inline RooAbsArg *findServer(Int_t index) const { return _serverList.containedObjects()[index]; }
157 /// Check if `this` is serving values to `arg`.
158 inline bool isValueServer(const RooAbsArg &arg) const { return _clientListValue.containsByNamePtr(&arg); }
159 /// Check if `this` is serving values to an object with name `name`.
160 inline bool isValueServer(const char *name) const { return _clientListValue.containsSameName(name); }
161 /// Check if `this` is serving shape to `arg`.
162 inline bool isShapeServer(const RooAbsArg &arg) const { return _clientListShape.containsByNamePtr(&arg); }
163 /// Check if `this` is serving shape to an object with name `name`.
164 inline bool isShapeServer(const char *name) const { return _clientListShape.containsSameName(name); }
165 void
166 leafNodeServerList(RooAbsCollection *list, const RooAbsArg *arg = nullptr, bool recurseNonDerived = false) const;
167 void
168 branchNodeServerList(RooAbsCollection *list, const RooAbsArg *arg = nullptr, bool recurseNonDerived = false) const;
169 void treeNodeServerList(RooAbsCollection *list, const RooAbsArg *arg = nullptr, bool doBranch = true,
170 bool doLeaf = true, bool valueOnly = false, bool recurseNonDerived = false) const;
171
172 /// Is this object a fundamental type that can be added to a dataset?
173 /// Fundamental-type subclasses override this method to return true.
174 /// Note that this test is subtlely different from the dynamic isDerived()
175 /// test, e.g. a constant is not derived but is also not fundamental.
176 inline virtual bool isFundamental() const { return false; }
177
178 /// Create a fundamental-type object that stores our type of value. The
179 /// created object will have a valid value, but not necessarily the same
180 /// as our value. The caller is responsible for deleting the returned object.
181 virtual RooFit::OwningPtr<RooAbsArg> createFundamental(const char *newname = nullptr) const = 0;
182
183 /// Is this argument an l-value, i.e., can it appear on the left-hand side
184 /// of an assignment expression? LValues are also special since they can
185 /// potentially be analytically integrated and generated.
186 inline virtual bool isLValue() const { return false; }
187
188 // Server redirection interface
189 bool redirectServers(const RooAbsCollection &newServerList, bool mustReplaceAll = false, bool nameChange = false,
190 bool isRecursionStep = false);
191 bool redirectServers(std::unordered_map<RooAbsArg *, RooAbsArg *> const &replacements);
193 bool nameChange = false, bool recurseInNewSet = true);
194
196 bool isRecursiveStep);
197
198 virtual void serverNameChangeHook(const RooAbsArg * /*oldServer*/, const RooAbsArg * /*newServer*/) {};
199
200 void addServer(RooAbsArg &server, bool valueProp = true, bool shapeProp = false, std::size_t refCount = 1);
201 void addServerList(RooAbsCollection &serverList, bool valueProp = true, bool shapeProp = false);
202 void R__SUGGEST_ALTERNATIVE("This interface is unsafe! Use RooAbsArg::redirectServers()")
205 void removeServer(RooAbsArg &server, bool force = false);
207
208 /// @}
209 ///////////////////////////////////////////////////////////////////////////////
210
211 // Parameter & observable interpretation of servers
215 RooFit::OwningPtr<RooArgSet> getParameters(const RooArgSet &observables, bool stripDisconnected = true) const;
216 RooFit::OwningPtr<RooArgSet> getParameters(const RooArgSet *observables, bool stripDisconnected = true) const;
227 RooFit::OwningPtr<RooArgSet> getComponents() const;
228
230 void attachDataSet(const RooAbsData &set);
232
233 // I/O streaming interface (machine readable)
234 virtual bool readFromStream(std::istream &is, bool compact, bool verbose = false) = 0;
235 virtual void writeToStream(std::ostream &os, bool compact) const = 0;
236
237 /// Print the object to the defaultPrintStream().
238 /// \param[in] options **V** print verbose. **T** print a tree structure with all children.
239 void Print(Option_t *options = nullptr) const override
240 {
241 // Printing interface (human readable)
243 }
244
245 void printName(std::ostream &os) const override;
246 void printTitle(std::ostream &os) const override;
247 void printClassName(std::ostream &os) const override;
248 void printAddress(std::ostream &os) const override;
249 void printArgs(std::ostream &os) const override;
250 virtual void printMetaArgs(std::ostream & /*os*/) const {};
251 void printMultiline(std::ostream &os, Int_t contents, bool verbose = false, TString indent = "") const override;
252 void printTree(std::ostream &os, TString indent = "") const override;
253
254 Int_t defaultPrintContents(Option_t *opt) const override;
255
256 // Accessors to attributes
257 void setAttribute(const Text_t *name, bool value = true);
258 bool getAttribute(const Text_t *name) const;
259 inline const std::set<std::string> &attributes() const
260 {
261 // Returns set of names of boolean attributes defined
262 return _boolAttrib;
263 }
264
265 void setStringAttribute(const Text_t *key, const Text_t *value);
266 void removeStringAttribute(const Text_t *key);
267 const Text_t *getStringAttribute(const Text_t *key) const;
268 inline const std::map<std::string, std::string> &stringAttributes() const
269 {
270 // Returns std::map<string,string> with all string attributes defined
271 return _stringAttrib;
272 }
273
274 // Accessors to transient attributes
275 void setTransientAttribute(const Text_t *name, bool value = true);
276 bool getTransientAttribute(const Text_t *name) const;
277 inline const std::set<std::string> &transientAttributes() const
278 {
279 // Return set of transient boolean attributes
281 }
282
283 /// Check if the "Constant" attribute is set.
284 inline bool isConstant() const
285 {
286 return _isConstant; // getAttribute("Constant") ;
287 }
288
289 // Sorting
290 Int_t Compare(const TObject *other) const override;
291 bool IsSortable() const override
292 {
293 // Object is sortable in ROOT container class
294 return true;
295 }
296
297 virtual bool operator==(const RooAbsArg &other) const = 0;
298 virtual bool isIdentical(const RooAbsArg &other, bool assumeSameType = false) const = 0;
299
300 // Range management
301 virtual bool inRange(const char *) const
302 {
303 // Is value in range (dummy interface always returns true)
304 return true;
305 }
306 virtual bool hasRange(const char *) const
307 {
308 // Has this argument a defined range (dummy interface always returns false)
309 return false;
310 }
311
321 Never = 2
322 };
323 enum OperMode {
324 Auto = 0,
326 ADirty = 2
327 };
328
329 ////////////////////////////////////////////////////////////////////////////
330 /// \anchor optimisationInterface
331 /// \name Optimisation interface
332 /// These functions allow RooFit to optimise a computation graph, to keep track
333 /// of cached values, and to invalidate caches.
334 /// @{
335
336 // Cache mode optimization (tracks changes & do lazy evaluation vs evaluate always)
337 virtual void optimizeCacheMode(const RooArgSet &observables);
338 virtual void optimizeCacheMode(const RooArgSet &observables, RooArgSet &optNodes, RooLinkedList &processedNodes);
339
340 // Find constant terms in expression
341 bool findConstantNodes(const RooArgSet &observables, RooArgSet &cacheList);
343
344 // constant term optimization
345 virtual void constOptimizeTestStatistic(ConstOpCode opcode, bool doAlsoTrackingOpt = true);
346
347 virtual CacheMode canNodeBeCached() const { return Always; }
348 virtual void setCacheAndTrackHints(RooArgSet & /*trackNodes*/) {};
349
350 // Dirty state accessor
351 inline bool isShapeDirty() const
352 {
353 // Return true is shape has been invalidated by server value change
354 return isDerived() ? _shapeDirty : false;
355 }
356
357 inline bool isValueDirty() const
358 {
359 // Returns true of value has been invalidated by server value change
360 if (inhibitDirty())
361 return true;
362 switch (_operMode) {
363 case AClean: return false;
364 case ADirty: return true;
365 case Auto:
366 if (_valueDirty)
367 return isDerived();
368 return false;
369 }
370 return true; // we should never get here
371 }
372
373 inline bool isValueDirtyAndClear() const
374 {
375 // Returns true of value has been invalidated by server value change
376 if (inhibitDirty())
377 return true;
378 switch (_operMode) {
379 case AClean: return false;
380 case ADirty: return true;
381 case Auto:
382 if (_valueDirty) {
383 _valueDirty = false;
384 return isDerived();
385 }
386 return false;
387 }
388 return true; // But we should never get here
389 }
390
391 inline bool isValueOrShapeDirtyAndClear() const
392 {
393 // Returns true of value has been invalidated by server value change
394
395 if (inhibitDirty())
396 return true;
397 switch (_operMode) {
398 case AClean: return false;
399 case ADirty: return true;
400 case Auto:
401 if (_valueDirty || _shapeDirty) {
402 _shapeDirty = false;
403 _valueDirty = false;
404 return isDerived();
405 }
406 _shapeDirty = false;
407 _valueDirty = false;
408 return false;
409 }
410 return true; // But we should never get here
411 }
412
413 // Cache management
414 void registerCache(RooAbsCache &cache);
415 void unRegisterCache(RooAbsCache &cache);
416 Int_t numCaches() const;
418
419 /// Query the operation mode of this node.
420 inline OperMode operMode() const { return _operMode; }
421 /// Set the operation mode of this node.
422 void setOperMode(OperMode mode, bool recurseADirty = true);
423
424 // Dirty state modifiers
425 /// Mark the element dirty. This forces a re-evaluation when a value is requested.
427 {
428 if (_operMode == Auto && !inhibitDirty())
429 setValueDirty(nullptr);
430 }
431 /// Notify that a shape-like property (*e.g.* binning) has changed.
432 void setShapeDirty() { setShapeDirty(nullptr); }
433
434 const char *aggregateCacheUniqueSuffix() const;
435 virtual const char *cacheUniqueSuffix() const { return nullptr; }
436
437 void wireAllCaches();
438
441
442 /// Overwrite the current value stored in this object, making it look like this object computed that value.
443 // \param[in] value Value to store.
444 // \param[in] notifyClients Notify users of this object that they need to
445 /// recompute their values.
446 virtual void setCachedValue(double /*value*/, bool /*notifyClients*/ = true) {};
447
448 /// @}
449 ////////////////////////////////////////////////////////////////////////////
450
451 // Debug hooks
452 static void verboseDirty(bool flag);
453 void printDirty(bool depth = true) const;
454 static void setDirtyInhibit(bool flag);
455
456 void graphVizTree(const char *fileName, const char *delimiter = "\n", bool useTitle = false, bool useLatex = false);
457 void graphVizTree(std::ostream &os, const char *delimiter = "\n", bool useTitle = false, bool useLatex = false);
458
459 void printComponentTree(const char *indent = "", const char *namePat = nullptr, Int_t nLevel = 999);
460 void printCompactTree(const char *indent = "", const char *fileName = nullptr, const char *namePat = nullptr,
461 RooAbsArg *client = nullptr);
462 void printCompactTree(std::ostream &os, const char *indent = "", const char *namePat = nullptr,
463 RooAbsArg *client = nullptr);
464 virtual void printCompactTreeHook(std::ostream &os, const char *ind = "");
465
466 // We want to support three cases here:
467 // * passing a RooArgSet
468 // * passing a RooArgList
469 // * passing an initializer list
470 // Before, there was only an overload taking a RooArg set, which caused an
471 // implicit creation of a RooArgSet when a RooArgList was passed. This needs
472 // to be avoided, because if the passed RooArgList is owning the arguments,
473 // this information will be lost with the copy. The solution is to have one
474 // overload that takes a general RooAbsCollection, and one overload for
475 // RooArgList that is invoked in the case of passing an initializer list.
479
480 // Transfer the ownership of one or more other RooAbsArgs to this RooAbsArg
481 // via a `std::unique_ptr`.
482 template <typename... Args_t>
483 bool addOwnedComponents(std::unique_ptr<Args_t>... comps)
484 {
485 return addOwnedComponents({*comps.release()...});
486 }
487 const RooArgSet *ownedComponents() const { return _ownedComponents; }
488
490
491 void setWorkspace(RooWorkspace &ws) { _myws = &ws; }
492 inline RooWorkspace *workspace() const { return _myws; }
493
495 Int_t numProxies() const;
496 void setProxyNormSet(const RooArgSet *nset);
497
498 /// De-duplicated pointer to this object's name.
499 /// This can be used for fast name comparisons.
500 /// like `if (namePtr() == other.namePtr())`.
501 /// \note TNamed::GetName() will return a pointer that's
502 /// different for each object, but namePtr() always points
503 /// to a unique instance.
504 inline const TNamed *namePtr() const { return _namePtr; }
505
506 void SetName(const char *name) override;
507 void SetNameTitle(const char *name, const char *title) override;
508
510 {
511 _myws = &ws;
512 return false;
513 };
514
515 virtual bool canComputeBatchWithCuda() const { return false; }
516 virtual bool isReducerNode() const { return false; }
517
518 virtual void applyWeightSquared(bool flag);
519
520 virtual std::unique_ptr<RooAbsArg>
522
523 virtual bool isCategory() const { return false; }
524
525protected:
526 void graphVizAddConnections(std::set<std::pair<RooAbsArg *, RooAbsArg *>> &);
527
528 virtual void operModeHook() {};
529
530 virtual void optimizeDirtyHook(const RooArgSet * /*obs*/) {};
531
532 virtual bool isValid() const;
533
534 virtual void
535 getParametersHook(const RooArgSet * /*nset*/, RooArgSet * /*list*/, bool /*stripDisconnected*/) const {};
536
538 {
539 _valueDirty = false;
540 _shapeDirty = false;
541 }
542
543 void clearValueDirty() const { _valueDirty = false; }
544 void clearShapeDirty() const { _shapeDirty = false; }
545
546 /// Force element to re-evaluate itself when a value is requested.
547 void setValueDirty(const RooAbsArg *source);
548 /// Notify that a shape-like property (*e.g.* binning) has changed.
549 void setShapeDirty(const RooAbsArg *source);
550
551 virtual void ioStreamerPass2();
552 static void ioStreamerPass2Finalize();
553
554private:
555 void addParameters(RooAbsCollection &params, const RooArgSet *nset = nullptr, bool stripDisconnected = true) const;
556
558
559protected:
560 friend class RooAbsReal;
561
562 // Client-Server relation and Proxy management
563 friend class RooAbsCollection;
564 friend class RooWorkspace;
565 friend class RooRealIntegral;
566 RefCountList_t _serverList; // list of server objects
567 RefCountList_t _clientList; // list of client objects
568 RefCountList_t _clientListShape; // subset of clients that requested shape dirty flag propagation
569 RefCountList_t _clientListValue; // subset of clients that requested value dirty flag propagation
570
571 RooRefArray _proxyList; // list of proxies
572
573 std::vector<RooAbsCache *> _cacheList; ///<! list of caches
574
575 // Proxy management
576 friend class RooArgProxy;
577 template <class RooCollection_t>
578 friend class RooCollectionProxy;
579 friend class RooHistPdf;
580 friend class RooHistFunc;
587
588 // Attribute list
589 std::set<std::string> _boolAttrib; // Boolean attributes
590 std::map<std::string, std::string> _stringAttrib; // String attributes
591 std::set<std::string> _boolAttribTransient; ///<! Transient boolean attributes (not copied in ctor)
592
593 void printAttribList(std::ostream &os) const;
594
595 // Hooks for RooTreeData interface
597 friend class RooTreeDataStore;
598 friend class RooVectorDataStore;
599 friend class RooDataSet;
600 friend class RooRealMPFE;
601 virtual void syncCache(const RooArgSet *nset = nullptr) = 0;
602 virtual void copyCache(const RooAbsArg *source, bool valueOnly = false, bool setValDirty = true) = 0;
603
604 virtual void attachToTree(TTree &t, Int_t bufSize = 32000) = 0;
606 /// Attach this argument to the data store such that it reads data from there.
607 void attachToStore(RooAbsDataStore &store);
608
609 virtual void setTreeBranchStatus(TTree &t, bool active) = 0;
610 virtual void fillTreeBranch(TTree &t) = 0;
611 TString cleanBranchName() const;
612
613 // Global
614 friend std::ostream &operator<<(std::ostream &os, const RooAbsArg &arg);
615 friend std::istream &operator>>(std::istream &is, RooAbsArg &arg);
617
619 std::vector<RooAbsProxy *> cache;
620 bool isDirty = true;
621 };
622 ProxyListCache _proxyListCache; ///<! cache of the list of proxies. Avoids type casting.
623
624 // Debug stuff
625 static bool _verboseDirty; // Static flag controlling verbose messaging for dirty state changes
626 static bool _inhibitDirty; // Static flag controlling global inhibit of dirty state propagation
627 bool _deleteWatch = false; ///<! Delete watch flag
628
629 bool inhibitDirty() const;
630
631public:
634
635 /// Returns the token for retrieving results in the BatchMode. For internal use only.
636 std::size_t dataToken() const { return _dataToken; }
637 bool hasDataToken() const { return _dataToken != std::numeric_limits<std::size_t>::max(); }
638 void setDataToken(std::size_t index, RooFit::Evaluator *evaluator = nullptr);
640 {
641 _dataToken = std::numeric_limits<std::size_t>::max();
642 _evaluator = nullptr;
643 }
644
645protected:
646 mutable bool _valueDirty = true; // Flag set if value needs recalculating because input values modified
647 mutable bool _shapeDirty = true; // Flag set if value needs recalculating because input shapes modified
648
649 mutable OperMode _operMode = Auto; // Dirty state propagation mode
650 mutable bool _fast = false; // Allow fast access mode in getVal() and proxies
651
652 // Owned components
653 RooArgSet *_ownedComponents = nullptr; ///<! Set of owned component
654
655 mutable bool _prohibitServerRedirect = false; ///<! Prohibit server redirects -- Debugging tool
656
657 mutable RooExpensiveObjectCache *_eocache{nullptr}; ///<! Pointer to global cache manager for expensive components.
658
659 mutable const TNamed *_namePtr = nullptr; ///<! De-duplicated name pointer, equal for all objects with the same name.
660 bool _isConstant = false; ///<! Cached isConstant status
661
662 mutable bool _localNoInhibitDirty = false; ///<! Prevent 'AlwaysDirty' mode for this node
663
664 mutable RooWorkspace *_myws = nullptr; ///<! In which workspace do I live, if any
665
666 std::size_t _dataToken = std::numeric_limits<std::size_t>::max(); ///<! Set by the RooFitDriver for this arg to
667 ///<! retrieve its result in the run context
668 RooFit::Evaluator *_evaluator = nullptr; ///<! The Evaluator that set the data token and resets it in its destructor
669
670 /// \cond ROOFIT_INTERNAL
671 // Legacy streamers need the following statics:
672 friend class RooFitResult;
673
674public:
675 // Used internally for schema evolution.
677 /// \endcond
678
679private:
681 bool
683
684 ClassDefOverride(RooAbsArg, 9) // Abstract variable
685};
686
687std::ostream &operator<<(std::ostream &os, const RooAbsArg &arg);
688std::istream &operator>>(std::istream &is, RooAbsArg &arg);
689
690#endif
#define R__SUGGEST_ALTERNATIVE(ALTERNATIVE)
Definition RConfig.hxx:518
std::ostream & operator<<(std::ostream &os, const RooAbsArg &arg)
Ostream operator.
std::istream & operator>>(std::istream &is, RooAbsArg &arg)
Istream operator.
char Text_t
General string (char)
Definition RtypesCore.h:76
const char Option_t
Option string (const char)
Definition RtypesCore.h:80
#define ClassDefOverride(name, id)
Definition Rtypes.h:348
static void indent(ostringstream &buf, int indent_level)
ROOT::Detail::TRangeCast< T, true > TRangeDynCast
TRangeDynCast is an adapter class that allows the typed iteration through a TCollection.
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void data
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t index
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void value
Option_t Option_t TPoint TPoint const char mode
char name[80]
Definition TGX11.cxx:145
Common abstract base class for objects that represent a value and a "shape" in RooFit.
Definition RooAbsArg.h:77
RooExpensiveObjectCache & expensiveObjectCache() const
void setLocalNoDirtyInhibit(bool flag) const
Definition RooAbsArg.h:632
bool overlaps(const RooAbsArg &testArg, bool valueOnly=false) const
Test if any of the nodes of tree are shared with that of the given tree.
RooRefArray _proxyList
Definition RooAbsArg.h:571
void replaceServer(RooAbsArg &oldServer, RooAbsArg &newServer, bool valueProp, bool shapeProp)
Replace 'oldServer' with 'newServer', specifying whether the new server has value or shape server pro...
bool _isConstant
! Cached isConstant status
Definition RooAbsArg.h:660
void clearValueAndShapeDirty() const
Definition RooAbsArg.h:537
void Print(Option_t *options=nullptr) const override
Print the object to the defaultPrintStream().
Definition RooAbsArg.h:239
virtual void copyCache(const RooAbsArg *source, bool valueOnly=false, bool setValDirty=true)=0
bool dependsOn(const RooAbsCollection &serverList, const RooAbsArg *ignoreArg=nullptr, bool valueOnly=false) const
Test whether we depend on (ie, are served by) any object in the specified collection.
void attachToStore(RooAbsDataStore &store)
Attach this argument to the data store such that it reads data from there.
const TNamed * namePtr() const
De-duplicated pointer to this object's name.
Definition RooAbsArg.h:504
std::map< std::string, std::string > _stringAttrib
Definition RooAbsArg.h:590
const char * aggregateCacheUniqueSuffix() const
void printArgs(std::ostream &os) const override
Print object arguments, ie its proxies.
void printClassName(std::ostream &os) const override
Print object class name.
ProxyListCache _proxyListCache
! cache of the list of proxies. Avoids type casting.
Definition RooAbsArg.h:622
bool recursiveRedirectServers(const RooAbsCollection &newSet, bool mustReplaceAll=false, bool nameChange=false, bool recurseInNewSet=true)
Recursively replace all servers with the new servers in newSet.
RooWorkspace * _myws
! In which workspace do I live, if any
Definition RooAbsArg.h:664
~RooAbsArg() override
Destructor.
void resetDataToken()
Definition RooAbsArg.h:639
void attachDataStore(const RooAbsDataStore &set)
Replace server nodes with names matching the dataset variable names with those data set variables,...
bool addOwnedComponents(std::unique_ptr< Args_t >... comps)
Definition RooAbsArg.h:483
virtual bool operator==(const RooAbsArg &other) const =0
RooArgSet * _ownedComponents
! Set of owned component
Definition RooAbsArg.h:653
void printAddress(std::ostream &os) const override
Print address of this RooAbsArg.
void setShapeDirty()
Notify that a shape-like property (e.g. binning) has changed.
Definition RooAbsArg.h:432
virtual bool isCategory() const
Definition RooAbsArg.h:523
bool dependsOn(const RooAbsArg &server, const RooAbsArg *ignoreArg=nullptr, bool valueOnly=false) const
Test whether we depend on (ie, are served by) the specified object.
Definition RooAbsArg.h:123
virtual void setCachedValue(double, bool=true)
Overwrite the current value stored in this object, making it look like this object computed that valu...
Definition RooAbsArg.h:446
virtual void syncCache(const RooArgSet *nset=nullptr)=0
void registerProxy(RooArgProxy &proxy)
Register an RooArgProxy in the proxy list.
void setOperMode(OperMode mode, bool recurseADirty=true)
Set the operation mode of this node.
bool callRedirectServersHook(RooAbsCollection const &newSet, bool mustReplaceAll, bool nameChange, bool isRecursionStep)
Private helper function for RooAbsArg::redirectServers().
friend std::ostream & operator<<(std::ostream &os, const RooAbsArg &arg)
Ostream operator.
void setProhibitServerRedirect(bool flag)
Definition RooAbsArg.h:489
void attachArgs(const RooAbsCollection &set)
Bind this node to objects in set.
void setStringAttribute(const Text_t *key, const Text_t *value)
Associate string 'value' to this object under key 'key'.
bool isShapeServer(const RooAbsArg &arg) const
Check if this is serving shape to arg.
Definition RooAbsArg.h:162
bool isShapeDirty() const
Definition RooAbsArg.h:351
static void ioStreamerPass2Finalize()
Method called by workspace container to finalize schema evolution issues that cannot be handled in a ...
bool isValueDirtyAndClear() const
Definition RooAbsArg.h:373
virtual CacheMode canNodeBeCached() const
Definition RooAbsArg.h:347
bool isConstant() const
Check if the "Constant" attribute is set.
Definition RooAbsArg.h:284
bool _fast
Definition RooAbsArg.h:650
void setWorkspace(RooWorkspace &ws)
Definition RooAbsArg.h:491
virtual TObject * clone(const char *newname=nullptr) const =0
RooFit::OwningPtr< RooArgSet > getParameters(const RooAbsData *data, bool stripDisconnected=true) const
Create a list of leaf nodes in the arg tree starting with ourself as top node that don't match any of...
void addParameters(RooAbsCollection &params, const RooArgSet *nset=nullptr, bool stripDisconnected=true) const
Add all parameters of the function and its daughters to params.
const RooArgSet * ownedComponents() const
Definition RooAbsArg.h:487
void removeServer(RooAbsArg &server, bool force=false)
Unregister another RooAbsArg as a server to us, ie, declare that we no longer depend on its value and...
RooAbsArg & operator=(const RooAbsArg &other)=delete
RooFit::OwningPtr< RooArgSet > getObservables(const RooArgSet &set, bool valueOnly=true) const
Given a set of possible observables, return the observables that this PDF depends on.
void setTransientAttribute(const Text_t *name, bool value=true)
Set (default) or clear a named boolean attribute of this object.
void graphVizAddConnections(std::set< std::pair< RooAbsArg *, RooAbsArg * > > &)
Utility function that inserts all point-to-point client-server connections between any two RooAbsArgs...
void unRegisterProxy(RooArgProxy &proxy)
Remove proxy from proxy list.
virtual bool canComputeBatchWithCuda() const
Definition RooAbsArg.h:515
bool _shapeDirty
Definition RooAbsArg.h:647
const RefCountList_t & shapeClients() const
List of all shape clients of this object.
Definition RooAbsArg.h:143
void SetName(const char *name) override
Set the name of the TNamed.
RooSTLRefCountList< RooAbsArg > RefCountList_t
Definition RooAbsArg.h:79
const RefCountList_t & valueClients() const
List of all value clients of this object. Value clients receive value updates.
Definition RooAbsArg.h:140
friend std::istream & operator>>(std::istream &is, RooAbsArg &arg)
Istream operator.
virtual void setExpensiveObjectCache(RooExpensiveObjectCache &cache)
Definition RooAbsArg.h:440
void setDataToken(std::size_t index, RooFit::Evaluator *evaluator=nullptr)
Sets the token for retrieving results in the BatchMode.
virtual bool hasRange(const char *) const
Definition RooAbsArg.h:306
std::set< std::string > _boolAttrib
Definition RooAbsArg.h:589
void unRegisterCache(RooAbsCache &cache)
Unregister a RooAbsCache. Called from the RooAbsCache destructor.
RefCountList_t _clientListValue
Definition RooAbsArg.h:569
bool addOwnedComponents(const RooAbsCollection &comps)
Take ownership of the contents of 'comps'.
void printAttribList(std::ostream &os) const
Print the attribute list.
void printTree(std::ostream &os, TString indent="") const override
Print object tree structure.
void SetNameTitle(const char *name, const char *title) override
Set all the TNamed parameters (name and title).
const Text_t * getStringAttribute(const Text_t *key) const
Get string attribute mapped under key 'key'.
bool findConstantNodes(const RooArgSet &observables, RooArgSet &cacheList)
Find branch nodes with all-constant parameters, and add them to the list of nodes that can be cached ...
static bool _verboseDirty
Definition RooAbsArg.h:625
bool _deleteWatch
! Delete watch flag
Definition RooAbsArg.h:627
void addServerList(RooAbsCollection &serverList, bool valueProp=true, bool shapeProp=false)
Register a list of RooAbsArg as servers to us by calling addServer() for each arg in the list.
virtual bool readFromStream(std::istream &is, bool compact, bool verbose=false)=0
bool dependsOnValue(const RooAbsArg &server, const RooAbsArg *ignoreArg=nullptr) const
Check whether this object depends on values served from the object passed as server.
Definition RooAbsArg.h:114
bool redirectServers(const RooAbsCollection &newServerList, bool mustReplaceAll=false, bool nameChange=false, bool isRecursionStep=false)
Replace all direct servers of this object with the new servers in newServerList.
virtual bool isLValue() const
Is this argument an l-value, i.e., can it appear on the left-hand side of an assignment expression?...
Definition RooAbsArg.h:186
bool isValueServer(const char *name) const
Check if this is serving values to an object with name name.
Definition RooAbsArg.h:160
virtual RooFit::OwningPtr< RooAbsArg > createFundamental(const char *newname=nullptr) const =0
Create a fundamental-type object that stores our type of value.
static void setDirtyInhibit(bool flag)
Control global dirty inhibit mode.
virtual void serverNameChangeHook(const RooAbsArg *, const RooAbsArg *)
Definition RooAbsArg.h:198
virtual void printCompactTreeHook(std::ostream &os, const char *ind="")
Hook function interface for object to insert additional information when printed in the context of a ...
virtual void setCacheAndTrackHints(RooArgSet &)
Definition RooAbsArg.h:348
const std::set< std::string > & attributes() const
Definition RooAbsArg.h:259
bool isShapeServer(const char *name) const
Check if this is serving shape to an object with name name.
Definition RooAbsArg.h:164
const TNamed * _namePtr
! De-duplicated name pointer, equal for all objects with the same name.
Definition RooAbsArg.h:659
void printCompactTree(const char *indent="", const char *fileName=nullptr, const char *namePat=nullptr, RooAbsArg *client=nullptr)
Print tree structure of expression tree on stdout, or to file if filename is specified.
virtual std::unique_ptr< RooAbsArg > compileForNormSet(RooArgSet const &normSet, RooFit::Detail::CompileContext &ctx) const
virtual void getParametersHook(const RooArgSet *, RooArgSet *, bool) const
Definition RooAbsArg.h:535
RooWorkspace * workspace() const
Definition RooAbsArg.h:492
void clearValueDirty() const
Definition RooAbsArg.h:543
virtual void ioStreamerPass2()
Method called by workspace container to finalize schema evolution issues that cannot be handled in a ...
RooFit::OwningPtr< RooArgSet > getComponents() const
Create a RooArgSet with all components (branch nodes) of the expression tree headed by this object.
void wireAllCaches()
virtual bool importWorkspaceHook(RooWorkspace &ws)
Definition RooAbsArg.h:509
bool _valueDirty
Definition RooAbsArg.h:646
bool _prohibitServerRedirect
! Prohibit server redirects – Debugging tool
Definition RooAbsArg.h:655
virtual const char * cacheUniqueSuffix() const
Definition RooAbsArg.h:435
RefCountListLegacyIterator_t * makeLegacyIterator(const RefCountList_t &list) const
const RefCountList_t & servers() const
List of all servers of this object.
Definition RooAbsArg.h:146
std::size_t _dataToken
! Set by the RooFitDriver for this arg to ! retrieve its result in the run context
Definition RooAbsArg.h:666
bool dependsOnValue(const RooAbsCollection &serverList, const RooAbsArg *ignoreArg=nullptr) const
Check whether this object depends on values from an element in the serverList.
Definition RooAbsArg.h:105
void addServer(RooAbsArg &server, bool valueProp=true, bool shapeProp=false, std::size_t refCount=1)
Register another RooAbsArg as a server to us, ie, declare that we depend on it.
void removeStringAttribute(const Text_t *key)
Delete a string attribute with a given key.
Int_t Compare(const TObject *other) const override
Utility function used by TCollection::Sort to compare contained TObjects We implement comparison by n...
Int_t defaultPrintContents(Option_t *opt) const override
Define default contents to print.
virtual bool isDerived() const
Does value or shape of this arg depend on any other arg?
Definition RooAbsArg.h:98
virtual void attachToTree(TTree &t, Int_t bufSize=32000)=0
Overloadable function for derived classes to implement attachment as branch to a TTree.
void printComponentTree(const char *indent="", const char *namePat=nullptr, Int_t nLevel=999)
Print tree structure of expression tree on given ostream, only branch nodes are printed.
OperMode _operMode
Definition RooAbsArg.h:649
virtual void constOptimizeTestStatistic(ConstOpCode opcode, bool doAlsoTrackingOpt=true)
Interface function signaling a request to perform constant term optimization.
virtual bool isReducerNode() const
Definition RooAbsArg.h:516
void setValueDirty()
Mark the element dirty. This forces a re-evaluation when a value is requested.
Definition RooAbsArg.h:426
bool getAttribute(const Text_t *name) const
Check if a named attribute is set. By default, all attributes are unset.
bool isValueOrShapeDirtyAndClear() const
Definition RooAbsArg.h:391
bool hasDataToken() const
Definition RooAbsArg.h:637
RooAbsArg * findServer(const RooAbsArg &arg) const
Return server of this that has the same name as arg. Returns nullptr if not found.
Definition RooAbsArg.h:154
static void verboseDirty(bool flag)
Activate verbose messaging related to dirty flag propagation.
virtual bool inRange(const char *) const
Definition RooAbsArg.h:301
virtual void setTreeBranchStatus(TTree &t, bool active)=0
RooFit::OwningPtr< RooArgSet > getVariables(bool stripDisconnected=true) const
Return RooArgSet with all variables (tree leaf nodes of expression tree)
const std::map< std::string, std::string > & stringAttributes() const
Definition RooAbsArg.h:268
RooAbsCache * getCache(Int_t index) const
Return registered cache object by index.
virtual void writeToStream(std::ostream &os, bool compact) const =0
void printMultiline(std::ostream &os, Int_t contents, bool verbose=false, TString indent="") const override
Implement multi-line detailed printing.
virtual RooAbsArg * cloneTree(const char *newname=nullptr) const
Clone tree expression of objects.
void registerCache(RooAbsCache &cache)
Register RooAbsCache with this object.
virtual void optimizeCacheMode(const RooArgSet &observables)
Activate cache mode optimization with given definition of observables.
RefCountList_t _clientListShape
Definition RooAbsArg.h:568
virtual void attachToVStore(RooVectorDataStore &vstore)=0
TString cleanBranchName() const
Construct a mangled name from the actual name that is free of any math symbols that might be interpre...
bool inhibitDirty() const
bool observableOverlaps(const RooAbsData *dset, const RooAbsArg &testArg) const
Test if any of the dependents of the arg tree (as determined by getObservables) overlaps with those o...
void changeServer(RooAbsArg &server, bool valueProp, bool shapeProp)
Change dirty flag propagation mask for specified server.
RooAbsArg * findServer(Int_t index) const
Return i-th server from server list.
Definition RooAbsArg.h:156
Int_t numProxies() const
Return the number of registered proxies.
void printName(std::ostream &os) const override
Print object name.
bool hasClients() const
Definition RooAbsArg.h:129
const std::set< std::string > & transientAttributes() const
Definition RooAbsArg.h:277
const RefCountList_t & clients() const
List of all clients of this object.
Definition RooAbsArg.h:138
bool isValueDirty() const
Definition RooAbsArg.h:357
bool _localNoInhibitDirty
! Prevent 'AlwaysDirty' mode for this node
Definition RooAbsArg.h:662
virtual void printMetaArgs(std::ostream &) const
Definition RooAbsArg.h:250
virtual bool isIdentical(const RooAbsArg &other, bool assumeSameType=false) const =0
virtual void applyWeightSquared(bool flag)
Disables or enables the usage of squared weights.
static bool _inhibitDirty
Definition RooAbsArg.h:626
void setAttribute(const Text_t *name, bool value=true)
Set (default) or clear a named boolean attribute of this object.
void setProxyNormSet(const RooArgSet *nset)
Forward a change in the cached normalization argset to all the registered proxies.
std::size_t dataToken() const
Returns the token for retrieving results in the BatchMode. For internal use only.
Definition RooAbsArg.h:636
void branchNodeServerList(RooAbsCollection *list, const RooAbsArg *arg=nullptr, bool recurseNonDerived=false) const
Fill supplied list with all branch nodes of the arg tree starting with ourself as top node.
RefCountList_t _clientList
Definition RooAbsArg.h:567
void printDirty(bool depth=true) const
Print information about current value dirty state information.
RooAbsProxy * getProxy(Int_t index) const
Return the nth proxy from the proxy list.
TObject * Clone(const char *newname=nullptr) const override
Make a clone of an object using the Streamer facility.
Definition RooAbsArg.h:89
RefCountList_t _serverList
Definition RooAbsArg.h:566
void clearShapeDirty() const
Definition RooAbsArg.h:544
void leafNodeServerList(RooAbsCollection *list, const RooAbsArg *arg=nullptr, bool recurseNonDerived=false) const
Fill supplied list with all leaf nodes of the arg tree, starting with ourself as top node.
RooExpensiveObjectCache * _eocache
! Pointer to global cache manager for expensive components.
Definition RooAbsArg.h:657
virtual bool isFundamental() const
Is this object a fundamental type that can be added to a dataset? Fundamental-type subclasses overrid...
Definition RooAbsArg.h:176
virtual bool isValid() const
WVE (08/21/01) Probably obsolete now.
std::set< std::string > _boolAttribTransient
! Transient boolean attributes (not copied in ctor)
Definition RooAbsArg.h:591
friend class RooRealMPFE
Definition RooAbsArg.h:600
void printTitle(std::ostream &os) const override
Print object title.
virtual bool redirectServersHook(const RooAbsCollection &newServerList, bool mustReplaceAll, bool nameChange, bool isRecursiveStep)
Function that is called at the end of redirectServers().
virtual void fillTreeBranch(TTree &t)=0
std::vector< RooAbsCache * > _cacheList
! list of caches
Definition RooAbsArg.h:573
void graphVizTree(const char *fileName, const char *delimiter="\n", bool useTitle=false, bool useLatex=false)
Create a GraphViz .dot file visualizing the expression tree headed by this RooAbsArg object.
void substituteServer(RooAbsArg *oldServer, RooAbsArg *newServer)
Private helper function for RooAbsArg::redirectServers().
bool getTransientAttribute(const Text_t *name) const
Check if a named attribute is set.
virtual void operModeHook()
Definition RooAbsArg.h:528
virtual void optimizeDirtyHook(const RooArgSet *)
Definition RooAbsArg.h:530
bool recursiveCheckObservables(const RooArgSet *nset) const
Recursively call checkObservables on all nodes in the expression tree.
RooFit::Evaluator * _evaluator
! The Evaluator that set the data token and resets it in its destructor
Definition RooAbsArg.h:668
bool isValueServer(const RooAbsArg &arg) const
Check if this is serving values to arg.
Definition RooAbsArg.h:158
bool localNoDirtyInhibit() const
Definition RooAbsArg.h:633
Int_t numCaches() const
Return number of registered caches.
virtual bool checkObservables(const RooArgSet *nset) const
Overloadable function in which derived classes can implement consistency checks of the variables.
RooAbsArg()
Default constructor.
void attachDataSet(const RooAbsData &set)
Replace server nodes with names matching the dataset variable names with those data set variables,...
TIteratorToSTLInterface< RefCountList_t::Container_t > RefCountListLegacyIterator_t
Definition RooAbsArg.h:80
RooAbsArg * findServer(const char *name) const
Return server of this with name name. Returns nullptr if not found.
Definition RooAbsArg.h:148
void treeNodeServerList(RooAbsCollection *list, const RooAbsArg *arg=nullptr, bool doBranch=true, bool doLeaf=true, bool valueOnly=false, bool recurseNonDerived=false) const
Fill supplied list with nodes of the arg tree, following all server links, starting with ourself as t...
bool IsSortable() const override
Definition RooAbsArg.h:291
RooAbsArg * findNewServer(const RooAbsCollection &newSet, bool nameChange) const
Find the new server in the specified set that matches the old server.
OperMode operMode() const
Query the operation mode of this node.
Definition RooAbsArg.h:420
Abstract base class for data members of RooAbsArgs that cache other (composite) RooAbsArg expressions...
Definition RooAbsCache.h:27
Abstract container object that can hold multiple RooAbsArg objects.
Abstract base class for a data collection.
Abstract base class for binned and unbinned datasets.
Definition RooAbsData.h:56
Abstract interface for proxy classes.
Definition RooAbsProxy.h:37
Abstract base class for objects that represent a real value and implements functionality common to al...
Definition RooAbsReal.h:63
RooArgList is a container object that can hold multiple RooAbsArg objects.
Definition RooArgList.h:22
Abstract interface for RooAbsArg proxy classes.
Definition RooArgProxy.h:24
RooArgSet is a container object that can hold multiple RooAbsArg objects.
Definition RooArgSet.h:24
Concrete proxy for RooArgSet or RooArgList objects.
Combines several disjunct datasets into one.
Container class to hold unbinned data.
Definition RooDataSet.h:32
Singleton class that serves as repository for objects that are expensive to calculate.
RooFitResult is a container class to hold the input and output of a PDF fit to a dataset.
Evaluates a RooAbsReal object in other ways than recursive graph traversal.
Definition Evaluator.h:35
A real-valued function sampled from a multidimensional histogram.
Definition RooHistFunc.h:31
A probability density function sampled from a multidimensional histogram.
Definition RooHistPdf.h:30
Collection class for internal use, storing a collection of RooAbsArg pointers in a doubly linked list...
A 'mix-in' base class that define the standard RooFit plotting and printing methods.
virtual StyleOption defaultPrintStyle(Option_t *opt) const
static std::ostream & defaultPrintStream(std::ostream *os=nullptr)
Return a reference to the current default stream to use in Print().
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,...
Performs hybrid numerical/analytical integrals of RooAbsReal objects.
RooRefArray()=default
RooRefArray & operator=(const RooRefArray &other)=default
void Streamer(TBuffer &) override
Stream an object of class RooRefArray.
RooRefArray(const RooRefArray &other)
Definition RooAbsArg.h:64
TTree-backed data storage.
Uses std::vector to store data columns.
Persistable container for RooFit projects.
Buffer base class used for serializing objects.
Definition TBuffer.h:43
The TNamed class is the base class for all named ROOT classes.
Definition TNamed.h:29
An array of TObjects.
Definition TObjArray.h:31
Mother of all ROOT objects.
Definition TObject.h:42
An array of references to TObjects.
Definition TRefArray.h:33
Basic string class.
Definition TString.h:138
A TTree represents a columnar dataset.
Definition TTree.h:89
The namespace RooFit contains mostly switches that change the behaviour of functions of PDFs (or othe...
Definition CodegenImpl.h:72
T * OwningPtr
An alias for raw pointers for indicating that the return type of a RooFit function is an owning point...
Definition Config.h:35
std::vector< RooAbsProxy * > cache
Definition RooAbsArg.h:619