| [807] | 1 | $Id: README,v 1.15 2006/08/16 15:42:16 gcosmo Exp $
|
|---|
| 2 | -------------------------------------------------------------------
|
|---|
| 3 |
|
|---|
| 4 | =========================================================
|
|---|
| 5 | Geant4 - an Object-Oriented Toolkit for Simulation in HEP
|
|---|
| 6 | =========================================================
|
|---|
| 7 |
|
|---|
| 8 | AnaEx01
|
|---|
| 9 | -------
|
|---|
| 10 |
|
|---|
| 11 | This example shows the usage of histogram and tuple manipulations using
|
|---|
| 12 | an AIDA compliant system. In this example, all analysis manipulations
|
|---|
| 13 | (hooking an AIDA implementation, histo booking, filling, etc...) are
|
|---|
| 14 | concentrated in one class : AnaEx01AnalysisManager.
|
|---|
| 15 |
|
|---|
| 16 | To use an AIDA compliant analysis system with this example, the environment
|
|---|
| 17 | variables :
|
|---|
| 18 | G4ANALYSIS_USE
|
|---|
| 19 | G4ANALYSIS_AIDA_CONFIG_CFLAGS
|
|---|
| 20 | G4ANALYSIS_AIDA_CONFIG_LIBS
|
|---|
| 21 | must be properly set.
|
|---|
| 22 |
|
|---|
| 23 | The first one permits to validate/devalidate the AIDA analysis code
|
|---|
| 24 | in the example code. The two others permit to give the compilation
|
|---|
| 25 | and link flags of the AIDA compliant system used.
|
|---|
| 26 |
|
|---|
| 27 | The variable G4ANALYSIS_USE must be defined in the environment, and the
|
|---|
| 28 | the system properly configured to use one of the AIDA compliant analysis
|
|---|
| 29 | tools (i.e. path set to retrieve the 'aida-config' command).
|
|---|
| 30 |
|
|---|
| 31 | Working with the OpenScientist/Lab package :
|
|---|
| 32 | ------------------------------------------
|
|---|
| 33 | To reconstruct this example by using the OpenScientist/Lab
|
|---|
| 34 | package (assuming that OpenScientist is installed ! ) you have
|
|---|
| 35 | first to "setup" the environment of the Lab package and Geant4.
|
|---|
| 36 | The Lab package (and all OpenScientist packages) being handled
|
|---|
| 37 | by the CMT tools, you may have to setup the environment
|
|---|
| 38 | variable "CMTSITE" to execute site specific things in the chain
|
|---|
| 39 | of setup files of the OpenScientist packages. Then for example at CERN :
|
|---|
| 40 | csh> setenv CMTSITE CERN
|
|---|
| 41 | (DOS> set CMTSITE=CERN_WIN32 (for Windows))
|
|---|
| 42 | When done then do :
|
|---|
| 43 | csh> source <some directory>/Lab/<version>/cmt/setup.csh
|
|---|
| 44 | csh> source <your Geant4 setup script>.csh
|
|---|
| 45 | csh> setenv G4ANALYSIS_USE 1
|
|---|
| 46 | csh> cd $G4INSTALL/examples/extended/analysis/AnaEx01
|
|---|
| 47 | csh> gmake
|
|---|
| 48 |
|
|---|
| 49 | To run :
|
|---|
| 50 | csh> cd analyis/Lab
|
|---|
| 51 | csh> $G4WORKDIR/bin/$G4SYSTEM/AnaEx01
|
|---|
| 52 |
|
|---|
| 53 | It must produce an AnaEx01.aida file that contains some histograms
|
|---|
| 54 | and a tuple.
|
|---|
| 55 |
|
|---|
| 56 | To plot some histograms, spawn the Lab interactive tool with :
|
|---|
| 57 | csh> onx
|
|---|
| 58 | (DOS> onx (for Windows))
|
|---|
| 59 | click in 'File/Open AIDA file...' to map a file chooser,
|
|---|
| 60 | then choose AnaEx01.aida. The file name should appear in the left
|
|---|
| 61 | tree widget beside the plotting area. Use the tree widget to browse
|
|---|
| 62 | the file. You can visualize histos by selecting them with the mouse.
|
|---|
| 63 |
|
|---|
| 64 | If the OpenScientist/OnX and Lab Python drivers had been
|
|---|
| 65 | reconstructed at installation of OpenScientist, then
|
|---|
| 66 | you can also work with the OpenScientist/Lab/AIDA Python API.
|
|---|
| 67 | You can execute AnaEx01.py by doing :
|
|---|
| 68 | OS> python AnaEx01.py
|
|---|
| 69 | or :
|
|---|
| 70 | OS> python
|
|---|
| 71 | (>>> import AIDA)
|
|---|
| 72 | >>> import AnaEx01
|
|---|
| 73 | The AnaEx01 file contains a Python script that
|
|---|
| 74 | does some analysis over the AnaEx01.aida file by using the AIDA interfaces.
|
|---|
| 75 | This script gets an histo (EAbs) and plots it in a first drawing region.
|
|---|
| 76 | Then it gets the 'AnaEx01' tuple, books and fills another histo
|
|---|
| 77 | from the tuple colum 'EAbs' and plots it a secon drawing region.
|
|---|
| 78 |
|
|---|
| 79 | If exporting a AnaEx01.root file (see src/AnaEx01AnalysisManager.cc),
|
|---|
| 80 | the AnaEx01.C file could also be used, within the ROOT tool.
|
|---|
| 81 | To see a projection of the first column of the tuple contained
|
|---|
| 82 | in the AnaEx01.root file. For example :
|
|---|
| 83 | csh> root
|
|---|
| 84 | root[0] .X AnaEx01.C
|
|---|
| 85 |
|
|---|
| 86 | The OpenScientist URL is : http://OpenScientist.lal.in2p3.fr.
|
|---|
| 87 | OpenScientist is installed at CERN under /afs/cern.ch/sw/contrib.
|
|---|
| 88 |
|
|---|
| 89 | Working with the Falsetto package :
|
|---|
| 90 | ---------------------------------
|
|---|
| 91 | Falsetto is a little package containing a dummy
|
|---|
| 92 | AIDA analysis factory. It permits to check compilation
|
|---|
| 93 | and link of some user AIDA code without embarquing a
|
|---|
| 94 | full analysis system.
|
|---|
| 95 |
|
|---|
| 96 | To reconstruct this example by using the Falsetto
|
|---|
| 97 | package (assuming that it is installed !), do :
|
|---|
| 98 | csh> source <your Geant4 setup script>.csh
|
|---|
| 99 | csh> source <some directory>/Falsetto/<version>/cmt/setup.csh
|
|---|
| 100 | csh> setenv G4ANALYSIS_USE 1
|
|---|
| 101 | csh> cd $G4INSTALL/examples/extended/analysis/AnaEx01
|
|---|
| 102 | csh> gmake
|
|---|
| 103 |
|
|---|
| 104 | To run :
|
|---|
| 105 | csh> cd analyis/Falsetto
|
|---|
| 106 | csh> $G4WORKDIR/bin/$G4SYSTEM/AnaEx01
|
|---|
| 107 | At the beginning of output ;should appear :
|
|---|
| 108 | AIDA analysis factory not found.
|
|---|
| 109 |
|
|---|
| 110 | The Falsetto URL is : http://www.lal.in2p3.fr/SI/Falsetto
|
|---|
| 111 | Falsetto is installed at CERN under /afs/cern.ch/sw/contrib.
|
|---|
| 112 |
|
|---|
