| 1 |
|
|---|
| 2 | =========================================================
|
|---|
| 3 | Geant4 - Brachytherapy example
|
|---|
| 4 | =========================================================
|
|---|
| 5 |
|
|---|
| 6 | README
|
|---|
| 7 | ---------------------
|
|---|
| 8 |
|
|---|
| 9 | ------------------------------------------------------------------------
|
|---|
| 10 | ----> Introduction.
|
|---|
| 11 |
|
|---|
| 12 | Brachytherapy example simulates energy deposit in a Phantom filled with
|
|---|
| 13 | soft tissue for:
|
|---|
| 14 | 1) Iridium source (endocavitary brachytherapy).
|
|---|
| 15 | 2) Iodium source (interstitial brachytherapy).
|
|---|
| 16 | 3) Leipzig Applicator (superficial brachytherapy).
|
|---|
| 17 | ------------------------------------------------------------------------
|
|---|
| 18 | ----> 1.Experimental set-up.
|
|---|
| 19 |
|
|---|
| 20 | The default source is an Ir-131 source put in the center of the Phantom.
|
|---|
| 21 | The Phantom is a box (dimension:30cm), it is gridded in
|
|---|
| 22 | voxels (1.mm dimension)
|
|---|
| 23 | -------------------------------------------------------------------------
|
|---|
| 24 | ----> 2.SET-UP
|
|---|
| 25 |
|
|---|
| 26 | -a standard Geant4 example GNUmakefile is provided
|
|---|
| 27 |
|
|---|
| 28 | setup with:
|
|---|
| 29 | G4SYSTEM = linux-g++
|
|---|
| 30 |
|
|---|
| 31 | The following environment variables need to be set:
|
|---|
| 32 |
|
|---|
| 33 | G4LEDATA: points to low energy database
|
|---|
| 34 |
|
|---|
| 35 | setup for analysis: AIDA 3.2.1, PI 1.3.3 (PI is Obsolete)
|
|---|
| 36 |
|
|---|
| 37 | Users can download the analysis tools from:
|
|---|
| 38 |
|
|---|
| 39 | http://aida.freehep.org/
|
|---|
| 40 | http://cern.ch/pfeiffer
|
|---|
| 41 | http://www.cern.ch/PI (OBSOLETE)
|
|---|
| 42 | ------------------------------------------------------------------------
|
|---|
| 43 | ----> 3.How to run the example.
|
|---|
| 44 |
|
|---|
| 45 | - batch mode:
|
|---|
| 46 | $G4WORKDIR/bin/Linux-g++/Brachy IridiumSourceMacro.mac
|
|---|
| 47 | $G4WORKDIR/bin/Linux-g++/Brachy IodiumSourceMacro.mac
|
|---|
| 48 | $G4WORKDIR/bin/Linux-g++/Brachy LeipzigSourceMacro.mac
|
|---|
| 49 |
|
|---|
| 50 | - Interative mode:
|
|---|
| 51 | 3) $G4WORKDIR/bin/Linux-g++/Brachy
|
|---|
| 52 | The VisualisationMacro.mac is loaded automatically
|
|---|
| 53 |
|
|---|
| 54 | -->possible different configurations for interactive mode:
|
|---|
| 55 |
|
|---|
| 56 | 1)Ir source:
|
|---|
| 57 | idle>/run/beamOn NumberOfEvents ...and then
|
|---|
| 58 | idle>exit
|
|---|
| 59 |
|
|---|
| 60 | 2)Leipzig Applicator:
|
|---|
| 61 | idle>/source/switch Leipzig
|
|---|
| 62 | idle>/run/beamOn NumberOfEvents ...and then
|
|---|
| 63 | idle> exit
|
|---|
| 64 |
|
|---|
| 65 | 3) Iodium source:
|
|---|
| 66 | idle>/source/switch Iodium
|
|---|
| 67 | idle>/primary/energy Iodium
|
|---|
| 68 | idle>/run/beamOn NumberOfEvents ...and then
|
|---|
| 69 | idle>exit
|
|---|
| 70 |
|
|---|
| 71 | *Before the run you can also change the absorber material of the
|
|---|
| 72 | Phantom:
|
|---|
| 73 | idle>/phantom/selectMaterial materialName
|
|---|
| 74 |
|
|---|
| 75 | - batch mode: executable Brachy macroFile.mac
|
|---|
| 76 | macros are provided as example: IodiumSourceMacro.mac,
|
|---|
| 77 | IridiumSourceMacro.mac, LeipzigSourceMacro.mac
|
|---|
| 78 | (ex. $G4WORKDIR/bin/Linux-g++/Brachy IodiumSourceMacro.mac)
|
|---|
| 79 | ------------------------------------------------------------------------
|
|---|
| 80 | ----> 4. Simulation output
|
|---|
| 81 |
|
|---|
| 82 | if G4ANALYSIS_USE = 1 in the set-up, the output is brachytherapy.hbk
|
|---|
| 83 |
|
|---|
| 84 | It contains:
|
|---|
| 85 | 1)1Dhistogram with the primary particle energy
|
|---|
| 86 | 2)2Dhistogram with the distribution of energy in the plane
|
|---|
| 87 | (x,z,energy) containing the source (YThickness = 1. mm)
|
|---|
| 88 | 3)1Dhistogram with the energy deposit along the X axis in the plane
|
|---|
| 89 | containing the source.
|
|---|
| 90 | 4)Ntuple with the 3D energy deposit in the Phantom
|
|---|
| 91 |
|
|---|
| 92 | Units: the energy deposit is in MeV;
|
|---|
| 93 | x, y, z in mm for histograms and ntuple
|
|---|
| 94 | ------------------------------------------------------------------------
|
|---|
| 95 | ----> 5.Visualisation
|
|---|
| 96 |
|
|---|
| 97 | a macro is provided ad example of visualisation: VisualisationMacro.mac
|
|---|
| 98 |
|
|---|
| 99 | ------------------------------------------------------------------------
|
|---|
| 100 |
|
|---|
| 101 | Further information at http://www.ge.infn.it/geant4/examples/index.html
|
|---|
| 102 | Contact: geant4-advanced-examples@cern.ch
|
|---|
| 103 |
|
|---|
| 104 |
|
|---|
