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 | |
---|