| Geant4 Cross Reference |
>> 1 $Id: README,v 1.16 2010-11-29 10:34:36 gcosmo Exp $
1 ---------------------------------------------- 2 -------------------------------------------------------------------
2 3
3 ========================================= 4 =========================================================
4 Geant4 - an Object-Oriented Toolkit for S 5 Geant4 - an Object-Oriented Toolkit for Simulation in HEP
5 ========================================= 6 =========================================================
6 7
7 Examples module 8 Examples module
8 --------------- 9 ---------------
9 10
10 This module collects three sets of user exampl << 11 This module collects four sets of user examples aimed to demonstrate to
11 the user how to make correct use of the GEANT4 12 the user how to make correct use of the GEANT4 toolkit by implementing
12 in a correct way those user-classes which the 13 in a correct way those user-classes which the user is supposed to
13 customize in order to define his/her own simul 14 customize in order to define his/her own simulation setup.
14 15
15 The "basic" set of examples is oriented to nov << 16 The "novice" set of examples is oriented to novice users and covering all
16 the most typical use-cases of a Geant4 applica << 17 possible general use-cases typical of an "application"-oriented kind of
17 and ease of use. << 18 development. As several examples in this "novice" set became too complicated,
18 << 19 a new "basic" set, covering the most typical use-cases of a Geant4 application
19 An "extended" set of examples may require some << 20 with keeping simplicity and ease of use, is provided and is going to replace
20 of Geant4. This set covers many specific use c << 21 the "novice" set in future.
21 simulation. << 22
22 << 23 An "extended" set of examples require some additional
23 An "advanced" set of examples covers the use-c << 24 libraries besides of Geant4. This set covers some specific use cases
24 "toolkit"-oriented kind of development, where << 25 for actual detector simulation. An "advanced" set of examples covers
25 for different simulation studies are provided; << 26 the use-cases typical of a "toolkit"-oriented kind of development,
26 party products to be built. << 27 where real complete applications for different simulation studies are
>> 28 provided; may require additional third party products to be built.
27 29
28 Most of the examples can be run both in intera 30 Most of the examples can be run both in interactive and batch mode, and
29 input macro files (*.in) and reference output 31 input macro files (*.in) and reference output files (*.out) are provided.
30 See the detailed instructions how to build and << 32 Basic, novice and most of the extended examples are considered part of the
31 in README.HowToRun and README.HowToRunTestEm1. <<
32 an example in multi-threading mode can be foun <<
33 <<
34 Basic and most of the extended examples are co <<
35 system testing suite for validation of the off 33 system testing suite for validation of the official releases of the
36 GEANT4 toolkit. Basic and some of the extended << 34 GEANT4 toolkit. Basic, novice and some of the extended and advanced
37 examples are also used as "acceptance"-tests f 35 examples are also used as "acceptance"-tests for the release process.
38 36
39 The previous set of examples oriented to novic << 37 Basic examples
40 has been refactored in "basic" and "extended" << 38 ExampleB1
41 The source code of the last version of the ori << 39 - Simple geometry with a few solids
42 (in 9.6.p02 release) can be viewed in the Gean << 40 - Scoring total dose in a selected volume user action classes
43 http://www-geant4.kek.jp/lxr/source/examples << 41
44 << 42 ExampleB2
45 And more on what is common for all examples: << 43 - Simplified tracker geometry with global constant magnetic field
46 - README.HowToRun << 44 - Scoring within tracker via G4 sensitive detector and hits
47 - README.HowToRunMT << 45 - Started from novice/N02 example
48 << 46
49 Web: https://geant4-userdoc.web.cern.ch/Doxyge << 47 ExampleB3
>> 48 - Simplified calorimeter crystals
>> 49 - Radioactive source
>> 50 - Scoring within Crystals via G4 scorers
>> 51
>> 52 ExampleB4
>> 53 - Simplified calorimeter with layers of two materials
>> 54 - Scoring within layers in four ways: via user actions (a), via user own
>> 55 object (b), via G4 sensitive detector and hits (c) and via scorers (d)
>> 56
>> 57 Novice level examples
>> 58 ExampleN01
>> 59 - Mandatory user classes
>> 60 - Demonstrates how Geant4 kernel works
>> 61 ExampleN02
>> 62 - Simplified tracker geometry with uniform magnetic field
>> 63 - Electromagnetic processes
>> 64 ExampleN03
>> 65 - Simplified calorimeter geometry
>> 66 - Electromagnetic processes
>> 67 - Various materials
>> 68 ExampleN04
>> 69 - Simplified collider detector with a readout geometry
>> 70 - Full "ordinary" processes
>> 71 - PYTHIA primary events
>> 72 - Event filtering by stack
>> 73 ExampleN05
>> 74 - Simplified BaBar calorimeter
>> 75 - EM shower parametrisation
>> 76 ExampleN06
>> 77 - Optical photon processes
>> 78 ExampleN07
>> 79 - Regions and parameterised materials
>> 80
>> 81 Extended level examples
>> 82 analysis
>> 83 - Histogramming through the AIDA interface
>> 84 biasing
>> 85 - Examples of event biasing, scoring and reverse-MC
>> 86 common
>> 87 - A set of common classes which can be reused in other examples demonstrating
>> 88 just a particular feature
>> 89 electromagnetic
>> 90 - Specific EM physics simulation with histogramming
>> 91 errorpropagation
>> 92 - Use of the error propagation utility (Geant4e)
>> 93 eventgenerator
>> 94 - Applications using interface to HepMC
>> 95 exoticphysics
>> 96 - Exotic simulation applications (classical magnetic monopole, etc...)
>> 97 field
>> 98 - Specific simulation setups in magnetic field
>> 99 g3tog3
>> 100 - Examples of usage of the g3tog4 converter tool
>> 101 geometry
>> 102 - Specific geometry examples and tools: OLAP tool for detection
>> 103 of overlapping geometries
>> 104 hadronic
>> 105 - Specific hadronic physics simulation with histogramming
>> 106 medical
>> 107 - Specific examples for medical physics applications
>> 108 optical
>> 109 - Examples of generic optical processes simulation setups
>> 110 parallel
>> 111 - Examples of event-level parallelism in Geant4 using the
>> 112 TOP-C distribution, and MPI technique
>> 113 parameterisations
>> 114 - Examples for fast shower parameterisations according to specific models
>> 115 persistency
>> 116 - Persistency of geometry (GDML or ASCII) and simulation output
>> 117 radioactivedecay
>> 118 - Examples to simulate the decays of radioactive isotopes and
>> 119 induced radioactivity resulted from nuclear interactions
>> 120 runAndEvent
>> 121 - Examples to demonstrate how to connect the information between
>> 122 primary particles and hits and utilize user-information classes
>> 123 visualization
>> 124 - Specific visualization features and graphical customisations
>> 125
>> 126 Advanced level examples
>> 127 air_shower
>> 128 - Simulation of the ULTRA detector for UV and charged particles
>> 129 detection in cosmic rays
>> 130 amsEcal
>> 131 - Simplified AMS Ecal calorimeter structure
>> 132 brachytherapy
>> 133 - Setup for brachytherapy Ir-192 HDR source
>> 134 ChargeExchangeMC
>> 135 - Charge Exchange Monte Carlo
>> 136 composite_calorimeter
>> 137 - Test-beam simulation used in CMS against real data taken
>> 138 in 1996 in a CMS Hadron calorimeter test-beam at LHC
>> 139 eRosita
>> 140 - Simplified eROSITA X-ray telescope setup for instrumental background
>> 141 simulations for fluorescence measurements.
>> 142 gammaray_telescope
>> 143 - Simulation of a typical telescope for gamma ray analysis
>> 144 hadrontherapy
>> 145 - Simulation of a hadron therapy beam line
>> 146 human_phantom
>> 147 - Anthropomorphic phantoms (male and female) based on MIRD/ORNL model
>> 148 with geometry description derived from GDML persistent files
>> 149 lAr_calorimeter
>> 150 - Simulation of the Liquid Argon Calorimeter of the ATLAS
>> 151 Detector at LHC
>> 152 medical_linac
>> 153 - Simulation of energy deposit in a Phantom filled with water
>> 154 for a typical linac used for intensity modulated radiation therapy
>> 155 microbeam
>> 156 - Simulation of the cellular irradiation beam line installed on the AIFIRA
>> 157 electrostatic accelerator facility located at CENBG, France
>> 158 microdosimetry
>> 159 - Simulation of DNA physics processes with track of a 10 keV Helium+
>> 160 (positive charge is +e) particle in liquid water.
>> 161 nanobeam
>> 162 - Simulation of the beam optics of the nanobeam line installed on the AIFIRA
>> 163 electrostatic accelerator facility located at CENBG, France.
>> 164 purging_magnet
>> 165 - Simulation of electrons traveling through a 3D magnetic field of a
>> 166 strong purging magnet used for treatment head in a medical environment
>> 167 radioprotection
>> 168 - Application for the evaluation of dose in astronauts, vehicle concepts
>> 169 and Moon surface habitat configurations, in a space radiation environment
>> 170 Rich
>> 171 - Rich Test Beam Simulation
>> 172 underground_physics
>> 173 - Setup of an underground dark matter experiment
>> 174 xray_fluorescence
>> 175 - Test beam to characterize the response function of an
>> 176 HPGe detector used to measure fluorescence emissions
>> 177 xray_telescope
>> 178 - Realistic simulation of an X-ray Telescope
50 179