| Geant4 Cross Reference |
1 1
2 ========================================= 2 =========================================================
3 Geant4 - an Object-Oriented Toolkit for S 3 Geant4 - an Object-Oriented Toolkit for Simulation in HEP
4 ========================================= 4 =========================================================
5 5
6 Hadr06 6 Hadr06
7 ------ 7 ------
8 8
9 Survey energy deposition and particle's flu 9 Survey energy deposition and particle's flux from an hadronic cascade.
10 Use PhysicsConstructor objects rather than 10 Use PhysicsConstructor objects rather than predefined G4 PhysicsLists.
11 11
12 12
13 1- MATERIALS AND GEOMETRY DEFINITION 13 1- MATERIALS AND GEOMETRY DEFINITION
14 14
15 The geometry is a single sphere (absorber) 15 The geometry is a single sphere (absorber) of an homogenous material.
16 16
17 Two parameters define the geometry : 17 Two parameters define the geometry :
18 - the radius of the sphere 18 - the radius of the sphere
19 - the material of the sphere 19 - the material of the sphere
20 20
21 The default geometry (R=30 cm of water) is 21 The default geometry (R=30 cm of water) is built in
22 DetectorConstruction, but the above paramet 22 DetectorConstruction, but the above parameters can be changed interactively
23 via commands defined in DetectorMessenger. 23 via commands defined in DetectorMessenger.
24 24
25 The absorber is surrounded by a World volum 25 The absorber is surrounded by a World volume (vacuum)
26 26
27 A function, and its associated UI command, 27 A function, and its associated UI command, allows to build a material
28 directly from a single isotope. 28 directly from a single isotope.
29 29
30 To be identified by the ThermalScattering m 30 To be identified by the ThermalScattering module, the elements composing a
31 material must have a specific name (see G4P 31 material must have a specific name (see G4ParticleHPThermalScatteringNames.cc)
32 Examples of such materials are build in Det 32 Examples of such materials are build in DetectorConstruction.
33 33
34 2- PHYSICS LIST 34 2- PHYSICS LIST
35 35
36 "Full" set of physics processes are register 36 "Full" set of physics processes are registered, but via PhysicsConstructor
37 objects rather than complete pre-defined G4 37 objects rather than complete pre-defined G4 physics lists. This alternative
38 way gives more freedom to register physics. 38 way gives more freedom to register physics.
39 39
40 Physics constructors are either constructors 40 Physics constructors are either constructors provided in Geant4 (with G4 prefix)
41 or 'local'. They include : HadronElastic, Ha 41 or 'local'. They include : HadronElastic, HadronInelastic, IonsInelastic, GammaNuclear,
42 RadioactiveDecay and Electomagnetic. 42 RadioactiveDecay and Electomagnetic.
43 (see geant4/source/physics_lists/constructor 43 (see geant4/source/physics_lists/constructors)
44 44
45 HadronElasticPhysicsHP include a model for t 45 HadronElasticPhysicsHP include a model for thermalized neutrons, under the control of a command
46 defined in NeutronHPMesseger. 46 defined in NeutronHPMesseger.
47 47
48 GammmaNuclearPhysics is a subset of G4Bertin 48 GammmaNuclearPhysics is a subset of G4BertiniElectroNuclearBuilder.
49 49
50 ElectromagneticPhysics is a simplified versi 50 ElectromagneticPhysics is a simplified version of G4EmStandardPhysics.
>> 51 In perticular, no step constraint is imposed for energy loss mechanism (ionisation and brems).
>> 52 This is enough when spatial distribution of deposited energy do not need
>> 53 to be accurate (see param->SetStepFunction(1., 1*mm)).
51 54
52 Several hadronic physics options are control 55 Several hadronic physics options are controlled by environment variables.
53 To trigger them, see Hadr06.cc << 56 To trigger them, an envHadronic.csh has been added in this example.
>> 57 One must select the options wished, and do
>> 58 source envHadronic.csh (or sh)
54 59
55 3- AN EVENT : THE PRIMARY GENERATOR 60 3- AN EVENT : THE PRIMARY GENERATOR
56 61
57 The primary kinematic is a single particle 62 The primary kinematic is a single particle randomly shooted at the
58 centre of the sphere. The type of the parti 63 centre of the sphere. The type of the particle and its energy are set in
59 PrimaryGeneratorAction (neutron 14 MeV), an 64 PrimaryGeneratorAction (neutron 14 MeV), and can be changed via the G4
60 build-in commands of ParticleGun class (see 65 build-in commands of ParticleGun class (see the macros provided with
61 this example). 66 this example).
62 67
63 4- PHYSICS 68 4- PHYSICS
64 69
65 The program computes and plots energy depos 70 The program computes and plots energy deposited in the interaction volume
66 (absorber) and the flux of particles leavin 71 (absorber) and the flux of particles leaving this volume.
67 Processes invoked and particles generated d 72 Processes invoked and particles generated during hadronic cascade are listed.
68 73
69 5- HISTOGRAMS 74 5- HISTOGRAMS
70 75
71 The test contains 24 built-in 1D histograms << 76 The test contains 13 built-in 1D histograms, which are managed by
>> 77 G4AnalysisManager and its Messenger. The histos can be individually
>> 78 activated with the command :
>> 79 /analysis/h1/set id nbBins valMin valMax unit
>> 80 where unit is the desired unit for the histo (MeV or keV, etc..)
>> 81 (see the macros xxxx.mac).
72 82
73 1 "total energy deposit" 83 1 "total energy deposit"
74 2 "Edep (MeV/mm) profile along 84 2 "Edep (MeV/mm) profile along radius"
75 3 "total kinetic energy flow" 85 3 "total kinetic energy flow"
76 4 "energy spectrum of gamma at << 86 4 "energy spectrum of emerging gamma"
77 5 "energy spectrum of e+- at c << 87 5 "energy spectrum of emerging e+-"
78 6 "energy spectrum of neutrons << 88 6 "energy spectrum of emerging neutrons"
79 7 "energy spectrum of protons << 89 7 "energy spectrum of emerging protons"
80 8 "energy spectrum of deuteron << 90 8 "energy spectrum of emerging deuterons"
81 9 "energy spectrum of alphas a << 91 9 "energy spectrum of emerging alphas"
82 10 "energy spectrum of all othe << 92 10 "energy spectrum of all others emerging ions"
83 11 "energy spectrum of all othe << 93 11 "energy spectrum of all others emerging baryons"
84 12 "energy spectrum of all othe << 94 12 "energy spectrum of all others emerging mesons"
85 13 "energy spectrum of all othe << 95 13 "energy spectrum of all others emerging leptons (neutrinos)"
86 14 "energy spectrum of emerging << 96
87 15 "energy spectrum of emerging <<
88 16 "energy spectrum of emerging <<
89 17 "energy spectrum of emerging <<
90 18 "energy spectrum of emerging <<
91 19 "energy spectrum of emerging <<
92 20 "energy spectrum of all othe <<
93 21 "energy spectrum of all othe <<
94 22 "energy spectrum of all othe <<
95 23 "energy spectrum of all othe <<
96 24 "total energy released : ede <<
97 <<
98 The histograms are managed by the HistoMana 97 The histograms are managed by the HistoManager class and its Messenger.
99 The histos can be individually activated wi 98 The histos can be individually activated with the command :
100 /analysis/h1/set id nbBins valMin valMax u 99 /analysis/h1/set id nbBins valMin valMax unit
101 where unit is the desired unit for the hist << 100 where unit is the desired unit for the histo (MeV or keV, deg or mrad, etc..)
102 101
103 One can control the name of the histograms 102 One can control the name of the histograms file with the command:
104 /analysis/setFileName name (default Hadr0 103 /analysis/setFileName name (default Hadr06)
105 104
106 It is possible to choose the format of the 105 It is possible to choose the format of the histogram file : root (default),
107 xml, csv, by using namespace in HistoManage 106 xml, csv, by using namespace in HistoManager.hh
108 107
109 It is also possible to print selected histo 108 It is also possible to print selected histograms on an ascii file:
110 /analysis/h1/setAscii id 109 /analysis/h1/setAscii id
111 All selected histos will be written on a fi 110 All selected histos will be written on a file name.ascii (default Hadr04)
112 111
113 6- VISUALIZATION 112 6- VISUALIZATION
114 113
115 The Visualization Manager is set in the mai 114 The Visualization Manager is set in the main().
116 The initialisation of the drawing is done v 115 The initialisation of the drawing is done via the commands
117 /vis/... in the macro vis.mac. To get visua 116 /vis/... in the macro vis.mac. To get visualisation:
118 > /control/execute vis.mac 117 > /control/execute vis.mac
119 118
120 The tracks are drawn at the end of event, a 119 The tracks are drawn at the end of event, and erased at the end of run.
121 gamma green 120 gamma green
122 neutron yellow 121 neutron yellow
123 negative particles (e-, ...) red 122 negative particles (e-, ...) red
124 positive particles (e+, ions, ...) blue 123 positive particles (e+, ions, ...) blue
125 124
126 7- HOW TO START ? 125 7- HOW TO START ?
127 126
128 Execute Hadr06 in 'batch' mode from macro f 127 Execute Hadr06 in 'batch' mode from macro files :
129 % Hadr06 run1.mac 128 % Hadr06 run1.mac
130 129
131 Execute Hadr06 in 'interactive mode' with v 130 Execute Hadr06 in 'interactive mode' with visualization :
132 % Hadr06 131 % Hadr06
133 Idle> control/execute vis.mac 132 Idle> control/execute vis.mac
134 .... 133 ....
135 Idle> type your commands 134 Idle> type your commands
136 .... 135 ....
137 Idle> exit 136 Idle> exit
138 <<
139 Macros provided in this example: <<
140 - hadr06.in: macro used in Geant4 testing to <<
141 - graphite.mac: neutron,14 MeV, in graphite <<
142 - run1.mac: neutron,14 MeV, in Li7 <<
143 - singleFission.mac: single fission in U235 <<
144 <<
145 Macros to be run interactively: <<
146 - debug.mac: water with thermal scattering <<
147 - fission.mac: U235 <<
148 - vis.mac: To activate visualization <<
149 <<