Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/examples/extended/electromagnetic/TestEm17/README

Version: [ ReleaseNotes ] [ 1.0 ] [ 1.1 ] [ 2.0 ] [ 3.0 ] [ 3.1 ] [ 3.2 ] [ 4.0 ] [ 4.0.p1 ] [ 4.0.p2 ] [ 4.1 ] [ 4.1.p1 ] [ 5.0 ] [ 5.0.p1 ] [ 5.1 ] [ 5.1.p1 ] [ 5.2 ] [ 5.2.p1 ] [ 5.2.p2 ] [ 6.0 ] [ 6.0.p1 ] [ 6.1 ] [ 6.2 ] [ 6.2.p1 ] [ 6.2.p2 ] [ 7.0 ] [ 7.0.p1 ] [ 7.1 ] [ 7.1.p1 ] [ 8.0 ] [ 8.0.p1 ] [ 8.1 ] [ 8.1.p1 ] [ 8.1.p2 ] [ 8.2 ] [ 8.2.p1 ] [ 8.3 ] [ 8.3.p1 ] [ 8.3.p2 ] [ 9.0 ] [ 9.0.p1 ] [ 9.0.p2 ] [ 9.1 ] [ 9.1.p1 ] [ 9.1.p2 ] [ 9.1.p3 ] [ 9.2 ] [ 9.2.p1 ] [ 9.2.p2 ] [ 9.2.p3 ] [ 9.2.p4 ] [ 9.3 ] [ 9.3.p1 ] [ 9.3.p2 ] [ 9.4 ] [ 9.4.p1 ] [ 9.4.p2 ] [ 9.4.p3 ] [ 9.4.p4 ] [ 9.5 ] [ 9.5.p1 ] [ 9.5.p2 ] [ 9.6 ] [ 9.6.p1 ] [ 9.6.p2 ] [ 9.6.p3 ] [ 9.6.p4 ] [ 10.0 ] [ 10.0.p1 ] [ 10.0.p2 ] [ 10.0.p3 ] [ 10.0.p4 ] [ 10.1 ] [ 10.1.p1 ] [ 10.1.p2 ] [ 10.1.p3 ] [ 10.2 ] [ 10.2.p1 ] [ 10.2.p2 ] [ 10.2.p3 ] [ 10.3 ] [ 10.3.p1 ] [ 10.3.p2 ] [ 10.3.p3 ] [ 10.4 ] [ 10.4.p1 ] [ 10.4.p2 ] [ 10.4.p3 ] [ 10.5 ] [ 10.5.p1 ] [ 10.6 ] [ 10.6.p1 ] [ 10.6.p2 ] [ 10.6.p3 ] [ 10.7 ] [ 10.7.p1 ] [ 10.7.p2 ] [ 10.7.p3 ] [ 10.7.p4 ] [ 11.0 ] [ 11.0.p1 ] [ 11.0.p2 ] [ 11.0.p3, ] [ 11.0.p4 ] [ 11.1 ] [ 11.1.1 ] [ 11.1.2 ] [ 11.1.3 ] [ 11.2 ] [ 11.2.1 ] [ 11.2.2 ] [ 11.3.0 ] 

  1 -------------------------------------------------------------------
  2 
  3      =========================================================
  4      Geant4 - an Object-Oriented Toolkit for Simulation in HEP
  5      =========================================================
  6  
  7                             TestEm17
  8                             --------
  9         This example is intended to check implementation of the processes 
 10         of muon interactions: ionization, direct (e+,e-) production, mu+mu- 
 11   pair production, bremsstrahlung, and mu-nuclear interaction.
 12   It allows to compute differential cross sections (as function of the
 13   energy transfered to secondaries), total cross sections, and to compare
 14   with analytic calculations.
 15   
 16  1- GEOMETRY DEFINITION
 17  
 18   It is a single box of homogeneous medium.
 19   Two parameters define the geometry :
 20   - the material of the box,
 21   - the (full) size of the box.
 22   
 23   The default geometry (1 m of Iron) is constructed in 
 24   DetectorConstruction, but the above parameters can be changed 
 25   interactively via the commands defined in DetectorMessenger.
 26   
 27  2- PHYSICS LIST
 28  
 29   The Physics List of the example uses the main physics constructor
 30         (builder) called "local", which includes only muon, pion, and proton
 31         processes under study. As an alternative standard "emstandard_opt0"
 32         and "emstandard_opt4" constructors may be used.
 33 
 34         Default energy range for EM processes in this example 
 35         is from 100*eV to 1000*PeV.
 36 
 37         Optionally "muNucl" builder may be added activating muon-nuclear 
 38         inelastic interaction.
 39      
 40  3- AN EVENT : THE PRIMARY GENERATOR
 41  
 42   The primary kinematic consists of a single particle starting at the edge
 43   of the box. The type of the particle and its energy are set in 
 44   PrimaryGeneratorAction (mu+ 10 TeV), and can be changed via the G4 
 45   build-in commands of ParticleGun class (see the macros provided with 
 46   this example).
 47   
 48  4- PHYSICS
 49  
 50   The incident particle is a muon. During the tracking, secondary
 51   particles are killed.
 52   
 53   The number of interactions are plotted as a function of the energy 
 54   transfered to the secondaries.
 55   The total number of interactions is recorded, and the total cross 
 56         section computed from this.  
 57 
 58         At RunAction::EndOfRun(..), the above results are compared with analytical
 59         calculations. The functions computing the theoretical cross sections have been
 60   provided by the G4 MEPhI group, and implemented in MuCrossSections class.
 61 
 62  5- HISTOGRAMS
 63          
 64   The test contains built-in 1D histograms for muons filled during
 65         Monte Carlo simulation, which are managed by the HistoManager class 
 66         and its Messenger:
 67 
 68         1 Relative muon transferred energy distribution 
 69             (log10(eps/Emu kin) for knock-on electrons (ionization)
 70         2  -"- direct (e+,e-) pair production by muons
 71         3  -"- bremsstrahlung by muons
 72         4  -"- nuclear interaction by muons
 73         5  ionistion for hadrons
 74         6  (e+,e-) pair production by hadrons
 75         7  bremsstrahlung by hadrons
 76   8  direct mu+,mu- pair production by muons
 77 
 78   The histos can be activated individually with the command :
 79   /testem/histo/setHisto id nbBins  valMin valMax : 
 80           min and max values of log10(eps/Emu kin).
 81   
 82   At EndOfRun the corresponding histos for analytic calculations are
 83   automatically created and filled (histo 11 to 14, and 18).
 84                 
 85   One can control the name and the type of the histograms file with 
 86   the command:
 87   /testem/histo/setFileName  name  (default testem17)
 88                   
 89  6- VISUALIZATION
 90  
 91   The Visualization Manager is set in the main().
 92   The initialisation of the drawing is done via the commands
 93   /vis/... in the macro vis.mac. To get visualisation:
 94   > /control/execute vis.mac
 95   
 96   The detector has a default view which is a longitudinal view of the 
 97   box.
 98   
 99   The tracks are drawn at the end of event, and erased at the end of run.
100   
101  7- HOW TO START ?
102  
103   execute TestEm17 in 'batch' mode from macro files :
104     % TestEm17   allproc.mac
105     
106   execute TestEm17 in 'interactive mode' with visualization :
107     % TestEm17
108     Idle> control/execute vis.mac
109     ....
110     Idle> type your commands
111     ....
112     Idle> exit