[root] Log of /trunk/roofit/roofitcore/inc/RooRealBinding.h

Revision 24119 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Tue Jun 3 18:42:54 2008 UTC (6 years, 7 months ago) by wouter
File length: 2166 byte(s)
Diff to previous 23538

   o RooAbsSelfCachedPdf

     - Follow changes in RooAbsCachedPdf 


   o RooCachedPdf

     - Add option to override default choice of cache observables
       (the normalization observables) with a specific set of variables
       to make it possible to also cache p.d.f values for all values
       of given parameters as well.

     - Forward analytical integration capabilities to actual cache p.d.f

     - Forward calls on preferred observable order to cached p.d.f


   o RooDataHist
       
     - Add option to bin dataset in alternate binning configuration, as 
       specified by binning name in constructor.

     - Add feature to weight() function to enforce special boundaries
       when interpolating a histogram representing a cumulative distribution function. 
       If so, lower-side bounds are forced to zero and upper-side bounds are
       forced to 1.0 instead of the default mirroring strategy


   o RooMsgService

     - Add new topic NumericIntegration

     - Show PROGRESS level messages by default


   o RooAbsSelfCachedReal

     - New base class for self-caching RooAbsReal objects analoguous
       to RooAbsSelfCachedPdf


   o RooCachedReal

     - New class to cache arbitrary RooAbsReal function objects,
       analogous to RooAbsCachedPdf


   o RooRealBinding

     - Add feature to save and restore values of input variables,
       used by RooRealIntegral to restore observable values after numeric
       integration to original values.


   o RooLinearMorph

     - New operator p.d.f class implementing using the algorithm described
       by Alex Read in NUM A 425 (1999) 357-369 'Linear interpolation of histograms'.
       This class implements a generalization for continuous p.d.f 


   o RooAbsRealLValue

     - Following changes in RooAbsLValue

 
   o RooHistFunc

     - Real-valued function modeled by external RooDataHist object, analoguous to RooHistPdf,
       but without normalization support and allowing negative histogram values


   o RooAbsCachedReal

     - New abstract base class for caching functions, analoguous to RooAbsCachedPdf.
       

   o RooFracRemainder

     - New dedicated helper class to calculate the remainder fraction of a RooAddPdf, i.e. 1-sum(i)x_i
       for a given RooArgSet x


   o RooCustomizer

     - Fix memory management issue for sterile use


   o RooAbsCategoryLValue

     - Follow changes in RooAbsLValue


   o RooNumCdf

     - Specialization of RooNumRunningInt to calculate running integrals of p.d.f.s:
       the running integral is by construction normalized to one exactly, taking out
       any possible imprecisions in the regular integral calculation and by imposing
       special constraints on the RooHistFunc that models the output so that the boundaries
       are constrained to exactly 0 and 1 when interpolation is used.


   o RooFFTConv

     - Fix bug in cache naming algorithm

     - Follow changes in RooAbsCachedPdf


   o RooChangeTracker

     - New special purpose object that tracks changes in a given set of variables, used
       to determine if cached p.d.fs in RooAbsCachedPdf and RooAbsCachedReal need to
       be recalculated due to parameter changes. In addition to valueDirty tracking,
       an explicit comparison can be made to stored reference values of variables,
       to avoid recalculation of expensive quantities in case a valueDirty is propagated
       even if the value did not change (this can e.g. happen when you step though
       a RooDataHist where usually only one of the observables changes value, but
       all observables propagate a valueDirty every time)


   o RooHist

     - Bug fix in makeResidual()


   o RooAbsReal

     - Fix small memory leak in createIntegral

     - Expand functionality of fillDataHist: optional correction for binVolume
       when filling, and optional progress indication.

     - Modify logEvalError() so that when cumulative logging for Minuit is disabled
       that messages are printed through the standard message logging service.

     - Modify error logging so that name of objects are stored in addition to 
       pointers so that delayed logging of errors of (cache) objects that no
       longer exists can be performed correctly.

     - Add virtual function preferredObservableScanOrder() to indicate preferred
       order in which multi-dimensional functions should be scanned into a 
       RooHistPdf, which may matter greatly for the performance of certain
       p.d.f.s like RooFFTConvPdf and RooLinearMorph

     - Add new function createRunningIntegral() which constructs for a given F(x,y) 
       a Int[xlo,x] F(x',y) dx. The default strategy is to construct the underlying
       integral with createIntegral() and adapt it with a RooCustomizer and a RooParamBinning
       to a running integral. In case it concerns a one-dimensional numeric running
       integral, the running integral is represented by a dedicated class RooNumRunningInt
       which scans the integrand and numerically integrates the scanned histogram


   o RooAbsCollection

     - Bug fix in nameFieldLength handling of print routine


   o RooAbsCachedPdf

     - Introduce explicitly the strategy that the cache contains the _normalized_ p.d.f. values,
       so that no postior normalization integral is required. This has the added advantages that
       the cache p.d.f can be instructed to consider itself normalized skipping an explicit
       normalization step in the RooHistPdf.

     - Add utility function getCachePdf() and getCacheHist() to retrieve cache p.d.f and histogram
       for a given choice of normalization set

     - Clean up structure of CacheElem nested class by making guts private and providing accessor
       function for derived CacheElem classes. Virtualize cache creation with a new member function 
       createCache that will allow derived classes to create a derived CacheElem.

     - Forward integration handling to cache pdf actually being used


   o RooDataHistSliceIter

     - Follow changes in RooDataHist for alternate binning 


   o RooRealMPFE

     - Follow changes in eval error logging in RooAbsReal


   o RooAbsPdf

     - Add createCdf() function to create cumulative distribution functions from p.d.f.s. This is 
       quite similar to RooAbsReal::createRunningIntegral() but with some c.d.f specific features
       related to constraints on normalization


   o RooAbsArg 

     - Fix bug in optimizeCacheMode()


   o RooBrentRootFinder

     - Improve error messaging through RooMsgService interface.


   o RooCmdArg

     - Expand payload from 2 to 3 strings


   o RooSimWSTool

     - Complete rewrite of RooSimPdfBuilder integrated with RooWorkspace for object storage.


   o RooNumRunningInt

     - New dedicated class to calculate running integral of any function that does not have
       an analytical integral implementation. This class scans such a function in a histogram
       and then numerically integrates the histogram. The filling of the histogram is performed
       adaptively using a recursion division strategy with a precision cutoff to save time
       of the filling of smooth functions in finely binned histograms


   o RooMultiCategory, RooSuperCategory

     - Minor tweak in name of proxies


   o RooAbsIntegrator

     - Deploy save and restore functionality of RooAbsFunc/RooRealBinding to restore observable
       values to prior values after an intergration step. 


   o RooMinuit

     - Fix gcc 4.3 compiler warning


   o RooWorkspace

     - Add bulk import() function taking a const RooArgSet instead of a RooAbsArg
 
     - Add RecycleConflictNodes() option to ignore conflicts and simply recycle internal
       nodes when a different external node is encountered.

     - Add new accessors catfunc() for category functions, arg() for generic RooAbsArgs,
       and funcArg() for fundamental arguments of any type.

     - Add separate section for category functions in Print()


   o RooHistPdf

     - Add option to declare contents unit normalized. When activated, the analytical
       integral is hardwired to 1. 

     - Add option to propagate cdfBoundaries mode to the underlying RooDataHist.


   o RooAbsOptTestStatistic

     - Optimize handling of empty rangeName specification (from Alfio)


   o RooSimultaneous

     - Tune proxy names

     - Make p.d.f return zero, in case index category is in state where no p.d.f is assigned,
       rather that assert(0)


   o LinkDef3.h, Module.mk

     - Add new class definitions

Revision 23538 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Apr 24 21:02:00 2008 UTC (6 years, 9 months ago) by wouter
File length: 2064 byte(s)
Diff to previous 23134

Import changes from development branch

==== Date: Wed Feb 20 22:33:28 2008 =====

   o RooRealSumPdf

     - Do _not_ use normalization of RooAbsPdf input components
       in numerator of RooRealSumPdf expression since it is 
       already explicitly occurring in denominator of RooRealSumPdf.
       (Fixes wrong normalization reported by Tristan)


   o RooObjCacheManager

     - Register owner of cache with each cache elememt to
       facilitate callbacks


   o RooAbsCacheElement

     - Add storage for pointer to owner of cache and
       supply setOwner() function


   o RooAbsPdf

     - Use RooObjCacheManager callback mechanism to zero
       'last used normalization' pointer in RooAbsPdf
       when the cache-owned object pointed is about
       to be deleted. 


   o RooAbsArg

     - Make crc32 function static


   o RooWorkspace

     - Add CodeRepo nested class that allows to store C++ code
       of RooAbsArg derived classes that are not in ROOT distribution
       but are contained in workspace. When reading any missing
       class, code is compiled on the fly allowing for transparent
       reading of workspace object from file. Code is found in
       location pointed to from TClass objects. Additional search
       path for declaration and implementation files can be provided
       to be able to handle non-trivial cases.

     - Add WSDir nested class that represents information contained
       in workspace as read-only TDirectory for easy interactive use. 
       Directory representation is created using makeDir() member function.


  o LinkDef3

     - Add nested classes in RooWorkspace

===== Date: Wed Mar 26 23:04:26 2008 =====

   o RooProdPdf

     - Fix typo in ctor documentaion

     - Improve error message in expectedEvents() when no extendable p.d.f.s are found

     - Implement getConstraints() function to retrieve constraint p.d.f terms from product
       expression given set of observables and set of parameters to be constrained.


   o RooMsgService

     - Add PROGRESS message level between INFO and WARNING

     - Add globalKill level for messages to be able to quickly eliminate all messages below
       a given level without interfering with the stream structore of RooMsgService


   o RooPrintable

     - Implement new printing interface with more details control over items printed trhough contents enum
       (multiple ORable options) and style of printing (inline, single line, (verbose) multiline) with style 
       enum (exclusive options). 

     - Introduce generic virtual functions for printing of name,title,value,arguments,
       and extras of each object. 

     - Each class can overload the default contents used for all printing
       uses (inline,verbose,standard) etc as well as the default printing style invoked by Print()


   o RooPlot,RooGenContext, RooAbsRealLValue,RooDataSet,RooNameSet,RooCustomizer, RooAbsGenContext, RooAddModel,
     RooFitResult,RooCurve,RooAbsAnaConv,RooHist,RooAbsReal,RooAbsCollection,RooAddPdf,RooTable,RooAbsData,
     RooMappedCategory,RooFormula,RooFormulaVar,RooCatType,RooRealVar,RooAbsArg,RooAbsPdf,RooPlotable,RooRealIntegral,
     RooAbsBinning,Roo1DTable,RooAddGenContext,RooGenericPdf,RooResolutionMode,RooAbsHiddenReal,RooMultiCategory,
     RooAbsString,RooSetProxy,RooProdGenContext,RooConvGenContext,RooGenCategory,RooGrid,RooSimGenContext,
     RooThresholdCategory,RooAcceptReject,RooSuperCategory,RooEllipse,RooNumIntConfig,RooAbsCategory,RooListProxy,
     RooLinearVar,RooTreeData,RooTreeData

     - Update to new RooPrintable interface


   o RooGenContext,RooAbsGenContext,RooAddGenContext,RooProdGenContext,RooConvGenContext,RooSimGenContext

     - Implement attach() function to simplify management of changing parameters during lifetime of context


   o RooAbsRealLValue

     - Eliminate inFitRange() warning message as it is gives too many false warnings when used with
       parameterized ranges


   o RooCustomizer

     - Make owning of contents optional to simplify release of created components
     

   o RooAbsReal

     - Implement new evaluation error logging mechanism. Rather than passing zero p.d.f values, push error message with
       details on a static stack (if logging is enabled by e.g. RooMinuit). 

     - Augment functionality of createIntegral: explicitly allow integration over ranges with bounds parameterized in 
       in terms of other integrated observables. Integrals of this type are automatically recognized and cast
       as recursive integrals in case of >1-D integrals to integrate over requested phase space. 

     - Add createIntObj() helper function for above functionaliy.

     - Eliminate a lot of commented out debug code from createPlotProjection()

     - Modify fillHistogram(): when plot observables are cloned, explicitly interconnect clones again to facilitate
       proper plotting of N-D integrals with entangled parameterized ranges

     - Add ScaleFactor() argument to fillHistogram to control use of histogram density correction scale factor in Z-scale
       of filled histogram


   o RooProduction

     - Fix bug for persistence


   o RooRealMPFE

     - Extend client/server protocol with message to retrieve RooAbsReal evaluation error log from server side and
       merge with error log on client side


   o RooRealVar

     - Introduced concept of non-shared alternative binnings(ranges) required to accommodate RooParamBinning ranges
       that cannot be shared across instances because of their client/server connection to other objects in p.d.f
       expression trees. Modify setBinning to automatically recognize non-shareable binnings and divert those to
       non-shared alternative binning container.

     - Add setRange([const char*,] RooAbsReal&,RooAbsReal&) methods to simplify creation of parameterized ranges.


   o RooAbsArg

     - Introduce concept of owned components with addOwnedComponents() interface to be able to make any RooAbsArg
       object own any number of others. This can be used to simplify the memory management of object trees 

     - Introduce prohibitServerRedirect mode that will trigger fatal assert if any server redirect is attempted
       to thus configured object. Useful as debugging tool to track faulty copy constructors that leave clone
       object tree unintentionally connected to the original object tree.

     - Migrate fixed--name-field management tool from RooAbsReal to RooAbsArg. Used to accomplish regular
       formatting in RooAbsCollection::printStream.

     - Add concept of transient boolean attributes that are not tranferred on copy construction. Mostly useful
       for debugging.

     - Extend leafNodeServerList and treeNodeServerList to distinguish to types of leaf-nodes: strict leaf modes
       in the sense of the client-server tree structure and 'physical' leaf nodes that do not recurse into
       nodes that have isDerived()==kFalse. The latter corresponds to the original concept of leaf nodes / variables,
       which the former mode, a new addition, explicitly exposes any shape servers contained in parameterized
       ranges of variables.

     - Fix logic error in recursiveServerRedirect: do not recurse into nodes that are in the replacement list themselves.

     - Fix bug in printCompactTree(): value/shape clients were not always properly indicated.

     - Add getAllConstraints() method that finds all RooProdPdfs in expression trees and harvest constraints from all
       of these from the getConstraint() method


   o RooAbsPdf

     - Implement new evaluation error logging mechanism for negative p.d.f values and zero normalization integrals

     - Add Constrain(const RooArgSet& pars) and ExternalConstraints(const RooArgSet& pdfs) arguments to fitTo() method.
       The Constrain() method retrieves any constraints p.d.f. on parameters multiplied in any RooProdPdf in the normal 
       p.d.f expression and adds those to the likelihood that is minimized. Only constraints on the listed parameters
       will be picked up. Multiple constraints per parameter may exist. The ExternalConstrains() argument implements
       similar functionality except that provided external constraint p.d.f.s are added rather than internal constraints.

     - Fix potentially fatal bug in print statement in getContext()

     - Add new method createCdf() to create a cumulative distribution function from given p.d.f. Given a set of observables x, 
       the returned c.d.f is implemented in terms of a RooRealIntegral of p.d.f(x') over a parameterized range from [ 0 - x ].


   o Roo1DIntegrator

     - Improve error message


   o RooRealIntegral

     - Fix bug in calculation of shape dependencies on observables.

     - Add handling of dependencies of integral value on values of objects representing parameterized ranges of
       integrated observables.     


   o RooMCStudy

      - Add Constrain(const RooArgSet& pars) and ExternalConstraints(const RooArgSet& pdfs) arguments to constructor.
        In addition to passing these arguments to the fitTo() call of the fit stage, modify event generation as
        follows: instead of sampling events from 'static' generator p.d.f, sample value of constrained parameters
        from joint constraints p.d.f and sample observables at those parameter settings. Save the generator parameters
        for each toy as these change per toy. Change the pull calculation such that it uses the per-event truth values
        rather than the per-study truth value if constraints are used.


   o RooAddition

     - Fix bug in evaluate() related to persistence


   o RooMinuit

     - Enable/disable new evaluation error logging mechanism prior to and just after each MINUIT call.

     - Print logged error messages, if any, in glue function


   o RooProjectedPdf

     - Fix important bug: normalization set should always include integration set for each configuration


   o RooGlobalFunc

     - Add definition of Scaling(),Constrain() and ExternalConstraints() helper functions 


   o RooUniformBinning
  
     - Remove dedicated print function as it output is identical to that of the generic print function in RooAbsBinningx

  
   o RooAbsBinning

     - Add virtual methods isParameterized(),lowBound() and highBound() to be to detect and analyze parameterized binnings
       through abstract interface

     - Add isShareable() method to be able to separate shareable and non-shareable binnings in RooRealVar.

     - Add insertHook() and removeHook() function to allow connection of possible proxies present in binning to
       owning RooAbsArg.


   o RooWorkspace

     - Improve code import facility by introducing a class->file mapping step in the CodeStore to correctly handle cases where 
       multiple classes are defined in a single file.

     - Add check that TClass interface actually yields file names.

     - Only require default constructor to be present for non-abstract classes. It should be there for abstract classes as
       well but current TClass::HasDefaultConstructor() method will not tell us.

   o RooTreeData

     - Improve renameVariable() method to not only rename the RooAbsArg branch buffer but also any TTree branches involved as well.
       While the tree branch names are generally invisible to the user, having branch names that are different from branch buffer names
       may cause branch naming conflicts in merge() that are not detectable as branch buffer naming conflicts.


   o RooParamBinning

     - New class implementing binning with low and high points defined by external RooAbsReal objects 


   o RooConstrainSum

     - Helper class for RooAbsPdf to represent likelihood of collection of constraint p.d.f.s.


==== Date: Fri Mar 28 10:04:57 2008 =====

   o RooRecursiveFraction

     - Helper function for RooAddPdf that calculates recursive fraction 
       f1*(1-f2)*(1-f3) from a given set of plain fractions


   o RooAddPdf

     - Add flag to ctor to optionally interpret fractions as recursive fractions.
       If activated it constructs the recursive fractions using RooRecursiveFraction
       from the original fractions


   o LinkDef3.h, Module.mk

     - Add new class RooRecursiveFraction

==== Date: Tue Apr  1 22:42:19 2008 ====

   o RooDataWeightedAverage

     - New implementation of RooAbsOptTestStatistics that calculates data weighted
       average of any RooAbsReal. This class serves as successor of RooDataProjBinding
       that no longer complies with new optimization scheme. 

   o RooRealBinding

     - Implement name() function for more useful error messaging in integration


   o RooChi2Var,RooNLLVar

     - Follow changes in base class


   o RooAbsReal

     - In plotOn() support binning flag in ProjWData(). Reimplement data-weighted projections
       using new RooDataWeightedAverage class instead of RooDataProjBinding which does not
       work with new generic function optimization scheme. 

     - Add support for NumCPU() argument
       in plotOn() to facilitate multi-processor calculation of projections. Extend NumCPU()
       argument to pass interleaving option in MP splitting mode of RooAbsTestStatistic

     - Move fixAddCoefNormalization() and fixAddCoefRange() from RooAbsPdf to RooAbsReal
  

   o RooAbsTestStatistic

     - Generalize functionality: allow RooAbsReals as input arguments instead of RooAbsPdfs only.
       Also add virtual globalNormalization() function that allows to apply a global normalization
       term after combinedValue() operation to facilitate functionality of RooDataWeightedAverage.

     - Add option to split data in multiprocessor mode in interleave mode instead of in bulk mode.
       Interleave mode is useful for parallel processing of histogram data where bulk partitions
       may not contain equal amount of non-zero data points leading to non-optimal load balancing
       between processes.


   o RooAbsPdf

     - Move fixAddCoefRange() and fixAddCoefNormalization to RooAbsReal to support operation of
       new generalized RooAbsTestStatistic
     

   o RooIntegrator1D

     - Use name() of RooAbsFunc() to clarify warning and error messages.


   o RooRealIntegral

     - Rename _operMode to _intOperMode to avoid shadowing of equally named data member in RooAbsArg

     - Fix bug in recursive printing


   o RooSetProxy

     - Fix bug in print()


   o RooGlobalFunc

     - Modify ProjWData() and NumCPU() helper functions with extra optional argument


   o RooAbsOptTestStatistic

     - Follow changes in RooAbsTestStatistic


   o RooAbsFunc

     - Add virtual name() function to facilitate better error and warning messages from integrators

=== Date: Tue Apr 15 17:57:32 2008 ===

   o RooMsgService

     - Add option to prefix streamed messages with process ID to simplify
       debugging of parallel fits


   o RooAbsProxy

     - Add optional addContents flag to print()


   o RooArgProxy, RooSetProxy, RooListProxy

     - Implement addContents flag in print()


   o RooAbsReal

     - Reimplement stack of logged error messages in terms of custom EvalError class. 
       A separate list<EvalError> is now kept for each object that reports an error.
       In addition to the given error message a record is constructed of the proxy
       values at the time of reporting. 
 
     - In printEvalErrors() add option to restrict number of reported items per node.
       If number is zero, only number of errors per node is shown (without details)


   o RooRealMPFE
 
     - Adjust ReportErrors message to changes EvalError implementation in RooAbsReal.
 
     - Make sure to synchronize remote error logging state with state of parent process
       before each evaluate()


   o RooRealVar

     - Move printing of error from printValue() to printExtras()


   o RooNLLVar

     - Fix bug in setting of interleave parameter of base class in certain ctors


   o RooAbsPdf

     - Improve passing of eval error messsages by make separate messages for NaN
       and negative values and including details in the error message

     - Add PrintEvalError(Int_t nErr) option to fitTo() to control new eval error
       message control system

     - Int printValue show both value (raw from evaluate()) as well as most recently
       used normalization value (if available)


   o RooMinuit

     - Interface new eval error logging control by adding setPrintEvalErrors(Int_t numEvalErrors)

=== Date: Thu Apr 24 15:11:59 2008 ===

   o Various classes

     - Fix all -Wshadow compiler warnings

=== Date: Thu Apr 24 16:32:21 2008 ===

   o RooMsgService

     - Use TSystem::GetPid() rather than getpid() for portability


   o RooAbsReal

     - Make nested class EvalError public


   o RooWorkspace

     - Fix windows compiler warning

========================================

   o RooBanner

     - Increment version tag to 2.40

Revision 20161 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon Oct 1 16:28:25 2007 UTC (7 years, 3 months ago) by wouter
Original Path: trunk/roofitcore/inc/RooRealBinding.h
File length: 2022 byte(s)
Diff to previous 18735

   o RooAbsCache

    - New abstract base class for cache objects associated with RooAbsArgs.
      Caches register themselves with the owning RooAbsArg and propagate
      all necessary state changes and meta information to objects in the cache


   o RooCacheManager

    - Concrete template implementation of RooAbsCache with an interface
      and functionality styled after RooNormListManager. The template class
      provide no special handling for cache contents that includes RooAbsArg
      objects and does not forward hook calls. It is thus mostly intended
      to cache basic types indexed on a normalization/integration configuration


   o RooObjCacheManager

    - Class derived from RooCacheManager<RooAbsCacheElement> that implements
      all proper call forwarding and handling of state and other meta information
      to RooAbsArg objects embedded in the cache elements. To facilitate this
      functionality the RooAbsCacheElement defines a pure virtual method
      containedArgs() that must be implemented to expose its contents to
      the cache manager. The default behavior on a serverRedirect hook is
      to sterilize the cache. OperMode changes are not forwarded by default
      to the cache contents as cached objects do not necessarily have the
      same operation mode (e.g. if the cache contains an integral of its owner).
      Any calls to optimizeCacheMode(), printCompactTreeHook(), and findConstantNodes()
      are forwarded. Moreover, optimizeCacheMode() calls are remembered and
      any objects inserted in the cache after such a call was received will be
      optimized upon insertion in the cache

   o RooAbsCacheElement

    - Abstract base class for objects to be managed by RooObjCacheManager. Each
      object must in addition to its payload implement the containedArgs()
      member function that exposes the RooAbsArg object content to the manager
      for processing. The argument passed to containedArgs() indicates the use
      case for the returned list of objects, allowing the cache payload to
      return different lists depending upon use. This is for most applications
      not required.


   o RooAbsCachedPdf

    - Abstract base class derived from RooAbsPdf for p.d.f.s that implement 
      value caching in a grid over the entire domain of the observables. 
      The base class implements the overall caching logistics and manages
      the RooDataHists and RooHistPdfs that respresent the cached contents.
      Derived classes must inputBaseName() defined a unique name prefix for
      all cache objects, actualObservales() and actualParameters() to
      determined the actual observables and parameters given a set of 
      available observables and fillCacheObject() which should fill the
      RooDataHist cache for a given obs/params configuration with the
      p.d.fs values.


   o RooAbsSelfCachedPdf

    - Abstract base class derived from RooAbsCachedPdf that implements
      all of the required logistics in RooCachedPdf and only require
      derived classes from RooAbsSelfCachedPdf to implement evaluate().
      Any class derived from RooAbsPdf can thus be trivially switched
      to derived from RooAbsSelfCachedPdf and gain the caching functionality.
      

   o RooCachedPdf

    - Concrete class derived from RooAbsCachedPdf that implements
      the caching of an externally provided p.d.f in the constructor.


   o RooFFTConvPdf

    - Concrete class derived from RooAbsCachedPdf that implement generic
      numeric convolution of two input p.d.f.s using FFT technique
      and convolution theorem. Actual FFTs are calculated by FFTW
      through TVirtualFFT interface in ROOT. Present implementation only supports 
      convolution in one dimension, but this will be extended later
      as there are no fundamental limitations in RooAbsCachedPdf nor FFTW.
 

   o RooHistPdf

    - Moved from RooFit to RooFitCore because it is used by caching classes


   o RooProdPdf

     - Use new RooObjCacheManager to store partial objects

     - Fix memory leak (already patched in 15.0.14h)


   o RooDataHist

     - Use new RooCacheManager template to cache partial bin volumes

     - Add new set(),setAllWeights() method to update current weight and all weights
       respectively, for use in cached p.d.f.s

     - Add sliceIterator() that iterates over all bins in a lower dimensional 
       slice of the dataset


   o RooDataHistSliceIter

    - Class derived from TIterator that implements the iteration
      over a slice in a reduced number of dimensions in a RooDataHist


   o RooMsgService

     - Speed up processing of debug streams in cases where no debug streams are active

     - add macros series oocoutX and oocxcoutX that allow to associate message with
       a different object than *this

   o RooRealBinding

     - Interface new setValue method that allows value to be set outside default
       domain, but inside given alternate named range. For use in numeric integrator
       bindings


   o RooAbsRealLValue

     - Add new inRange() method with range name specifier to check against chosen
       range instead of default range


   o RooCmdConfig

     - Fix dangling return pointer problem in decodeStringOnTheFly() method


   o RooNameSet

     - Fix bug in refoll()


   o RooChi2Var, RooNLLVar

     - Add processing of AddCoefRange() named argument


   o RooConvCoefVar

     - Hold p.d.f in proxy without value/shape state propagation to obtain
       correct dependency of RooConvCoefVar through separate set proxy
       with parameters that do have state propagation

     - In getAnalyticalIntegral() ask for integration coefficient specific
       to coefficient (following interface change in RooAbsAnaConv)


   o RooEfficiency

     - Follow interface change in RooCategoryProxy


   o RooAbsAnaConvPdf

    - Use new RooObjCacheManager to hold normalization and coefficient representations

    - Extend getCoefAnalyticalIntegral() interface so that each coefficient
      can have a separate integration configuration

    - Modify makeCoefVars() such that it constructs the RooConvCoefVars with
      actual dependents for each coefficients, rather than inserting dependencies
      of any of the coefficients in each coefficient. This logic requires support
      from the implementation class that is interface through a new member function
      coefVars()


   o RooAbsReal 

    - Add Boolean data member treeVar that indicates is value buffer is also
      branch buffer of a tree. This information is already present in the RooAbsReal
      but is relatively expensive to retrieve and is always needed in the inner
      loop of data set operations. This extra member significantly speeds up operations

    - Remove superfluous _norm[] token in name returned by integralNameSuffix() if 
      no normalization set is supplied.

    - Add a fillDataHist() method that fills a given RooDataHist with a sampling
      of the given function. Added for support of caching p.d.f.s


    - Downgrading warning on non-dependent projection variables in plotOn() to
      a debug level message

    - Remove function optimizeDirty(),doConstOpt(),undoConstOpt(),findCacheableBranches()
      findUnusedDatasetVariables() and findRedundantCacheServers() as part of reorganization
      of optimization functionality.


   o RooAbsCollection

    - Use iterator semantics instead of vector semantics to process RooLinkedList
      contents in assignment operator

    - Add utility function contentsString() returning stl string with names
      of contents


   o RooAddPdf

    - Rewrite cache management using new RooObjCacheManager that holds projection
      integrals, range integrals and supplemental normalization lists


   o RooAbsOptGoodnessOfFit

    - Improve handling of normalization ranges and reference ranges for test statistics
      containing RooAddPdfs. New named argument in fitTo() and RooNllVar::ctor() pass
      reference range for fractions in RooAddPdf components that do not have an explicit
      fixed definition already. Name all normalization ranges explicitly after the
      subrange to which the're applied to avoid name clashes and conflicts if multiple
      normalization ranges are involved.

    - Rewrite informational messages through RooMsgService

    - Implement new constOptimizeTestStatistic() function that signals all test statistic
      components of a RooAbsArg expression tree to perform their constant term optimization

    - Implement new optimizeCaching() driver function that changes default lazy-evaluation-with-caching
      scheme to test statistic scheme where only parameters objects propagate state changes and
      where all components that depend directly or indirectly on observables have lazy evaluation
      disabled. Changes to p.d.f objects are delegated to RooAbsPdf::optimizeCacheMode(). Changes
      to dataset are delegated to RooAbsData::optimizeReadingWithCaching()

    - Implement new optimizeConstantTerms() function that is back end for constOptimizeTestStatistic
      implementation. 


  o RooAICRegistry, RooNormSetCache

    - Remove tracking of allocation cycles of RooArgSets as this scheme is superseded by
      memory pool mechanism for RooArgSet allocation


  o RooMappedCategory

    - Follow interface change in RooCategoryProxy.


  o RooRealMPFE

    - Follow reorganization of optimization functionality: implement new constOptimizeTestStatistic
      function for forwarding to slave processes.


  o RooRealVar

    - Add new setVal() function with range name to facilite setting of values that are outside
      default range, but inside specified alternate range. Needed for numeric integration and
      certain RooAddPdf coefficient projection.


  o RooAbsArg

    - Make state management functions public [is/set][Value/ShapeDirty](), setOperMode90
  
    - Add static _flipAClean boolean to support setACleanAdirty() static method.

    - Implement mechanism for registration of cache objects with base class RooAbsCache.
      Forward all calls to operModeHook(), redirectServersHook(), optimizeCacheMode()
      and printCompactTreeHook() to all caches for further processing
   
    - Define constOptimize() function and provide default implementation that forwards
      to all servers 

    - Implement optimizeCacheMode() function that puts expression tree in optimized
      caching for test-statistics operations (only cache/lazy evaluate nodes that
      do not (indirectly) depend on observables

    - Implement findConstantNodes() function that identifies all nodes that depend
      exclusively on constant observables and >0 observables that are eligible
      for precalculation and caching in test statistics operations by 
      RooAbsOptTestStatistic::optimizeConstantTerms()

    - Define constOptimizeTestStatistics that signal an expression tree that any
      embedded test statistic objects should perform their constant term optimization.
      Default implementation in RooAbsArg forwards call to all servers.


  o RooAbsPdf

    - Use new RooObjCacheManager to manage normalization integrals cache.

    - Process new SumCoefRange() option in fitTo() that sets the coeffient
      interpretation range for all embedded RooAddPdf objects of which
      the interpretation range was not explicitly set

    - Extend interface of fixAddCoefNormalizationSet(): add extra argument
      that controls if AddCoef normalization set are forcibly overruled
      for objects that already have an explicit range setting.

  
   o RooRealIntegral 

    - Add some informational messaging through RooMsgService, rewrite existing ones

    - Speed up numeric summations by precreating the involved RooSuperCategory
      in the ctor rather than in evaluate().

    - Fix bug in dependency insertion: explicitly require servers to be value
      server to avoid pulling in fake dependents.
    
    - Remove obsolete data members

    - Implement new setACleanADirty() function that atomically flips state of
      all AClean objects to ADirty for the duration of the integration step.
      Replaces the much more expensive prepareACleanFunc() that did this
      only for the objects involved.

    - Process factorizing terms in integral only if the list is not empty

    - Process Jacobian terms in integral only if the list is not empty


  o RooAddGenContext

   - Adapt to cache management chanches in RooAddPdf


  o RooNumIntFactory

   - Use STL classes for internal memory management


  o RooSetProxyy

   - Implement operator new() and operator() delete as required because
     RooArgSet implements them 


  o RooAbsGoodnessOfFit

   - Store and forward AddCoefRange information for embedded RooAddPdf objects

   - Implement constOptimizeTestStatistic() and forward to components


  o RooErrorVar

   - Follow inRange() interface change in RooAbsRealLValue


  o RooConvGenContext

    - Adapt code to make it work with both RooAbsAnaConv objects and
      the newly introduced RooFFTConvPdf


  o RooMinuit

    - Follow reorganization of optimization functionality


  o RooProjectedPdf

    - Store projection using new RooObjCacheManager


  o RooGlobalFunc

    - Add RooFit::SumCoefRange() named argument for RooAbsPdf::fitTo() 
      and RooNLLVar::ctor() and RooChi2Var::ctor()


  o RooClassFactory

    - Extend existing makePdf(),makeFunction and makeClass() functions
      to also accept RooAbsCategory arguments, to accept an optional string
      inserted as the return value expression inserted in the 
      evaluate() method of the class created, as well as as option string
      specifying one or more analytical integrations of the given function
      expression that will be advertised in the generated getAnalyticalIntegral()
      code and implemented in the generated analyticalIntegral() code

    - Add makeAndCompileFunction() and makeAndCompilePdf methods that
      generate the code and immediate compile it through ROOTs ACliC interface.
      These functions have a simpler interface because the list of arguments
      of the function to be created can be specified as a const RooArgSet&
      rather than a string with a list of names, thus making it easier
      for on-the-fly definition of compiled objects.

    - Add defineFunction() and definePdf() methods define and compile
      a function/pdf using the above functions and immediately instantiate
      an object of the given type passing the specified RooArgSet arguments
      to the constructor of the object. These functions make a compiled
      equivalent of RooFormulaVar based on the TFormula interpreter, i.e.

           RooAbsReal* f = new RooFormulaVar("f","D(1-2w)",RooArgSet(D,w)) ;

      becomes
       
           RooAbsReal* f = RooClassFactory::defineFunction("f","D(1-2w)",RooArgSet(D,w)) ;

   
  o RooAbsCategory

   - Add Boolean data member treeVar that indicates is value buffer is also
     branch buffer of a tree. This information is already present in the RooAbsReal
     but is relatively expensive to retrieve and is always needed in the inner
     loop of data set operations. This extra member significantly speeds up operations

   - Construct explit clean name for TBranch name if node is cached, equivalent
     to what is done in RooAbsReal. Needed because new constOptimizer can also
     cache RooAbsCategory objects


  o RooArgSet

   - Implement operator new() and operator delete() to implement memory pool scheme
     for RooArgSets. The goal of this implementation is to insure that two RooArgSet
     pointers are _never_ the same. This allows to RooNormSet cache manager to safely
     and quickly index integration and normalization configurations by evaluating
     the contents of a RooArgSet only the first time it sees it.


  o RooSimultaneous

   - Implement caching of partial integrals using new RooObjCacheManager

   - Following interface change in RooCategoryProxy ;


  o RooAbsData

   - Defined pure virtual methods optimizeReadingWithCache() and allClientsCached()


  o RooTreeData

   - Implement optimizeReadingWithCache() which determines given a p.d.f to be
     evaluated and a list of the nodes that are cached for it, which observables
     in the dataset are no longer required because they are either not an observable
     of the p.d.f, or they exclusively feed nodes that are cached. Reading of these
     observables is disabled through SetBranchStatus().
  
   - Move allClientsCached() utility function here from RooAbsReal.


  o RooCategoryProxy

   - Remove const char*() conversion operator in favor of a const char* label() method
     to remove possibly ambiguities in C++ math expressions involving category proxies.


  o LinkDef3.h

   - Add newly defined classes

Revision 11114 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon Feb 14 20:44:30 2005 UTC (9 years, 11 months ago) by wverkerke
Original Path: trunk/roofitcore/inc/RooRealBinding.h
File length: 2037 byte(s)
Diff to previous 8538

   o RooNameReg

     - Registry for unique string name IDs. Converts a 'const char*' string into
       a unique 'const TNamed*' and back. General purpose utility to to map
       string identifiers to unique 32-bit numbers


   o RooAbsReal

     - In getAnalyticalIntegral(WN) and analyticalIntegral(WN) add extra argument
       const char* rangeName to identify range over which integration should
       be performed


   o All RooAbsReal derived classes

     - Modify getAnalyticalIntegral(WN) and analyticalIntegral(WN) to follow
       change in RooAbsReal. Pass rangeName argument to min() and max() functions
       of RooRealProxy to retrieve requested range instead of default range


   o RooAbsArg

     - Add virtual inRange(const char* rangeName) member function.


   o RooAbsCategoryLValue

     - Name change get/setFitBin() --> get.setBin(), numFitBins() --> numBins()
       getFitBinWidth --> getBinWidth


   o RooAbsCollection

     - Add printLatex() method for formatted LaTeX printing of lists.
       Supports named arguments Columns() to change number of columns,
       Format() to change printing format, OutputFile() for printing
       directly to file and Sibling() to print along side on or more other lists.


   o RooAbsData

     - Sanitize plotOn() arrangement: just keep version with RooCmdArg arguments

     - Add optional rangeName argument to fillHistogram


   o RooAbsGenContext

     - Pass normalization set to expectedEvents() to support calculation of
       fractional intergrals in extended term (e.g. in RooExtendedPdf)


   o RooAbsLValue

     - Name change: setFitBin(),getFitBin(),numFitBins(),getFitBinWidth() -->
       setBin(),getBin(),numBins(),getBinWidth()


   o RooAbsOptGoodnessOfFit

     - Follow name changes in RooAbs(Real)Lvalue


   o RooAbsPdf

     - Modernize syncNormalization by using createIntegral internally

     - Add getNormObj() function that returns const RooRealIntegral*
       pointer to specified normalization integral. Takes optional
       rangeName argument for calculation of fractional integrals.

     - Sanitize plotOn(). Only keep version with RooCmdArgs public.
       Move implementation version in protected interface. Replace
       way too long list of arguments with new internal
       helper class RooAbsPdf::plotOpt, whose constructor sets all
       the default options.

     - Change expectedEvents() and extendedTerm() function signature to
       take normalization set argument that can be used to calculated
       normalization-dependent fractional integrals (e.g. in RooExtendedPdf)

     - Migrate named argument global helper functions for plotOn() to RooGlobalFunc.cc


   o RooAbsReal

     - Modify createIntegral() method to take optional rangeName argument.

     - Sanitize plotOn() and plotAsymOn(). Only keep version with RooCmdArgs public.
       Move implementation version in protected interface. Replace
       way too long list of arguments with new internal
       helper class RooAbsPdf::plotOpt, whose constructor sets all
       the default options.

     - Migrate named argument global helper functions for plotOn() to RooGlobalFunc.cc

     - Add Name() feature to plotOn() to give chosen name to resulting RooCurve

     - Add ProjectionRange() feature to plotOn() -- Project PDF only over limited
       range as specified by range name to show finite width slices
       in projection dimensions

     - Add Invisible() feature to plotOn() which stores curve invisibly in
       RooPlot.

     - Add AddTo() feature to plotOn() which adds curve to existing curve
       in Rooplot.


   o RooAbsRealValue

     - Name change get/set/hasFitMin/Max() --> get/set/hasMin/Max() etc.


   o RooAcceptReject

     - Follow changes in RooAbsRealLValue


   o All numeric integrator engines

     - Add "#include RooArgSet.hh" to compensate for removal of stray include in RooCmdConfig.hh


   o RooAddPdf

     - Add feature to fix interpretation of fractional coefficients in particular reference range
       that can be different from default range


   o RooChi2Var

     - Migrate named argument global helper functions for constructor to RooGlobalFunc.cc


   o RooCmdConfig

     - Modify defineObject() to also be able to process arrays of objects

     - Add process() method with 8 RooCmdArg arguments

     - Modify getString() so that it can optionally return an empty string as a null pointer


   o RooConvGenContext,RooConvIntegrandBinding

    - Follow name changes in RooAbsRealLValue


   o RooCurve

    - Add constructor that takes two existing curves and two weights. New curve is construction
      for OR set of points that define both input curves. Points on one curve that do not exist
      on the other are calculate using interpolation.


   o RooDataHist, RooDataSet

    - Sanitize plotOn() functions

    - Follow name changes in RooAbsRealLValue


   o RooErrorVar

    - Follow name changes in RooAbsRealLValue


   o RooExtendPdf

    - Completely rewrite using newly introduced fractional integral technology. Change
      constructor to take optional const char* rangeName argument to denote restricted
      range for expectedEvents() interpretation.


   o RooFitResult

    - Follow name changes in RooAbsRealLValue


   o RooFormula

    - Add new interface to make it work with ROOT version 4 as well as ROOT version 3


   o RooGenProdProj

    - Make it work with optional restricted integration ranges as well


   o RooHist

    - Add constructor that constructs RooHist from two existing RooHists. Both input
      RooHist must have identical structure. In Poisson mode error is recalculated for
      total number of events in each bin. In SumW2 mode errors of input RooHists are
      combined.


   o RooMCStudy,RooMinuit,RooNLLVar

    - Follow changes in RooAbsRealLValue and RooAbsPdf::expectedEvents().


   o RooNormManager,RooNormListManager,RooNormSetCache

    - Make managers aware of range names that are associated with integral definitions.


   o RooPlot

    - Add optional argument to addPlotable(),addObject(),addTH1() functions to add
      given object invisibly.

    - Modify updateFitRangeNorm() to optionally refresh the normalization event count
      even if it has already been set

    - Add getObject() method that identifies object by index rather than by name

    - Add internal RooPlot::DrawOpt class that conversion ROOT draw options and
      RooPlot options from and to a const char* string.



   o RooProdPdf

    - Make it work with integrals over restricted ranges


   o RooRealAnalytic, RooRealBinding

    - Take optional rangeName argument in constructor that modifies output
      of getMin() and getMax() functions


   o RooRealIntegral

    - Take optional rangeName argument in constructor and pass it to analytical integrals
      and numeric integrators.


   o RooRealProxy

    - Modify min() and max() functions to take optional rangeName argument


   o RooRealVar

    - Follow name changes in RooAbsRealLValue

    - Implement getFit*() functions for backward compatibility.

    - Augment format() with extra LaTeX formatting options used
      in RooAbsCollection::printLatex()


   o RooTObjWrap

    - Modify so that it can also store lists of objects in addition to single objects


   o RooTreeData

     - Sanitize plotOn() and plotAsymOn(). Only keep version with RooCmdArgs public.
       Move implementation version in protected interface. Replace
       way too long list of arguments with new internal
       helper class RooAbsPdf::plotOpt, whose constructor sets all
       the default options.


     - Add Name() feature to plotOn() to give resulting RooHist chosen name

     - Add XErrorSize() feature to plotOn() to explicitly control size of X error bars

     - Add Invisible() feature to plotOn() to be able to store RooHist invisible to RooPlot

     - Add AddTo() feature to plotOn() to be able to add RooHist to an existing RooHist
       in RooPlot

     - Add RefreshNorm() feature to plotOn() which causes normalization event count in RooPlot
       to be refreshed with event count from this plot operation

     - Add optional rangeName argument to fillHistogram()


   o RooGlobalFunc

     - Move all global helper functions that create RooCmdArg named arguments here

     - Additionally create short-hand helper functions C(), L() and S() respectively
       that create a RooConst, a RooArgList and a RooArgSet. These shorthand functions
       are stored in namespace RooFitShortHand and thus not by default available
       in the global namespace

Revision 3124 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sat Oct 27 22:28:23 2001 UTC (13 years, 2 months ago) by verkerke
Original Path: trunk/roofitcore/inc/RooRealBinding.h
File length: 1288 byte(s)
Diff to previous 2799

  A large number of small fixes and improvements

  o Roo1DTable

    - Modify Print() behaviour. Standard print will
      only show non-empty fields, verbose shows all fields

  o RooAbsArg

    - Change getParameters so that it can accept 0 as
      dataset pointer (implies no dependents)

  o RooAbsPdf

    - Follow plotOn() changes in RooAbsReal

  o RooAbsReal

    - Add optional const RooArgSet* projData argument to
      plotOn(). Projected dependents that appears in this
      dataset, if specified, will be projection via summation
      over data instead of integration.

    - Add clipInvalid option to bindVars() and propagate to
      RooRealBinding

    - Modify cleanBranchName() to truncate 'clean names'
      (which are used for the TTree branch) to 63 chars
      as cannot handle such cases (SEGV). In case name
      is longer than 63 chars, truncate name at 46 chars
      and suffix with _crc followed by hex representation
      of CRC32 checksum of the full name.

    - Add crc32() method to calculate the checksum of a string


  o RooAddModel,RooAddPdf

    - Do not evaluate PDF components multiplied by a zero coefficient

  o RooAddPdf

    - Fix DIV0 in analyticalIntegral if number of expected events
      for all PDFs combined totals zero

  o RooArgSet

    - Add ability to readFromStream and readFromFile to optionally
      flag read arguments with a user specified attribute
      (Mostly useful to determine which elements have _not_ been read)

  o RooConvolutedPdf

    - Change declareBasis() signature from a RooArgSet& to a RooArgList&
      to correctly handle cases where the names of parameters are identical
      (e.g. tau=zero and dm=zero for prompt background models)

    - Expand logic in RooGenContext. Add additional requirement for
      use of optimized generator context: both the physics pdf and
      the resolution model must support direct generation of the
      convolution variable.
      (Still have to fix RooAddModel/Pdf for cases where all components
       can do direct generation)

  o RooCurve

    - Deploy RooRealBinding::clipInvalid feature to zero plotted functions
      outside the validity range of their dependents

    - Add extra points at (xlo,0) and (xhi,0) to obtain correct filling
      pattern when using the 'F' draw option.


  o RooCustomizer

    - Add warnings for multiple split or replace rules on the same leaf


  o RooDataSet

    - Make read() take a const RooArgList& instead of a RooArgList&
      and immediately make temporary copy for internal use.

    - All constructors with string based cut: add default empty cut.

  o RooFitContext

    - Ctor: Compare limits on dependents in PDF and dataset if limits
      of PDF are smaller and fully contained in those of the dataset,
      adjust the dataset ranges in the internal copy and reject events
      outside the PDF limits. If PDF ranges are not identical or fully
      contained in dataset limits, give error message and abort.

    - In fit() fix handling of parameters handed to TMinuit: set pmin/pmax
      to the parameter value for constant parameters. For floating parameters
      with open limits and without error, use 1/10 of the plot range
      instead of 1/10 of the fit range.

  o RooFormula,RooFormulaVar

    - Change RooArgSet to RooArgList to pass formula parameters.
      This allows construction of formulas with ordinal references
      for list of parameters with multiple occurrences of the same
      variable.

  o RooRealBinding

    - Add clipInvalid option, specified in ctor. If set, loadValues()
      will first check if the values to be loaded are in the limits
      of the bound objects dependents. If not the values are not loaded
      and an invalid flag is set. If the invalid flag is set operator()
      will return 0.

  o RooRealVar

    - Add various 'named parameter' functions on a trial basis

  o RooSimFitContext

    - Gracefully handle RooSimultaneous PDFs with missing PDFs.

  o RooSimGenContext

    - Forgot to set index state in theEvent RooArgSet when generating
      the index category

    - Remove forced normalization of index state in evaluate()

    - Remove dummy plotOn() method and specialized plotOn() with data
      method as projection over the index state can now be handled
      the regular plotOn method. Overload RooAbsPdf::plotOn to
      force caller to specify projection dataset for the index category
      if projection over the index category is requested

  o RooTable

    - Remove print(), add default Print(Option_t *), and reimplement
      printing via inheritance from RooPrintable


  o RooTreeData

    - In loadValues(RooTreeData*) explicitly check isValid() of
      each element of _vars after copying. If any is invalid,
      reject the event.

    - In table() change simple clone of tableVar to deep clone.
      Implement use of optional cut string (accidentally omitted sofar)

  o RooTruthModel

    - Add highly trivial direct generator for the convolution variable


  o RooDataProjBinding

     - New lightweight binding between an RooAbsReal and a dataset
       that returns the projection of the real over the dataset
       via summation. If the dataset only contains category variables
       an supercategory of all the datasets categories is created
       and the data is summed (with appropriate weights) over the
       supercategory states instead of over every event.

This form allows you to request diffs between any two revisions of this file. For each of the two "sides" of the diff, enter a numeric revision.

Links to HEAD:	(view) (download) (as text) (annotate)
Sticky Revision: