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