1 | $Id: README,v 1.14 2008/06/17 09:35:45 gcosmo Exp $ |
---|
2 | ------------------------------------------------------------------- |
---|
3 | |
---|
4 | ========================================================= |
---|
5 | Geant4 - an Object-Oriented Toolkit for Simulation in HEP |
---|
6 | ========================================================= |
---|
7 | |
---|
8 | Examples module |
---|
9 | --------------- |
---|
10 | |
---|
11 | This module collects three sets of user examples aimed to demonstrate to |
---|
12 | the user how to make correct use of the GEANT4 toolkit by implementing |
---|
13 | in a correct way those user-classes which the user is supposed to |
---|
14 | customize in order to define his/her own simulation setup. |
---|
15 | One set of examples is oriented to "novice" users and covering all |
---|
16 | possible general use-cases typical of an "application"-oriented kind of |
---|
17 | development. An "extended" set of examples require some additional |
---|
18 | libraries besides of Geant4. This set covers some specific use cases |
---|
19 | for actual detector simulation. An "advanced" set of examples covers |
---|
20 | the use-cases typical of a "toolkit"-oriented kind of development, |
---|
21 | where real complete applications for different simulation studies are |
---|
22 | provided; may require additional third party products to be built. |
---|
23 | Most of the examples can be run both in interactive and batch mode, and |
---|
24 | input macro files (*.in) and reference output files (*.out) are provided. |
---|
25 | Novice and most of the extended examples are considered part of the |
---|
26 | system testing suite for validation of the official releases of the |
---|
27 | GEANT4 toolkit. Novice examples and some of the extended and advanced |
---|
28 | examples are also used as "acceptance"-tests for the release process. |
---|
29 | |
---|
30 | Novice level examples |
---|
31 | ExampleN01 |
---|
32 | - Mandatory user classes |
---|
33 | - Demonstrates how Geant4 kernel works |
---|
34 | ExampleN02 |
---|
35 | - Simplified tracker geometry with uniform magnetic field |
---|
36 | - Electromagnetic processes |
---|
37 | ExampleN03 |
---|
38 | - Simplified calorimeter geometry |
---|
39 | - Electromagnetic processes |
---|
40 | - Various materials |
---|
41 | ExampleN04 |
---|
42 | - Simplified collider detector with a readout geometry |
---|
43 | - Full "ordinary" processes |
---|
44 | - PYTHIA primary events |
---|
45 | - Event filtering by stack |
---|
46 | ExampleN05 |
---|
47 | - Simplified BaBar calorimeter |
---|
48 | - EM shower parametrisation |
---|
49 | ExampleN06 |
---|
50 | - Optical photon processes |
---|
51 | ExampleN07 |
---|
52 | - Regions and parameterised materials |
---|
53 | |
---|
54 | Extended level examples |
---|
55 | analysis |
---|
56 | - Histogramming through the AIDA interface |
---|
57 | biasing |
---|
58 | - Examples of event biasing and scoring |
---|
59 | electromagnetic |
---|
60 | - Specific EM physics simulation with histogramming |
---|
61 | errorpropagation |
---|
62 | - Use of the error propagation utility (Geant4e). |
---|
63 | eventgenerator |
---|
64 | - Applications using interface to HepMC |
---|
65 | exoticphysics |
---|
66 | - Exotic simulation applications (classical magnetic monopole, etc...) |
---|
67 | field |
---|
68 | - Specific simulation setups in magnetic field |
---|
69 | g3tog3 |
---|
70 | - Examples of usage of the g3tog4 converter tool |
---|
71 | gdml |
---|
72 | - Example of import/export detector persistency through the Geometry |
---|
73 | Description Markup Language (GDML) |
---|
74 | geometry |
---|
75 | - Specific geometry examples and tools: OLAP tool for detection |
---|
76 | of overlapping geometries |
---|
77 | hadronic |
---|
78 | - Specific hadronic physics simulation with histogramming |
---|
79 | medical |
---|
80 | - Specific examples for medical physics applications |
---|
81 | optical |
---|
82 | - Examples of generic optical processes simulation setups |
---|
83 | parallel |
---|
84 | - Examples of event-level parallelism in Geant4 using the |
---|
85 | TOP-C distribution, and distributed runs through DIANE |
---|
86 | parameterisations |
---|
87 | - Examples for fast shower parameterisations according to specific models |
---|
88 | persistency |
---|
89 | - Persistency of simulation outputs through Reflex tool |
---|
90 | radioactivedecay |
---|
91 | - Examples to simulate the decays of radioactive isotopes and |
---|
92 | induced radioactivity resulted from nuclear interactions |
---|
93 | runAndEvent |
---|
94 | - Examples to demonstrate how to connect the information between |
---|
95 | primary particles and hits and utilize user-information classes |
---|
96 | visualization |
---|
97 | - Specific visualization features and graphical customisations |
---|
98 | |
---|
99 | Advanced level examples |
---|
100 | air_shower |
---|
101 | - Simulation of the ULTRA detector for UV and charged particles |
---|
102 | detection in cosmic rays |
---|
103 | brachytherapy |
---|
104 | - Setup for brachytherapy Ir-192 HDR source |
---|
105 | composite_calorimeter |
---|
106 | - Test-beam simulation used in CMS against real data taken |
---|
107 | in 1996 in a CMS Hadron calorimeter test-beam at LHC |
---|
108 | cosmicray_charging |
---|
109 | - Simulation of electrostatic charging in the LISA mission by |
---|
110 | galactic cosmic ray protons and helium nuclei |
---|
111 | gammaray_telescope |
---|
112 | - Simulation of a typical telescope for gamma ray analysis |
---|
113 | hadrontherapy |
---|
114 | - Simulation of a hadron therapy beam line |
---|
115 | human_phantom |
---|
116 | - Anthropomorphic phantoms (male and female) based on MIRD/ORNL model |
---|
117 | with geometry description derived from GDML persistent files |
---|
118 | lAr_calorimeter |
---|
119 | - Simulation of the Liquid Argon Calorimeter of the ATLAS |
---|
120 | Detector at LHC |
---|
121 | medical_linac |
---|
122 | - Simulation of energy deposit in a Phantom filled with water |
---|
123 | for a typical linac used for intensity modulated radiation therapy |
---|
124 | microbeam |
---|
125 | - Simulation of the cellular irradiation beam line installed on the AIFIRA |
---|
126 | electrostatic accelerator facility located at CENBG, France |
---|
127 | microdosimetry |
---|
128 | - Simulation of DNA physics processes with track of a 10 keV Helium+ |
---|
129 | (positive charge is +e) particle in liquid water. |
---|
130 | nanobeam |
---|
131 | - Simulation of the beam optics of the nanobeam line installed on the AIFIRA |
---|
132 | electrostatic accelerator facility located at CENBG, France. |
---|
133 | purging_magnet |
---|
134 | - Simulation of electrons traveling through a 3D magnetic field of a |
---|
135 | strong purging magnet used for treatment head in a medical environment |
---|
136 | radiation_monitor |
---|
137 | - Application to study the effects of a chip carrier on silicon radiation |
---|
138 | monitoring devices used in the LHC environment |
---|
139 | radioprotection |
---|
140 | - Application for the evaluation of dose in astronauts, vehicle concepts |
---|
141 | and Moon surface habitat configurations, in a space radiation environment |
---|
142 | raredecay_calorimetry |
---|
143 | - Simulation of a simplified sandwitch calorimeter to Estimate importance |
---|
144 | of photonuclear reactions for photon inefficiency |
---|
145 | Rich |
---|
146 | - Rich Test Beam Simulation |
---|
147 | Tiara |
---|
148 | - Simulation of the TIARA experiment using importance sampling |
---|
149 | underground_physics |
---|
150 | - Setup of an underground dark matter experiment |
---|
151 | xray_fluorescence |
---|
152 | - Test beam to characterize the response function of an |
---|
153 | HPGe detector used to measure fluorescence emissions |
---|
154 | xray_telescope |
---|
155 | - Realistic simulation of an X-ray Telescope |
---|
156 | |
---|