Import Geant4 10.5.0 source tree

This commit is contained in:
Gabriele Cosmo
2018-12-07 15:15:39 +01:00
parent 6aa23be517
commit db49709b53
11370 changed files with 187480 additions and 160142 deletions
+27 -17
View File
@@ -7,7 +7,7 @@
---------------------
The brachytherapy example is currently maintained and upgraded by Susanna Guatelli (1) and Dean Cutajar (1), with the support of
The brachytherapy example is currently maintained and upgraded by Susanna Guatelli (1), Albert Le (1) and Dean Cutajar (1), with the support of
Luciano Pandola (2)
1. Centre For Medical Radiation Physics (CMRP), University of Wollongong, NSW, Australia.
@@ -29,7 +29,7 @@ S. George, S. Agostinelli, F. Foppiano, S. Garelli, M. G. Pia, M. Tropeano
Brachytherapy example simulates the energy deposit in a water phantom, produced by:
1) Iridium sources (Flexisource and TG186).
2) Iodine source (Bebig Isoseed I-125).
2) Iodine sources (Bebig Isoseed and Oncura 6711 I-125).
3) Leipzig Applicator with an iridium source (model from the Istituto Tumori, Genova, Italy).
The Flexisource, an Ir-192 source manufactured by Nucletron, an Elekta company, is a source commonly used for high dose rate brachytherapy treatments.
@@ -49,16 +49,19 @@ In particular in this example it is shown how to:
- define the physics by means of a Geant4 Modular Physics List
- save results in an analysis ROOT file
- calculate the dose rate distribution along the main axis of the source
- compare the calculated dose rate distribution to reference data. In the case of the example, the dose rate
distribution of a Flexisource is compared to D. Granero, J. Pérez-Calatayud, E. Casal, et al,
"A dosimetric study on the Ir-192 high dose rate Flexisource", Med. Phys. 33 (12), 2006, 4578-82.
- compare the calculated dose rate distribution to reference data.
In the case of the example, the dose rate distribution of a Flexisource is compared to D. Granero,
J. Pérez-Calatayud, E. Casal, et al,"A dosimetric study on the Ir-192 high dose rate Flexisource", Med. Phys. 33 (12), 2006, 4578-82.
The dose rate distribution of the Oncura 6711 I-125 source is compared to J. Dolan, Z. Lia, J. F. Williamson, "Monte Carlo and experimental
dosimetry of an I-125 brachytherapy seed", Med. Phys. 33(12), 2006.
The example can be executed in multithreading mode.
------------------------------------------------------------------------
----> 1.Experimental set-up.
The default source is a Ir-192 Flexisource set in the center of a water phantom with size 30 cm.
The default source is a Ir-192 Flexisource set in the center of a water phantom with size 30 cm.
The phantom is set in the World volume filled with air.
The primary radiation field is defined by means of the GeneralParticleSource
@@ -79,10 +82,12 @@ The installation of ROOT is required (http://root.cern.ch/drupal/).
----> 3.How to run the example.
- Batch mode:
$G4WORKDIR/bin/Linux-g++/Brachy FlexiSourceMacro.mac
$G4WORKDIR/bin/Linux-g++/Brachy FlexiSourceMacro.mac
$G4WORKDIR/bin/Linux-g++/Brachy LeipzigSourceMacro.mac
$G4WORKDIR/bin/Linux-g++/Brachy IridiumSourceMacro.mac
$G4WORKDIR/bin/Linux-g++/Brachy IodiumSourceMacro.mac
$G4WORKDIR/bin/Linux-g++/Brachy LeipzigSourceMacro.mac
$G4WORKDIR/bin/Linux-g++/Brachy IodiumSourceMacro.mac (model of the Bebig Isoseed I-125)
$G4WORKDIR/bin/Linux-g++/Brachy OncuraIodineSourceMacro.mac (model of the Oncura 6711 I-125)
$G4WORKDIR/bin/Linux-g++/Brachy LeipzigSourceMacro.mac
- Interative mode:
3) $G4WORKDIR/bin/Linux-g++/Brachy
@@ -104,16 +109,16 @@ iodine_source_primary.mac and iridium_source_primary.mac
2) Model the radioactive Decay. The primary particle is the radionuclide.
This option is modelled in iodine_decay.mac and TG186_iridium_decay.mac
The GPS macros are executed in VisualisationMacro.mac 9default, FlexiSourceMacro.mac, IodineSourceMacro.mac, LeipzigSourceMacro.mac
The GPS macros are executed in VisualisationMacro.mac by default, FlexiSourceMacro.mac, IodineSourceMacro.mac, LeipzigSourceMacro.mac
- The Flexisource is the default source of the example.
- In VisualisationMacro.mac the source is the default one. iridium_source_primary.mac is executed to define the radiation field emerging from the iridium core.
- In FlexiSourceMacro.mac the Flexi ir source geometry is selected via interactive command. The radiation field is defined in the iridium_source_primary.mac.
- In FlexiSourceMacro.mac the Flexi Ir source geometry is selected via interactive command. The radiation field is defined in the iridium_source_primary.mac.
- In IodineSourceMacro.mac, the Bebig Isoseed I-125 brachytherapy source is modelled. The radiation field is modelled in terms of emitted photons in iodine_source_primary.mac.
Alternatively the radioactive decay of I can be modelled using teh macro iodine_decay.mac.
- In LeipzigSourceMacro.mac, A Leipzig applicator (design provided by Istituto Tumori, Genova) is modelled. The iridium_source_leipzig_primary.mac defines the radiation field of the Ir core.
- The TG186SourceMacro.mac models the reference bIr brachytherapy source. The radiation field can be either defined with the iridium_source_primary.mac (spectrum of the emitted photons) or with TG186_iridium_decay.mac (model of the Ir decay).
- OncuraIodineSourceMacro.mac models both the geometry and the radioactive decay of the Oncura 6711 I-125 source.
--------------------------------------------------------------------------------
----> 5. Physics List
@@ -141,9 +146,10 @@ The output is:
By default:
EnergyDeposition_Flexi.out contains the Edep when the Flexi source is selected.
EnergyDeposition_iodine.out contains the Edep when Iodine source is selected.
EnergyDeposition_iodine.out contains the Edep when Iodine Bebig Isoseed source is selected.
EnergyDeposition_TG186.out contains the Edep when the TG186 source is selected.
EnergyDeposition_Leipzig.out contains the Edep when the Iridium source with Leipzig applicator is selected.
EnergyDeposition_Oncura.out contains the Edep when the Iodine Oncura 6711 source is selected.
- brachytherapy.root, containing
- a 2D histogram with the energy deposition in the phantom. The macro macro.C is provided as example
@@ -151,7 +157,7 @@ The output is:
The ROOT file will be created if the example is built with the WITH_ANALYSIS_USE=ON option (see section 2).
- 1D histogram withe the plot of energy spectrum of gamma emitted by the radioactive decay when gamma are generated directly as
primary particles or whenthey derive from Radioactive Decay(see section 4).
plot_primary.C is provided as example to open brachytherapy.root and to plot the energy spectra
plot_primary.C is provided as example to open brachytherapy.root and to plot the energy spectra
-------------------------------------------------------------------------------
----> 8.Visualisation
@@ -167,13 +173,12 @@ in the brachytherapy.root file.
The ROOT macro TG43_relative_dose.C has brachytherapy.root as input file. It calculates the dose rate distribution along the main axis of
the brachytherapy source. The dose rate is normalised to 1 at 1 cm distance from the centre.
The output file is geant4_dose.txt with two columns:
distance from the centre (cm) dose rate distribution
distance from the centre (cm) dose rate distribution
The user can then compare the dose rate distribution calculated with the example to reference data.
Directory "comparison":
As an example, the dose rate distribution calculated with the Flexisource is compared to reference data from D. Granero, J. Pérez-Calatayud, E. Casal, et al,
"A dosimetric study on the Ir-192 high dose rate Flexisource", Med. Phys. 33 (12), 2006, 4578-82.
As an example, the dose rate distribution calculated with the Flexisource is compared to reference data from D. Granero, J. Pérez-Calatayud, E. Casal, et al, "A dosimetric study on the Ir-192 high dose rate Flexisource", Med. Phys. 33 (12), 2006, 4578-82.
The compare.C is a ROOT macro which reads the dose rate distribution calculated with the Flexisource (geant4.txt generated with the advanced example and 280 M histories ) against the reference.
@@ -182,3 +187,8 @@ The directory "comparison" contains:
- the data obtained in Geant4.10.3: geant4.txt, 280 M events. geant4.txt is obtained when executing the macro TG43_relative_dose.C
- comparison.C - macro to read geant4.txt and granero.txt and compare them in the same plot
-----> 10. Regression testing of Geant4
- the macros to run are in test_macro
- the results should be processed with analysis.C