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

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/RooMPSentinel.h
File length: 1664 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 5174 - (view) (download) (as text) (annotate) - [select for diffs]
Added Wed Aug 21 23:06:42 2002 UTC (12 years, 5 months ago) by verkerke
Original Path: trunk/roofitcore/inc/RooMPSentinel.h
File length: 990 byte(s)

  Major new version (to become V00-01-00)

  o README

    - Update standalone compilation instructions
      Refer BaBar users to RooFitBabar/README

  o RooAICRegistry

    - Fix memory leak

  o RooAbsArg

    - Add default implementation of constOptimize() that
      forwards the call to all servers

    - Add RooAbsOptGoodnessOfFit, RooRealMPFE as friends

    - Add protected pure virtual method setTreeBranchStatus()
      that can be used by the optimizer to disable reading
      of the tree branch associated with the RooAbsArg

  o RooAbsBinning

    - Add description

  o RooAbsCategory

    - Add operator==()

    - Implement setTreeBranchStatus()

  o RooAbsCollection

    - Add addClone(RooAbsCollection&,...) to add a list of clones

  o RooAbsData

    - Add pure virtual methods for new caching mechanism:
       * cacheClone() returns a clone of the dataset with cache
       * resetCache() clears the existing cache
       * setArgStatus() disables reading of given args from tree

  o New class RooAbsGoodnessOfFit

    - Abstract base class for goodness-of-fit variables.
      A goodness-of-fit is any quantity calculated from a PDF
      and a dataset. This class orgamizes parallelization over multiple
      CPUs and calculation of GOFs from simulatenous PDFs.

  o New class RooAbsOptGoodnessOfFit

    - Abstract base class for goodness-of-fit variables
      that calculate the PDF value at each data point in the
      given dataset. It implements various optimizations:
      caching of constant terms, elimination of unused variables etc.

  o RooAbsPdf

    - Deploy new normalization integral manager RooNormManager
      to cache multiple normalization integrals for a PDF.
      This greatly increases the efficiency for certain situations
      where PDFs are alternatingly called with 2 or more different
      normalization choices

    - Reimplement fitTo() in terms of RooNLLVar and RooMinuit.

    - Reimplement plotNLLOn() in terms of RooNLLVar and plotOn()

    - Migrate plotNLLContours to RooMinuit

    - Remove obsolete method fitContext

  o RooAbsReal

    - Add operator==()

    - Implement setTreeBranchStatus()

    - Fix memory leak in createProjection()

  o RooAbsString

    - Implement setTreeBranchStatus()

  o RooAddModel

    - Eliminate getNormSpecial() construction that was originally
      introduced to efficiently handle calls with 2 alternating
      projection/normalization configurations originating from
      RooConvolutedPdf. This is now handled by RooNormManager.

  o RooAddPdf

    - Reimplement caching of coefficient projection list and
      supplemental normalization list using RooNormListManager.
      (Also supports caching of multiple configurations now)

  o RooArgSet

    - Implement addClone(RooAbsCollection&,...)

  o RooBanner

    - Add description

  o RooBinning

    - Add description

  o New class RooChi2Var

    - Implementation of simple Chi^2 of RooAbsOptGoodnessOfFit
      for a RooDataHist and a RooAbsPdf.

      Chi^2 is calculated from PDF value at the bin center.
      Poisson errors are used if no user defined errors are present

  o RooConvolutedPdf

    - Reimplement normalization integral management using
      RooNormListManager

    - Deprecate use of RooResolutionModel::getNormSpecial. No longer needed.

  o RooCustomizer

    - Fix memory leak

  o RooDataHist

    - Add lo/hi Error associated with each bin. Default implementation
      returns poisson errors. Error is return by weightError().

    - New set() function allows user to override poisson errors

  o RooDataSet

    - Fix copy ctor for weighted datasets

    - Implement cacheClone()

  o RooDirItem

    - Add description

  o RooDouble

    - Add description

  o RooExtendPdf

    - Follow changes in normalization management of RooAbsPdf

  o Removed class RooFitContext

    - Replaced by RooMinuit/RooNLLVar

  o RooFitResult

    - Change terminology NLL -> FCN (fits are no longer NLL necessarily)

    - Store and report accuracy code of minuit error matrix

    - Minor tweaking of parameter dumps with mixed symmetric/asymmetric
      errors

  o RooGenericPdf

    - Follow changes in RooAbsPdf normalization management

  o RooIntegratorConfig

    - Add description

  o RooLinTransBinning

    - Add description

  o RooLinkedListElem

    - Add description

  o RooLinkedListIter

    - Add description

  o New class RooMPSentinel

    - New class to keep track of server processes started for
      parallelized goodness-of-fit calculations. On linux
      hosts, these processes don't exit when the parent process
      exits. This class sends termination signals when this
      singleton class is deleted

  o RooMath

    - Activate CERF disk caching by default

  o New class RooMinuit

    - New seamless interface between RooFit objects and MINUIT
      Class propagates information forth and back between RooAbsArg
      objects and minuits internal memory buffer (e.g. parameter
      values, errors, step sizes, constant status)

    - This class minimizes any RooAbsReal function (doesn't need to
      be a NLL or Chi2)

  o Removed class RooNLLBinding

    - Obsolete after introduction of RooNLLVar

  o New class RooNLLVar

    - Implementation for NLL of RooAbsOptGoodnessOfFit

  o RooNameSet

    - Fix memory leak

  o New class RooNormManager

    - New manager class for normalization/projection integrals for PDFs
      This class matches RooArgSet pointer pairs to the integration
      and normalization sets to previously registered integrals.
      Multiple pointer pairs can point to the same integral (e.g.
      pointer to different RooArgSets with the same contents) and
      multiple integrals can be cached. This class doesn't create
      the normalization integrals. It merely indicates if it has
      one or not, and leaves it up to the owning class to create
      and register new normalizations


  o New class RooNormListManager

    - Similar to RooNormManager, except that RooArgLists of normalization
      integrals are caches instead of single integrals

  o RooNormSetCache

    - Rework functionality. This class, used by RooNorm(List)Manager
      manages multiple redundant RooArgSet pointer pairs that represent
      the same projection/normalization configuration

  o RooProdPdf

    - Almost complete rewrite in terms of RooNormListManager


  o RooRealConstant

    - Minor const changes

  o RooRealIntegral

    - Streamline iterator use: Create various interator in ctor
      and reuse them in evaluate() instead of creating and deleting
      them on the fly

  o New class RooRealMPFE

    - Front end for MultiProcessor calculations. Class RooRealMPFE
      takes a RooAbsReal as argument and calculates it in separate
      process. Calculations can be started asynchronously with
      the calculate() call. The rest of the interface (and behaviour)
      is identical to that of the original RooAbsReal.

  o RooResolutionModel

    - Deprecate getNormSpecial - superceded by RooNormManager

  o RooSetProxy

    - Implement addClone(const RooAbsCollection&,...)

  o Removed class RooSimFitContext

    - Obsolete - replaced by RooMinuit/RooNLLVar

  o RooSimGenContext

    - Fix memory leak

  o RooSimultaneous

    - remove obsolete fitContext() method

  o RooTreeData

    - Reimplement caching. Cached functions are now stored in
      a separate tree in the dataset. Main benefit of the new
      implementation is that caches can efficiently be reset
      and refilled on the fly

  o makedocs

    - Add stanzas for new tutorial macros

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: