| 1 | $Id: README,v 1.15 2009/11/20 16:22:14 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, scoring and reverse-MC
|
|---|
| 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 | geometry
|
|---|
| 72 | - Specific geometry examples and tools: OLAP tool for detection
|
|---|
| 73 | of overlapping geometries
|
|---|
| 74 | hadronic
|
|---|
| 75 | - Specific hadronic physics simulation with histogramming
|
|---|
| 76 | medical
|
|---|
| 77 | - Specific examples for medical physics applications
|
|---|
| 78 | optical
|
|---|
| 79 | - Examples of generic optical processes simulation setups
|
|---|
| 80 | parallel
|
|---|
| 81 | - Examples of event-level parallelism in Geant4 using the
|
|---|
| 82 | TOP-C distribution, and distributed runs through DIANE
|
|---|
| 83 | parameterisations
|
|---|
| 84 | - Examples for fast shower parameterisations according to specific models
|
|---|
| 85 | persistency
|
|---|
| 86 | - Persistency of geometry (GDML or ASCII) and simulation output
|
|---|
| 87 | radioactivedecay
|
|---|
| 88 | - Examples to simulate the decays of radioactive isotopes and
|
|---|
| 89 | induced radioactivity resulted from nuclear interactions
|
|---|
| 90 | runAndEvent
|
|---|
| 91 | - Examples to demonstrate how to connect the information between
|
|---|
| 92 | primary particles and hits and utilize user-information classes
|
|---|
| 93 | visualization
|
|---|
| 94 | - Specific visualization features and graphical customisations
|
|---|
| 95 |
|
|---|
| 96 | Advanced level examples
|
|---|
| 97 | air_shower
|
|---|
| 98 | - Simulation of the ULTRA detector for UV and charged particles
|
|---|
| 99 | detection in cosmic rays
|
|---|
| 100 | brachytherapy
|
|---|
| 101 | - Setup for brachytherapy Ir-192 HDR source
|
|---|
| 102 | composite_calorimeter
|
|---|
| 103 | - Test-beam simulation used in CMS against real data taken
|
|---|
| 104 | in 1996 in a CMS Hadron calorimeter test-beam at LHC
|
|---|
| 105 | gammaray_telescope
|
|---|
| 106 | - Simulation of a typical telescope for gamma ray analysis
|
|---|
| 107 | hadrontherapy
|
|---|
| 108 | - Simulation of a hadron therapy beam line
|
|---|
| 109 | human_phantom
|
|---|
| 110 | - Anthropomorphic phantoms (male and female) based on MIRD/ORNL model
|
|---|
| 111 | with geometry description derived from GDML persistent files
|
|---|
| 112 | lAr_calorimeter
|
|---|
| 113 | - Simulation of the Liquid Argon Calorimeter of the ATLAS
|
|---|
| 114 | Detector at LHC
|
|---|
| 115 | medical_linac
|
|---|
| 116 | - Simulation of energy deposit in a Phantom filled with water
|
|---|
| 117 | for a typical linac used for intensity modulated radiation therapy
|
|---|
| 118 | microbeam
|
|---|
| 119 | - Simulation of the cellular irradiation beam line installed on the AIFIRA
|
|---|
| 120 | electrostatic accelerator facility located at CENBG, France
|
|---|
| 121 | microdosimetry
|
|---|
| 122 | - Simulation of DNA physics processes with track of a 10 keV Helium+
|
|---|
| 123 | (positive charge is +e) particle in liquid water.
|
|---|
| 124 | nanobeam
|
|---|
| 125 | - Simulation of the beam optics of the nanobeam 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 | radioprotection
|
|---|
| 131 | - Application for the evaluation of dose in astronauts, vehicle concepts
|
|---|
| 132 | and Moon surface habitat configurations, in a space radiation environment
|
|---|
| 133 | Rich
|
|---|
| 134 | - Rich Test Beam Simulation
|
|---|
| 135 | underground_physics
|
|---|
| 136 | - Setup of an underground dark matter experiment
|
|---|
| 137 | xray_fluorescence
|
|---|
| 138 | - Test beam to characterize the response function of an
|
|---|
| 139 | HPGe detector used to measure fluorescence emissions
|
|---|
| 140 | xray_telescope
|
|---|
| 141 | - Realistic simulation of an X-ray Telescope
|
|---|
| 142 |
|
|---|