Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
RooAddPdf.h
Go to the documentation of this file.
1/*****************************************************************************
2 * Project: RooFit *
3 * Package: RooFitCore *
4 * File: $Id: RooAddPdf.h,v 1.46 2007/07/12 20:30: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_ADD_PDF
17#define ROO_ADD_PDF
18
19#include "RooAbsPdf.h"
20#include "RooListProxy.h"
21#include "RooSetProxy.h"
22#include "RooAICRegistry.h"
23#include "RooObjCacheManager.h"
24#include "RooNameReg.h"
25
26#include <vector>
27#include <list>
28#include <utility>
29
30class AddCacheElem;
31
32class RooAddPdf : public RooAbsPdf {
33public:
34
36 RooAddPdf(const char *name, const char *title=nullptr);
37 RooAddPdf(const char *name, const char *title,
38 RooAbsPdf& pdf1, RooAbsPdf& pdf2, RooAbsReal& coef1) ;
39 RooAddPdf(const char *name, const char *title, const RooArgList& pdfList) ;
40 RooAddPdf(const char *name, const char *title, const RooArgList& pdfList, const RooArgList& coefList, bool recursiveFraction=false) ;
41
42 RooAddPdf(const RooAddPdf& other, const char* name=nullptr) ;
43 TObject* clone(const char* newname=nullptr) const override { return new RooAddPdf(*this,newname) ; }
44 ~RooAddPdf() override {}
45
46 bool checkObservables(const RooArgSet* nset) const override;
47
48 /// Force RooRealIntegral to offer all observables for internal integration.
49 bool forceAnalyticalInt(const RooAbsArg& /*dep*/) const override {
50 return true ;
51 }
52 Int_t getAnalyticalIntegralWN(RooArgSet& allVars, RooArgSet& numVars, const RooArgSet* normSet, const char* rangeName=nullptr) const override;
53 double analyticalIntegralWN(Int_t code, const RooArgSet* normSet, const char* rangeName=nullptr) const override;
54 bool selfNormalized() const override {
55 // P.d.f is self normalized
56 return true ;
57 }
58
59 ExtendMode extendMode() const override {
60 // Return extended mode capabilities
62 }
63 /// Return expected number of events for extended likelihood calculation, which
64 /// is the sum of all coefficients.
65 double expectedEvents(const RooArgSet* nset) const override;
66
67 std::unique_ptr<RooAbsReal> createExpectedEventsFunc(const RooArgSet* nset) const override;
68
69 const RooArgList& pdfList() const {
70 // Return list of component p.d.fs
71 return _pdfList ;
72 }
73 const RooArgList& coefList() const {
74 // Return list of coefficients of component p.d.f.s
75 return _coefList ;
76 }
77
79 void fixCoefRange(const char* rangeName) ;
80
81 const RooArgSet& getCoefNormalization() const;
83
84 void resetErrorCounters(Int_t resetValue=10) override;
85
86 std::list<double>* plotSamplingHint(RooAbsRealLValue& obs, double xlo, double xhi) const override;
87 std::list<double>* binBoundaries(RooAbsRealLValue& /*obs*/, double /*xlo*/, double /*xhi*/) const override;
88 bool isBinnedDistribution(const RooArgSet& obs) const override;
89
90 void printMetaArgs(std::ostream& os) const override;
91
92 CacheMode canNodeBeCached() const override { return RooAbsArg::NotAdvised ; };
93 void setCacheAndTrackHints(RooArgSet&) override;
94
95 std::unique_ptr<RooAbsArg> compileForNormSet(RooArgSet const &normSet, RooFit::Detail::CompileContext & ctx) const override;
96
97 protected:
98 void selectNormalization(const RooArgSet* depSet=nullptr, bool force=false) override;
99 void selectNormalizationRange(const char* rangeName=nullptr, bool force=false) override;
100
101 mutable RooSetProxy _refCoefNorm ; ///< Reference observable set for coefficient interpretation
102 mutable TNamed* _refCoefRangeName = nullptr ; ///< Reference range name for coefficient interpretation
103
104 mutable std::vector<double> _coefCache; ///<! Transient cache with transformed values of coefficients
105
106
107 mutable RooObjCacheManager _projCacheMgr ; ///<! Manager of cache with coefficient projections and transformations
108 AddCacheElem* getProjCache(const RooArgSet* nset, const RooArgSet* iset=nullptr) const ;
109 void updateCoefficients(AddCacheElem& cache, const RooArgSet* nset, bool syncCoefValues=true) const ;
110
111
112 friend class RooAddGenContext ;
113 friend class RooAddModel ;
114 RooAbsGenContext* genContext(const RooArgSet &vars, const RooDataSet *prototype=nullptr,
115 const RooArgSet* auxProto=nullptr, bool verbose= false) const override;
116
117
118 double evaluate() const override {
119 return getValV(nullptr);
120 }
121 double getValV(const RooArgSet* set=nullptr) const override ;
122 void doEval(RooFit::EvalContext &) const override;
123 inline bool canComputeBatchWithCuda() const override { return true; }
124
125
126 mutable RooAICRegistry _codeReg; ///<! Registry of component analytical integration codes
127
128 RooListProxy _pdfList ; ///< List of component PDFs
129 RooListProxy _coefList ; ///< List of coefficients
130 mutable RooArgList* _snormList{nullptr}; ///<! List of supplemental normalization factors
131
132 bool _haveLastCoef = false; ///< Flag indicating if last PDFs coefficient was supplied in the constructor
133 bool _allExtendable = false; ///< Flag indicating if all PDF components are extendable
134 bool _recursive = false; ///< Flag indicating is fractions are treated recursively
135
136 mutable Int_t _coefErrCount ; ///<! Coefficient error counter
137
138 bool redirectServersHook(const RooAbsCollection&, bool, bool, bool) override;
139
140private:
141 std::pair<const RooArgSet*, AddCacheElem*> getNormAndCache(const RooArgSet* nset) const;
143 mutable std::unique_ptr<const RooArgSet> _copyOfLastNormSet = nullptr; ///<!
144
147
148 ClassDefOverride(RooAddPdf,5) // PDF representing a sum of PDFs
149};
150
151#endif
#define ClassDefOverride(name, id)
Definition Rtypes.h:348
ROOT::Detail::TRangeCast< T, true > TRangeDynCast
TRangeDynCast is an adapter class that allows the typed iteration through a TCollection.
char name[80]
Definition TGX11.cxx:148
Utility class for operator p.d.f classes that keeps track of analytical integration codes and associa...
Common abstract base class for objects that represent a value and a "shape" in RooFit.
Definition RooAbsArg.h:76
Abstract container object that can hold multiple RooAbsArg objects.
Abstract base class for generator contexts of RooAbsPdf objects.
Abstract interface for all probability density functions.
Definition RooAbsPdf.h:32
@ MustBeExtended
Definition RooAbsPdf.h:208
@ CanNotBeExtended
Definition RooAbsPdf.h:208
Abstract base class for objects that represent a real value that may appear on the left hand side of ...
Abstract base class for objects that represent a real value and implements functionality common to al...
Definition RooAbsReal.h:63
friend class AddCacheElem
Definition RooAbsReal.h:407
Efficient implementation of the generator context specific for RooAddPdf PDFs.
RooAddModel is an efficient implementation of a sum of PDFs of the form.
Definition RooAddModel.h:27
Efficient implementation of a sum of PDFs of the form.
Definition RooAddPdf.h:32
RooListProxy _coefList
List of coefficients.
Definition RooAddPdf.h:129
RooArgList * _snormList
! List of supplemental normalization factors
Definition RooAddPdf.h:130
bool _allExtendable
Flag indicating if all PDF components are extendable.
Definition RooAddPdf.h:133
void doEval(RooFit::EvalContext &) const override
Compute addition of PDFs in batches.
RooAICRegistry _codeReg
! Registry of component analytical integration codes
Definition RooAddPdf.h:126
RooFit::UniqueId< RooArgSet >::Value_t _idOfLastUsedNormSet
!
Definition RooAddPdf.h:142
double analyticalIntegralWN(Int_t code, const RooArgSet *normSet, const char *rangeName=nullptr) const override
Return analytical integral defined by given scenario code.
const char * getCoefRange() const
Definition RooAddPdf.h:82
std::unique_ptr< const RooArgSet > _copyOfLastNormSet
!
Definition RooAddPdf.h:143
void updateCoefficients(AddCacheElem &cache, const RooArgSet *nset, bool syncCoefValues=true) const
Update the coefficient values in the given cache element: calculate new remainder fraction,...
Int_t _coefErrCount
! Coefficient error counter
Definition RooAddPdf.h:136
bool canComputeBatchWithCuda() const override
Definition RooAddPdf.h:123
bool _haveLastCoef
Flag indicating if last PDFs coefficient was supplied in the constructor.
Definition RooAddPdf.h:132
void selectNormalization(const RooArgSet *depSet=nullptr, bool force=false) override
Interface function used by test statistics to freeze choice of observables for interpretation of frac...
void printMetaArgs(std::ostream &os) const override
Customized printing of arguments of a RooAddPdf to more intuitively reflect the contents of the produ...
void finalizeConstruction()
void setCacheAndTrackHints(RooArgSet &) override
Label OK'ed components of a RooAddPdf with cache-and-track.
const RooArgList & coefList() const
Definition RooAddPdf.h:73
bool _recursive
Flag indicating is fractions are treated recursively.
Definition RooAddPdf.h:134
RooObjCacheManager _projCacheMgr
! Manager of cache with coefficient projections and transformations
Definition RooAddPdf.h:107
void materializeRefCoefNormFromAttribute() const
RooAbsGenContext * genContext(const RooArgSet &vars, const RooDataSet *prototype=nullptr, const RooArgSet *auxProto=nullptr, bool verbose=false) const override
Return specialized context to efficiently generate toy events from RooAddPdfs return RooAbsPdf::genCo...
bool checkObservables(const RooArgSet *nset) const override
Check if PDF is valid for given normalization set.
bool selfNormalized() const override
Shows if a PDF is self-normalized, which means that no attempt is made to add a normalization term.
Definition RooAddPdf.h:54
void fixCoefNormalization(const RooArgSet &refCoefNorm)
By default the interpretation of the fraction coefficients is performed in the contextual choice of o...
std::pair< const RooArgSet *, AddCacheElem * > getNormAndCache(const RooArgSet *nset) const
Look up projection cache and per-PDF norm sets.
RooSetProxy _refCoefNorm
Reference observable set for coefficient interpretation.
Definition RooAddPdf.h:101
void selectNormalizationRange(const char *rangeName=nullptr, bool force=false) override
Interface function used by test statistics to freeze choice of range for interpretation of fraction c...
Int_t getAnalyticalIntegralWN(RooArgSet &allVars, RooArgSet &numVars, const RooArgSet *normSet, const char *rangeName=nullptr) const override
Determine which part (if any) of given integral can be performed analytically.
void resetErrorCounters(Int_t resetValue=10) override
Reset error counter to given value, limiting the number of future error messages for this pdf to 'res...
ExtendMode extendMode() const override
Returns ability of PDF to provide extended likelihood terms.
Definition RooAddPdf.h:59
bool forceAnalyticalInt(const RooAbsArg &) const override
Force RooRealIntegral to offer all observables for internal integration.
Definition RooAddPdf.h:49
double expectedEvents(const RooArgSet *nset) const override
Return expected number of events for extended likelihood calculation, which is the sum of all coeffic...
double getValV(const RooArgSet *set=nullptr) const override
Calculate and return the current value.
double evaluate() const override
Evaluate this PDF / function / constant. Needs to be overridden by all derived classes.
Definition RooAddPdf.h:118
std::unique_ptr< RooAbsArg > compileForNormSet(RooArgSet const &normSet, RooFit::Detail::CompileContext &ctx) const override
void fixCoefRange(const char *rangeName)
By default, fraction coefficients are assumed to refer to the default fit range.
CacheMode canNodeBeCached() const override
Definition RooAddPdf.h:92
AddCacheElem * getProjCache(const RooArgSet *nset, const RooArgSet *iset=nullptr) const
Retrieve cache element for the computation of the PDF normalisation.
TObject * clone(const char *newname=nullptr) const override
Definition RooAddPdf.h:43
std::list< double > * plotSamplingHint(RooAbsRealLValue &obs, double xlo, double xhi) const override
Loop over components for plot sampling hints and merge them if there are multiple.
RooListProxy _pdfList
List of component PDFs.
Definition RooAddPdf.h:128
TNamed * _refCoefRangeName
Reference range name for coefficient interpretation.
Definition RooAddPdf.h:102
const RooArgList & pdfList() const
Definition RooAddPdf.h:69
std::unique_ptr< RooAbsReal > createExpectedEventsFunc(const RooArgSet *nset) const override
Returns an object that represents the expected number of events for a given normalization set,...
bool isBinnedDistribution(const RooArgSet &obs) const override
If all components that depend on obs are binned, so is their sum.
bool redirectServersHook(const RooAbsCollection &, bool, bool, bool) override
Hook function intercepting redirectServer calls.
~RooAddPdf() override
Definition RooAddPdf.h:44
std::vector< double > _coefCache
! Transient cache with transformed values of coefficients
Definition RooAddPdf.h:104
const RooArgSet & getCoefNormalization() const
std::list< double > * binBoundaries(RooAbsRealLValue &, double, double) const override
Loop over components for plot sampling hints and merge them if there are multiple.
RooArgList is a container object that can hold multiple RooAbsArg objects.
Definition RooArgList.h:22
RooArgSet is a container object that can hold multiple RooAbsArg objects.
Definition RooArgSet.h:24
Container class to hold unbinned data.
Definition RooDataSet.h:32
static const char * str(const TNamed *ptr)
Return C++ string corresponding to given TNamed pointer.
Definition RooNameReg.h:39
Implementation of a RooCacheManager<RooAbsCacheElement> that specializes in the storage of cache elem...
The TNamed class is the base class for all named ROOT classes.
Definition TNamed.h:29
Mother of all ROOT objects.
Definition TObject.h:42
A UniqueId can be added as a class member to enhance any class with a unique identifier for each inst...
Definition UniqueId.h:39
unsigned long Value_t
Definition UniqueId.h:41