| 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 | |
|---|
