| Geant4 Cross Reference |
>> 1 $Id: README,v 1.16 2005/03/02 13:39:46 maire Exp $
1 ---------------------------------------------- 2 -------------------------------------------------------------------
2 3
3 ========================================= 4 =========================================================
4 Geant4 - an Object-Oriented Toolkit for S 5 Geant4 - an Object-Oriented Toolkit for Simulation in HEP
5 ========================================= 6 =========================================================
6 7
7 TestEm4 8 TestEm4
8 ------- 9 -------
9 10
10 Plot energy deposited by 9 MeV photon beam in << 11 This example has been setup to test the low energy gamma processes.
11 12
12 1- GEOMETRY DEFINITION 13 1- GEOMETRY DEFINITION
13 14
14 It is a cylinder of 5 cm radius filled with 15 It is a cylinder of 5 cm radius filled with C6F6.
15 16
16 2- PHYSICS LIST 17 2- PHYSICS LIST
17 18
18 The particle list contains only gamma, elect 19 The particle list contains only gamma, electron,positron.
19 The physics list contains the 'standard' ele 20 The physics list contains the 'standard' electromagnetic processes.
20 21
21 3- AN EVENT : THE PRIMARY GENERATOR 22 3- AN EVENT : THE PRIMARY GENERATOR
22 23
23 The primary kinematic is a single 9 MeV gamm 24 The primary kinematic is a single 9 MeV gamma randomly shooted at the
24 middle of the cylinder. 25 middle of the cylinder.
25 26
26 4- VISUALIZATION 27 4- VISUALIZATION
27 28
28 The Visualization Manager is set in the main 29 The Visualization Manager is set in the main().
29 The initialisation of the drawing is done vi 30 The initialisation of the drawing is done via the commands
30 /vis/.. in the macro vis.mac. This macro is 31 /vis/.. in the macro vis.mac. This macro is
31 automatically read from the main in case of 32 automatically read from the main in case of interactive running mode.
32 33
33 The detector has a default view which is a t 34 The detector has a default view which is a transversal view of the
34 cylinder. 35 cylinder.
35 36
36 The tracks are drawn at the end of event, an 37 The tracks are drawn at the end of event, and erased at the end of run.
37 Optionaly one can choose to draw all particl 38 Optionaly one can choose to draw all particles, only the charged one,
38 or none. This command is defined in EventAct 39 or none. This command is defined in EventActionMessenger class.
39 40
40 5- PHYSICS SURVEY 41 5- PHYSICS SURVEY
41 42
42 The energy deposited in C6F6 is histogramed 43 The energy deposited in C6F6 is histogramed.
43 44
44 6- HOW TO START ? 45 6- HOW TO START ?
45 46
>> 47 - compile and link to generate an executable
>> 48 % cd examples/extended/electromagnetic/TestEm4
>> 49 % gmake
>> 50
46 - execute TestEm4 in 'batch' mode from macro 51 - execute TestEm4 in 'batch' mode from macro files
47 % TestEm4 TestEm4.in << 52 % TestEm4 run01.mac
48 53
49 - execute TestEm4 in 'interactive mode' with 54 - execute TestEm4 in 'interactive mode' with visualization
50 % TestEm4 55 % TestEm4
51 .... 56 ....
52 Idle> type your commands 57 Idle> type your commands
53 .... 58 ....
54 Idle> exit 59 Idle> exit
55 << 60
56 macro verbose.mac illustrate capabili << 61 - visualize the histogram (paw)
>> 62 paw> h/file 1 testem4.hbook
>> 63 paw> option stat
>> 64 paw> option logy
>> 65 paw> h/pl 1
>> 66
57 67
58 7- USING HISTOGRAMS 68 7- USING HISTOGRAMS
59 69
60 The format of the histogram file can be : roo << 70 By default the histograms are not activated. To activate histograms
61 xml, csv, by selecting g4nnn.hh in RunAction. << 71 the environment variable G4ANALYSIS_USE should be defined. For instance
62 << 72 uncomment the flag G4ANALYSIS_USE in GNUmakefile.
63 8- RANDOM NUMBERS HANDLING << 73
64 << 74 Before compilation of the example it is optimal to clean up old files:
65 CLHEP provides several random number engine << 75 gmake histclean
66 engine is choosen at beginning of the main << 76 gmake
67 << 77
68 By default, G4RunManager does not save the << 78 It is possible to choose the format of the histogram file (hbook, root, XML):
69 To do so the user must set in BeginOfRunAct << 79 comment/uncomment 1 line in the constructor of RunAction.
70 G4RunManager::GetRunManager()->SetRandomNum << 80
71 << 81 To use histograms, at least one of the AIDA implementations should be
72 Then the rndm seed is systematically saved << 82 available (see http://aida.freehep.org).
73 (currentRun.rndm) and beginning of event (c << 83
74 Therefore, in case of abnormal end, the see << 84 7a - PI
75 is available in currentEvent.rndm << 85
76 << 86 A package including AIDA and extended interfaces also using Python is PI,
77 Even in case of normal run processing, the << 87 available from: http://cern.ch/pi
78 rndm seed of selected events. At any time i << 88
79 following statement: << 89 Once installed PI or PI-Lite in a specified local area $MYPY, it is required
80 if (condition) G4RunManager::GetRunManager( << 90 to add the installation path to $PATH, i.e. for example, for release 1.2.1 of
81 currentEvent.rndm will be copied to runXXev << 91 PI:
82 (see SteppingAction::UserSteppingAction() ) << 92 setenv PATH ${PATH}:$MYPI/1.2.1/app/releases/PI/PI_1_2_1/rh73_gcc32/bin
83 << 93
84 To restart a run from a given rndm seed, us << 94 CERN users can use the PATH to the LCG area on AFS.
85 /random/resetEngineFrom fileName << 95 Before running the example the command should be issued:
86 << 96 eval `aida-config --runtime csh`
87 The macro rndmSeed.mac shows how to save an << 97
88 seed between runs, from UI commands. << 98 7b - OpenScientist
>> 99
>> 100 OpenScientist is available at http://www.lal.in2p3.fr/OpenScientist
>> 101
>> 102 In OpenScientist, the AIDA implementation is the Lab package.
>> 103 You have to "setup" this package before compiling (then with G4ANALYSIS_USE)
>> 104 and running your Geant4 application.
>> 105
>> 106 On UNIX you setup, with a csh flavoured shell :
>> 107 csh> setenv CMTPATH <OpenScientist install path>
>> 108 csh> source <OpenScientist install path>/Lab/<version>/cmt/setup.csh
>> 109 On UNIX with a sh flavoured shell :
>> 110 sh> CMTPATH=<OpenScientist install path>;export CMTPATH
>> 111 sh> . <OpenScientist install path>/Lab/<version>/cmt/setup.sh
>> 112 On Windows :
>> 113 DOS> set CMTPATH=<OpenScientist install path>
>> 114 DOS> call <OpenScientist install path>/Lab/<version>/cmt/setup.bat
>> 115
>> 116 You have to use the XML or root file formats ; producing hbook files is not
>> 117 supported by OpenScientist/Lab. But the three formats (hbook, AIDA-XML, root)
>> 118 are readable by the interactive applications ; the Lab onx interactive
>> 119 program or the OpenPAW program.
>> 120
>> 121 With OpenPAW, someone can view the histograms with :
>> 122 OS> opaw
>> 123 opaw> h/file 1 run0.aida (or opaw> h/file 1 run1.root)
>> 124 opaw> zone 2 2
>> 125 opaw> h/plot 1
>> 126 opaw> h/plot 2
>> 127 opaw> h/plot 3