Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/examples/extended/medical/dna/wvalue/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       Geant4 - wvalue example
  3      =========================================================
  4 
  5                                 README file
  6                           ----------------------
  7 
  8                            CORRESPONDING AUTHOR
  9 
 10 S. Incerti (a, *)
 11 a. LP2i, IN2P3 / CNRS / Bordeaux University, 33175 Gradignan, France
 12 * e-mail: incerti@lp2ib.in2p3.fr
 13 
 14 ---->0. INTRODUCTION.
 15 
 16 The wvalue example shows how to calculate w in liquid water
 17 for e- using the Geant4-DNA physics processes and models.
 18 
 19 w is computed as the ratio of the incident particle energy
 20 and the total number of ionisations.
 21 
 22 It is adapted from the svalue example.
 23 
 24 This example is provided by the Geant4-DNA collaboration.
 25 
 26 These processes and models are further described at:
 27 http://geant4-dna.org
 28 
 29 Any report or published results obtained using the Geant4-DNA software shall
 30 cite the following Geant4-DNA collaboration publications:
 31 Med. Phys. 51 (2024) 5873–5889
 32 Med. Phys. 45 (2018) e722-e739
 33 Phys. Med. 31 (2015) 861-874
 34 Med. Phys. 37 (2010) 4692-4708
 35 Int. J. Model. Simul. Sci. Comput. 1 (2010) 157–178
 36 
 37 This example is presented in the following paper, which shall also be cited:
 38 Med. Phys. 42 (2015) 3870-3876
 39 
 40 ---->1. GEOMETRY SET-UP.
 41 
 42 The geometry is a 1 m radius sphere of liquid water (G4_WATER
 43 material). Particles are shot randomly from the sphere centre.
 44 
 45 Radius of the sphere, physics constructor and energy can be
 46 controlled by the wvalue.in macro file.
 47 
 48 The PrimaryGeneratorAction class is adapted (G4 state dependent)
 49 in order to enable generic physics list usage
 50 (empty modular physics list).
 51 
 52 ---->2. SET-UP
 53 
 54 Make sure G4LEDATA points to the low energy electromagnetic data files.
 55 
 56 The code can be compiled with cmake.
 57 
 58 It works in MT mode.
 59 
 60 ---->3. HOW TO RUN THE EXAMPLE
 61 
 62 In interactive mode, run:
 63 
 64 ./wvalue wvalue.in
 65 
 66 The wvalue.in macro allows a full control of the simulation.
 67 
 68 ---->4. PHYSICS
 69 
 70 You can select Geant4-DNA physics constructor in wvalue.in.
 71 
 72 A tracking cut can be applied if requested.
 73 
 74 ---->5. SIMULATION OUTPUT AND RESULT ANALYSIS
 75 
 76 The output results consist in a text file (wvalue.txt), containing:
 77 - the energy of incident particles (in eV)
 78 - the mean number of ionisations
 79 - its rms
 80 - the w value (in eV)
 81 - its rms (in eV)
 82 
 83 Note: rms values correspond to standard deviation.
 84 
 85 In addition, another macro (histo.in) is also provided including
 86 a series of histograms:
 87 - histogram #1 : nb of ionisation interactions per event
 88 - histogram #2 : total energy deposited in absorber
 89 - histogram #3 : true track length of the primary particle
 90 - histogram #4 : true step size of the primary particle
 91 - histogram #5 : projected range of the primary particle
 92 - histogram #6 : true track length of charged secondaries
 93 - histogram #7 : true track length of charged secondaries