1 | |
---|
2 | ========================================================= |
---|
3 | Geant4 - ExDiane example |
---|
4 | ========================================================= |
---|
5 | |
---|
6 | README |
---|
7 | --------------------- |
---|
8 | |
---|
9 | ------------------------------------------------------------------------ |
---|
10 | ----> Introduction |
---|
11 | |
---|
12 | This example shows how to run a Geant4 application in a parallel mode |
---|
13 | using DIANE (DIstributed ANalysis Environment). |
---|
14 | |
---|
15 | With DIANE the simulation may be run in sequential or parallel mode |
---|
16 | without changing the code of the Geant4 application. Using a dedicated |
---|
17 | cluster or geographically distributed resources (e.g. GRID) is |
---|
18 | completely transparent for the user. |
---|
19 | |
---|
20 | For more details about DIANE, have a look at http://cern.ch/diane |
---|
21 | |
---|
22 | The ExDiane example derives from the Geant4 advanced example |
---|
23 | brachytherapy. The original application code is the same. An |
---|
24 | interface class (BrachySimulation) has been added to replace the |
---|
25 | main() function. |
---|
26 | |
---|
27 | Please look at the documentation of the brachytherapy advanced example |
---|
28 | to know details about the functionality of the application: |
---|
29 | - geant4/examples/advanced/brachytherapy |
---|
30 | - http://www.ge.infn.it/geant4/examples/index.html |
---|
31 | |
---|
32 | ------------------------------------------------------------------------- |
---|
33 | ----> 2.SET-UP |
---|
34 | |
---|
35 | - example enviroment with the compiler 3.2.3 |
---|
36 | compiler = gcc-3.2.3 |
---|
37 | G4SYSTEM = linux-g++ |
---|
38 | |
---|
39 | - other environment variables which need to be set: |
---|
40 | G4LEDATA: points to low energy data base - G4EMLOW3.0 |
---|
41 | |
---|
42 | - download DIANE |
---|
43 | You need to have python 2.2 or greater. |
---|
44 | |
---|
45 | * AUTOMATIC INSTALLATION OF DIANE |
---|
46 | Execute this command: |
---|
47 | > python2 diane.installation.manager --packages=brachy DIANE-1.0.0 download |
---|
48 | Get the diane.installation.manager script from |
---|
49 | http://cern.ch/diane/download.html |
---|
50 | |
---|
51 | * MANUAL INSTALLATION OF DIANE |
---|
52 | Make sure that you have AIDA 3.2.1, PI 1.3.3. Download them from |
---|
53 | http://aida.freehep.org/ |
---|
54 | http://www.cern.ch/PI |
---|
55 | |
---|
56 | Download DIANE from www.cern.ch/diane |
---|
57 | Documentation about how to "dianize" a Geant4 application can be found |
---|
58 | at www.cern.ch/diane |
---|
59 | ------------------------------------------------------------------------ |
---|
60 | ----> 3.How to compile the example. |
---|
61 | |
---|
62 | setenv G4ANALYSIS_USE 1 -> to activate the analysis |
---|
63 | setenv G4DIANE_USE 1 -> to activate the use of DIANE |
---|
64 | > gmake |
---|
65 | ------------------------------------------------------------------------ |
---|
66 | ----> 4.How to run the example. |
---|
67 | |
---|
68 | Two macros are provided as example: iridium.job and iodium.job |
---|
69 | They correspond to the Geant4 macros: IridiumSourceMacro.mac and |
---|
70 | IodiumSourceMacro.mac |
---|
71 | |
---|
72 | - batch mode running through DIANE: |
---|
73 | diane.startjob --job=iodium.job -w 3@localhost --wms=xterm ^ ^ |
---|
74 | input macro number of workers |
---|
75 | ------------------------------------------------------------------------ |
---|
76 | ----> 4. Simulation output |
---|
77 | |
---|
78 | if ANALYSIS_USE = 1 in the set-up, the output is brachytherapy.xml |
---|
79 | |
---|
80 | It contains: |
---|
81 | 1)1Dhistogram with the primary particle energy |
---|
82 | 2)2Dhistogram with the distribution of energy in the plane |
---|
83 | (x,z,energy) containing the source |
---|
84 | 3)1Dhistogram with the energy deposit along the X axis in the plane |
---|
85 | containing the source. |
---|
86 | |
---|
87 | Units: the energy deposit is in MeV; |
---|
88 | x, y, z in mm for histograms |
---|
89 | ------------------------------------------------------------------------- |
---|
90 | Authors: Susanna Guatelli, Kuba Moscicki |
---|
91 | |
---|
92 | for comments, advices, doubts and questions: |
---|
93 | guatelli@ge.infn.it, Jakub.Moscicki@cern.ch |
---|
94 | |
---|
95 | - last modified: Susanna Guatelli and Kuba Moscicki 29/11/2005 |
---|