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