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