1 | $Id: README,v 1.16 2009/05/13 08:32:36 gbarrand 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 | (attaching an AIDA implementation, histo booking, filling, saving |
---|
14 | histos in a file, etc...) are concentrated in one class : |
---|
15 | AnaEx01AnalysisManager. |
---|
16 | |
---|
17 | To include the analysis code, the environment variable |
---|
18 | G4ANALYSIS_USE |
---|
19 | must be defined before doing "make". If not, at run time, no |
---|
20 | histograms and file will be created. |
---|
21 | |
---|
22 | For example, a typical session from a UNIX csh flavoured shell is : |
---|
23 | csh> source <aida tool>/aida-setup.csh |
---|
24 | csh> setenv G4ANALYSIS_USE 1 |
---|
25 | csh> make |
---|
26 | csh> ${G4BIN}/${G4SYSTEM}/AnaEx01 |
---|
27 | After execution, a file AnaEx01.aida should have been created. |
---|
28 | Someone can change the default file format by changing the |
---|
29 | value of the std::string variable format in the AnaEx01AnalysisManager |
---|
30 | constructor : |
---|
31 | // File format : |
---|
32 | std::string format("xml"); |
---|
33 | //std::string format("hbook"); |
---|
34 | //std::string format("root"); |
---|
35 | |
---|
36 | Working with the OpenScientist packages : |
---|
37 | --------------------------------------- |
---|
38 | To create the analysis file, you can install the light "osc_batch" |
---|
39 | binary kit (See http://OpenScientist.lal.in2p3.fr ). For example |
---|
40 | from a UNIX sh flavoured shell : |
---|
41 | sh> cd /usr/local |
---|
42 | sh> <arrange to be su> |
---|
43 | sh> <get an osc_batch binary kit> |
---|
44 | sh> unzip -q osc_batch<platform>.zip |
---|
45 | sh> cd osc_batch/<version> |
---|
46 | sh> ./install |
---|
47 | |
---|
48 | Then you build the example with : |
---|
49 | <create another terminal> |
---|
50 | csh> source /usr/local/osc_batch/<version>/aida-setup.csh |
---|
51 | csh> <source setup Geant4> |
---|
52 | csh> setenv G4ANALYSIS_USE 1 |
---|
53 | csh> cd <G4_install_path>/examples/extended/analysis/AnaEx01 |
---|
54 | csh> make |
---|
55 | csh> ${G4BIN}/${G4SYSTEM}/AnaEx01 |
---|
56 | |
---|
57 | Depending of the file format, you can visualize the produced |
---|
58 | file with various interactive tools (CERN/PAW, CERN/ROOT, jas). |
---|
59 | But if installing also an OpenScientist osc_vis binary kit, |
---|
60 | you shall be able to visualize all formats by using |
---|
61 | the osc-plot program. To install an osc_vis kit : |
---|
62 | sh> cd /usr/local |
---|
63 | sh> <arrange to be su> |
---|
64 | sh> <get an osc_vis binary kit> |
---|
65 | sh> unzip -q osc_vis<platform>.zip |
---|
66 | sh> cd osc_vis/<version> |
---|
67 | sh> ./install |
---|
68 | Then to browse the AnaEx01.<format> file (for exa from an UNIX sh shell) : |
---|
69 | <create another terminal> |
---|
70 | sh> . /usr/local/osc_vis/<version>/setup.sh |
---|
71 | sh> <setenv DISPLAY if needed> |
---|
72 | sh> osc-plot AnaEx01.[aida,root,hbook] |
---|
73 | |
---|
74 | The OpenScientist URL is : |
---|
75 | http://OpenScientist.lal.in2p3.fr. |
---|
76 | |
---|
77 | Note that OpenScientist is installed on CERN/lxplus under : |
---|
78 | /afs/cern.ch/sw/contrib/[osc_batch,osc_vis]. |
---|
79 | |
---|
80 | |
---|