Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/examples/extended/medical/electronScattering/

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 ]

Name Size       Last modified (GMT) Description
Back Parent directory       2024-12-05 15:16:16
Folder EGS_13MeV/       2024-12-05 15:16:16
Folder data/       2024-12-05 15:16:16
Folder include/       2024-12-05 15:16:16
Folder results/       2024-12-05 15:16:16
Folder src/       2024-12-05 15:16:16
File CMakeLists.txt 2184 bytes       2024-12-05 15:16:16
File GNUmakefile 549 bytes       2024-12-05 15:16:16
File History 8008 bytes       2024-12-05 15:16:16
File NRCC_electron_scat.pdf 242486 bytes       2024-12-05 15:16:16
File README 5028 bytes       2024-12-05 15:16:16
C++ file electronScattering.cc 3793 bytes       2024-12-05 15:16:16
File electronScattering.in 557 bytes       2024-12-05 15:16:16
File electronScattering.out 39972 bytes       2024-12-05 15:16:16
File scatter.mac 1002 bytes       2024-12-05 15:16:16
File vis.mac 2027 bytes       2024-12-05 15:16:16

  1 -----------------------------------------------------
  2 
  3      =========================================================
  4      Geant4 - an Object-Oriented Toolkit for Simulation in HEP
  5      =========================================================
  6 
  7                             electronScattering   
  8                             ------------------
  9 
 10  Electron scattering benchmark (T. O'Shea and B. Faddegon)
 11   
 12  1- GEOMETRY DEFINITION
 13  
 14  The geometry is described in the enclosed documument : NRCC_electron_scat.pdf
 15     
 16  A "World" volume contains a "Frame" made of Air. 
 17  The Frame contains : ExitWindow, ScatterFoil, MonitorChbr, Bag.
 18  The Bag contains a Gas volume, which contains 2 aluminium Rings
 19  The Scoring plane is the end-plane of the Frame
 20   
 21  The default geometry is constructed in DetectorConstruction class.
 22  The parameters of the ScatterFoil (material and thickness) must be defined
 23  via 2 UI commands : see the macro scatter.mac
 24  
 25  2- PHYSICS LIST
 26  
 27  Physics lists can be local (eg. in this example) or from G4 kernel
 28  physics_lists subdirectory.
 29      
 30  Local physics lists:  
 31  - "local"  standard EM physics with current 'best' options setting.
 32                 these options are explicited in PhysListEmStandard
 33  - "standardSS" standard EM physics with single Coulomb scattering 
 34                 instead of multiple scattering      
 35     
 36  From geant4/source/physics_lists/builders:  
 37  - "emstandard_opt0"  recommended standard EM physics for LHC
 38  - "emstandard_opt1"  best CPU performance standard physics for LHC
 39  - "emstandard_opt2"  alternative models    
 40  - "emstandard_opt3"  current state of art for EM physics
 41                       analog to "local"above
 42     
 43  Physics lists and options can be (re)set with UI commands
 44     
 45  Please, notice that options set through G4EmProcessOPtions are global, eg
 46  for all particle types. In G4 builders, it is shown how to set options per
 47  particle type.
 48 
 49           
 50  3- PRIMARY GENERATOR : mono-enegetic pencil beam
 51  
 52  The primary kinematic consists of a single particle which hits the detector 
 53  perpendicular to the input face (ExitWindow). The type of the particle and its
 54  energy are set in the PrimaryGeneratorAction class, and can be changed via 
 55  the G4 build-in commands of ParticleGun class. 
 56  (see the macros provided with this example)
 57   
 58  The incident beam has a Gaussian-shaped spatial distribution. The rms of the 
 59  Gaussian can be define with an UI command built in PrimaryGeneratorMessenger.
 60  
 61  4- VISUALIZATION
 62  
 63  The Visualization Manager is set in the main().
 64  The initialisation of the drawing is done via the commands in vis.mac
 65  In interactive session:
 66  PreInit or Idle > /control/execute vis.mac
 67   
 68  The example has a default view which is a longitudinal view of the detector.
 69   
 70  The tracks are drawn at the end of event, and erased at the end of run.
 71  Optionaly one can choose to draw all particles, only the charged, or none.
 72  This command is defined in EventActionMessenger class.
 73  
 74  5- TRACKING
 75  
 76  One can  limit 'by hand' the step lenght of the particle. As an example,
 77  this limitation is implemented as a 'full' process : see StepMax class and its
 78  Messenger. The 'StepMax process' is registered in the Physics List. 
 79     
 80  6- DETECTOR RESPONSE
 81     
 82  At the end of a run, from the histogram(s), one can study different
 83  physics quantities, via the histograms defined below.
 84  
 85  An ascii file corresponding to histo 4 (see below) is automatically written.
 86 
 87  
 88  7- List of the built-in histograms
 89  ----------------------------------
 90         
 91  The test contains 4 built-in 1D histograms, which are managed by
 92  G4AnalysisManager class and its Messenger. The histos can be individually activated
 93  with the command :
 94  /analysis/h1/set id nbBins  valMin valMax unit 
 95  where unit is the desired unit for the histo (MeV or keV, deg or mrad, etc..)
 96  (see the macros xxxx.mac).
 97  
 98   1 "(charged particles): projected angle at Scoring plane"
 99   2 "(charged particles): dN/dS at Scoring plane"
100   3 "(charged particles): d(N/cost)/dS at Scoring plane"
101   4 "(charged particles): normalized d(N/cost)/dS at Scoring plane"
102         5       "(charged particles); scattering angle theta"
103         6       "(charged particles); measured scattering angle theta"
104 
105  The histograms can be viewed using ROOT or PAW.
106  
107  One can control the name and format of the histograms file with the command:
108  /analysis/setFileName  name  (default nrccBenchmark) 
109  It is possible to choose the format of the histogram file : root (default),
110  xml, csv, by using namespace in HistoManager.hh   
111  It is also possible to print selected histograms on an ascii file:
112  /analysis/h1/setAscii id
113  All selected histos will be written on a file name.ascii (default nrccBenchmark)
114 
115   
116  8- HOW TO START ?
117  
118  - execute electronScattering in 'batch' mode from macro files e.g.
119   % electronScattering   myMacro.mac
120     
121  - execute electronScattering in 'interactive' mode with visualization e.g.
122   % electronScattering
123   Then type your commands, for instance :
124   Idle> control/execute vis.mac
125   Idle> run/beamOn 5
126   ....