Warning, /geant4/examples/extended/medical/dna/mfp/README.md is written in an unsupported language. File is not indexed.
0001 \page Examplemfp Example mfp
0002
0003 \author S. Incerti et al. (a, *) \n
0004 a. LP2i, IN2P3 / CNRS / Bordeaux University, 33175 Gradignan, France \n
0005 * e-mail:incerti@lp2ib.in2p3.fr
0006
0007 ## INTRODUCTION.
0008
0009 The mfp example shows how to calculate mean free path of particles
0010 in liquid water using the Geant4-DNA physics processes and models.
0011
0012 It has been adapted from the spower and TestEm14 examples.
0013
0014 This example is provided by the Geant4-DNA collaboration.
0015
0016 The Geant4-DNA processes and models are further described at:
0017 http://geant4-dna.org
0018
0019 Any report or published results obtained using the Geant4-DNA software shall
0020 cite the following Geant4-DNA collaboration publications: \n
0021 Med. Phys. 51 (2024) 5873–5889 \n
0022 Med. Phys. 45 (2018) e722-e739 \n
0023 Phys. Med. 31 (2015) 861-874 \n
0024 Med. Phys. 37 (2010) 4692-4708 \n
0025 Int. J. Model. Simul. Sci. Comput. 1 (2010) 157–178
0026
0027 ## GEOMETRY SET-UP
0028
0029 The geometry is a 1 m radius sphere of liquid water (G4_WATER
0030 material). Particles are shot along x from the sphere centre.
0031
0032 Radius of the sphere, physics constructor, primary particle type and
0033 energy can be controlled by the mfp.in macro file.
0034
0035 ## SET-UP
0036
0037 Make sure G4LEDATA points to the low energy electromagnetic data files.
0038
0039 The code can be compiled with cmake.
0040
0041 It works in MT mode.
0042
0043 ## HOW TO RUN THE EXAMPLE
0044
0045 Use:
0046
0047 ```
0048 ./mfp mfp.in
0049 ```
0050
0051 The mfp.in macro allows a full control of the simulation.
0052
0053 The computation of MFP and other quantities is performed in the
0054 SteppingAction::UserSteppingAction method.
0055
0056 The histo.in macro shows how to display several quantities
0057 (energy spectrum, scattering angle along x) of primary and secondaries.
0058
0059 ## PHYSICS
0060
0061 G4EmDNAPhysics* constructors are used.
0062
0063 ## SIMULATION OUTPUT AND RESULT ANALYSIS
0064
0065 The accuracy of results may depend on incident statistics as well as
0066 on number of steps specified in the SteppingAction::UserSteppingAction
0067 method.
0068
0069 The output results consist in a text file (mfp.txt), containing:
0070 - energy of incident particles (in eV)
0071 - mfp (in nm)
0072 - rms (i.e. standard deviation) on mfp (in nm)
0073
0074 Otherwise you may use histo.in to generate ROOT histograms of the
0075 other quantities.
