Warning, /geant4/examples/extended/medical/dna/wvalue/README is written in an unsupported language. File is not indexed.
0001 =========================================================
0002 Geant4 - wvalue example
0003 =========================================================
0004
0005 README file
0006 ----------------------
0007
0008 CORRESPONDING AUTHOR
0009
0010 S. Incerti (a, *)
0011 a. LP2i, IN2P3 / CNRS / Bordeaux University, 33175 Gradignan, France
0012 * e-mail: incerti@lp2ib.in2p3.fr
0013
0014 ---->0. INTRODUCTION.
0015
0016 The wvalue example shows how to calculate w in liquid water
0017 for e- using the Geant4-DNA physics processes and models.
0018
0019 w is computed as the ratio of the incident particle energy
0020 and the total number of ionisations.
0021
0022 It is adapted from the svalue example.
0023
0024 This example is provided by the Geant4-DNA collaboration.
0025
0026 These processes and models are further described at:
0027 http://geant4-dna.org
0028
0029 Any report or published results obtained using the Geant4-DNA software shall
0030 cite the following Geant4-DNA collaboration publications:
0031 Med. Phys. 51 (2024) 5873–5889
0032 Med. Phys. 45 (2018) e722-e739
0033 Phys. Med. 31 (2015) 861-874
0034 Med. Phys. 37 (2010) 4692-4708
0035 Int. J. Model. Simul. Sci. Comput. 1 (2010) 157–178
0036
0037 This example is presented in the following paper, which shall also be cited:
0038 Med. Phys. 42 (2015) 3870-3876
0039
0040 ---->1. GEOMETRY SET-UP.
0041
0042 The geometry is a 1 m radius sphere of liquid water (G4_WATER
0043 material). Particles are shot randomly from the sphere centre.
0044
0045 Radius of the sphere, physics constructor and energy can be
0046 controlled by the wvalue.in macro file.
0047
0048 The PrimaryGeneratorAction class is adapted (G4 state dependent)
0049 in order to enable generic physics list usage
0050 (empty modular physics list).
0051
0052 ---->2. SET-UP
0053
0054 Make sure G4LEDATA points to the low energy electromagnetic data files.
0055
0056 The code can be compiled with cmake.
0057
0058 It works in MT mode.
0059
0060 ---->3. HOW TO RUN THE EXAMPLE
0061
0062 In interactive mode, run:
0063
0064 ./wvalue wvalue.in
0065
0066 The wvalue.in macro allows a full control of the simulation.
0067
0068 ---->4. PHYSICS
0069
0070 You can select Geant4-DNA physics constructor in wvalue.in.
0071
0072 A tracking cut can be applied if requested.
0073
0074 ---->5. SIMULATION OUTPUT AND RESULT ANALYSIS
0075
0076 The output results consist in a text file (wvalue.txt), containing:
0077 - the energy of incident particles (in eV)
0078 - the mean number of ionisations
0079 - its rms
0080 - the w value (in eV)
0081 - its rms (in eV)
0082
0083 Note: rms values correspond to standard deviation.
0084
0085 In addition, another macro (histo.in) is also provided including
0086 a series of histograms:
0087 - histogram #1 : nb of ionisation interactions per event
0088 - histogram #2 : total energy deposited in absorber
0089 - histogram #3 : true track length of the primary particle
0090 - histogram #4 : true step size of the primary particle
0091 - histogram #5 : projected range of the primary particle
0092 - histogram #6 : true track length of charged secondaries
0093 - histogram #7 : true track length of charged secondaries