[807] | 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 | |
---|