| 1 | $Id: README,v 1.12 2007/08/28 10:20:39 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 | purging_magnet |
|---|
| 128 | - Simulation of electrons traveling through a 3D magnetic field of a |
|---|
| 129 | strong purging magnet used for treatment head in a medical environment |
|---|
| 130 | radiation_monitor |
|---|
| 131 | - Application to study the effects of a chip carrier on silicon radiation |
|---|
| 132 | monitoring devices used in the LHC environment |
|---|
| 133 | radioprotection |
|---|
| 134 | - Application for the evaluation of dose in astronauts, vehicle concepts |
|---|
| 135 | and Moon surface habitat configurations, in a space radiation environment |
|---|
| 136 | raredecay_calorimetry |
|---|
| 137 | - Simulation of a simplified sandwitch calorimeter to Estimate importance |
|---|
| 138 | of photonuclear reactions for photon inefficiency |
|---|
| 139 | Rich |
|---|
| 140 | - Rich Test Beam Simulation |
|---|
| 141 | Tiara |
|---|
| 142 | - Simulation of the TIARA experiment using importance sampling |
|---|
| 143 | underground_physics |
|---|
| 144 | - Setup of an underground dark matter experiment |
|---|
| 145 | xray_fluorescence |
|---|
| 146 | - Test beam to characterize the response function of an |
|---|
| 147 | HPGe detector used to measure fluorescence emissions |
|---|
| 148 | xray_telescope |
|---|
| 149 | - Realistic simulation of an X-ray Telescope |
|---|
| 150 | |
|---|
