GAUDI - Patches: patch #3134, Replace for patch #3007 and patch #2873 [LCG Savannah]

patch #3134: Replace for patch #3007 and patch #2873

2009-07-11 15:34, original submission:

This patch is an improved combination of #patch 3007 and #patch 2873.

It allows flexibility for interactive inspection&manipulation&mointoring of algoritms and tools.
From the given component one can extract the counters, tools & histograms.

>>> cmp = ...   ## get the component: algorithm or tool 

>>> counters = cmp.Counters()  ## get the dictionary of counetrs
>>> for key in counters : 
...     print key, counters[key] 


>>> tools = cmp.Tools()   ## get the list of iAlgTool-objects
>>> for t in tools :
...     if hasattr ( t , 'Context' ) : print t.Context() 


>>> counter = cmp.Counter('#accept')  ## get the counter by name
>>> print counter 


>>> histos = cmp.Histos()  ## get the dictionary of histograms
>>> for key in histos :  
...      print key , histos[key]

These methods are applicable both to proxy-classes iAlgorithm and iAlgTool from GaudiPython.Bindings module, as well as for the actual Python algorithms from GaudiPython.GaudiAlgs module, e.g.

>>> alg = gaudi.algorithm ('MyAlg')    ## use proxy class 

or

>>> alg = MyPythonAlg( ... )   ## use the actual Python algorithm from GaudiPython.GaudiAlgs module

The following modules are cleaned :

GaudiPython.GaudiAlgs
GaudiPython.TupleUtils
GaudiPython.HistoUtils

To be useful as key for python dictionary, the class GaudiAlg::ID has got the hash-function and all non-const methods have been removed [preincrement has been used only in two files, fixed properly, other (pre/post/in/de)crement operators have not been user at all].

The usage of "fictive" gaudimodule module has been removed.

AIDA-histograms are decorated with usage of Gaudi::Utils::Histos::Path and Gaudi::Utils::HistoStats functions

GaudiPython.HistoUtils module has been updated taking into account the feedback from June analysis hands-on workshop. One needs in addition to add class HistoFile by Juan into this updated module.. (see #patch 3091)

GaudiPython.TupleUtils module now warns at "atexit", if helper tuple-tools are not released explicitly.

The real python algorithms form GaudiPython.GaudiAlgs moduel have got keywords arguments for constructors, thus making possible to set the properties and attributes at construction time:

>>> alg = MyPythonAlg ( 'MyName' , OutputLevel = 3 , PtCut = 5 * GeV , ... )

The non-nesessary public-virtual bases have been removed from GaudiPython::PyAlg template class.

The (python) documentation has been drastically improved for all cases, listed above..

All this functionality& decorations is not applied automatically! To access new functionality one needs to import GaudiPython.GaudiAlgs, GaudiPython.HistoUtils and/or GaudiPython.TupleUtils modules correspondingly

New example HistoUtilsEx.py for illustration of GaudiPython.HistoUtils module is attached..

Affected packages:

GaudiAlg
GaudiPython

The modified files for GaudiAlg package:

src/lib/GaudiCommon.icpp
src/lib/GaudiHistoID.cpp
GaudiAlg/GaudiTuples.icpp
GaudiAlg/GaudiCommonImp.h
GaudiAlg/GaudiHistos.h
GaudiAlg/GaudiCommon.h
GaudiAlg/GaudiHistoID.h
GaudiAlg/GaudiTuples.h
GaudiAlg/GaudiHistos.icpp

The modified files for GaudiPython package:

python/GaudiPython/TupleUtils.py
python/GaudiPython/GaudiAlgs.py
python/GaudiPython/HistoUtils.py
dict/selection_kernel.xml
dict/kernel.h
src/Lib/AlgDecorators.cpp
src/Lib/HistoDecorator.cpp
GaudiPython/AlgDecorators.h
GaudiPython/HistoDecorator.h
GaudiPython/Algorithm.h

Vanya Belyaev <ibelyaev>