=========================================================
Geant4 - ExDiane example
=========================================================
README
---------------------
------------------------------------------------------------------------
----> Introduction
This example shows how to run a Geant4 application in a parallel mode
using DIANE (DIstributed ANalysis Environment).
With DIANE the simulation may be run in sequential or parallel mode
without changing the code of the Geant4 application. Using a dedicated
cluster or geographically distributed resources (e.g. GRID) is
completely transparent for the user.
For more details about DIANE, have a look at http://cern.ch/diane
The ExDiane example derives from the Geant4 advanced example
brachytherapy. The original application code is the same. An
interface class (BrachySimulation) has been added to replace the
main() function.
Please look at the documentation of the brachytherapy advanced example
to know details about the functionality of the application:
- geant4/examples/advanced/brachytherapy
- http://www.ge.infn.it/geant4/examples/index.html
-------------------------------------------------------------------------
----> 2.SET-UP
- example enviroment with the compiler 3.2.3
compiler = gcc-3.2.3
G4SYSTEM = linux-g++
- other environment variables which need to be set:
G4LEDATA: points to low energy data base - G4EMLOW3.0
- download DIANE
You need to have python 2.2 or greater.
* AUTOMATIC INSTALLATION OF DIANE
Execute this command:
> python2 diane.installation.manager --packages=brachy DIANE-1.0.0 download
Get the diane.installation.manager script from
http://cern.ch/diane/download.html
* MANUAL INSTALLATION OF DIANE
Make sure that you have AIDA 3.2.1, PI 1.3.3. Download them from
http://aida.freehep.org/
http://www.cern.ch/PI
Download DIANE from www.cern.ch/diane
Documentation about how to "dianize" a Geant4 application can be found
at www.cern.ch/diane
------------------------------------------------------------------------
----> 3.How to compile the example.
setenv G4ANALYSIS_USE 1 -> to activate the analysis
setenv G4DIANE_USE 1 -> to activate the use of DIANE
> gmake
------------------------------------------------------------------------
----> 4.How to run the example.
Two macros are provided as example: iridium.job and iodium.job
They correspond to the Geant4 macros: IridiumSourceMacro.mac and
IodiumSourceMacro.mac
- batch mode running through DIANE:
diane.startjob --job=iodium.job -w 3@localhost --wms=xterm ^ ^
input macro number of workers
------------------------------------------------------------------------
----> 4. Simulation output
if ANALYSIS_USE = 1 in the set-up, the output is brachytherapy.xml
It contains:
1)1Dhistogram with the primary particle energy
2)2Dhistogram with the distribution of energy in the plane
(x,z,energy) containing the source
3)1Dhistogram with the energy deposit along the X axis in the plane
containing the source.
Units: the energy deposit is in MeV;
x, y, z in mm for histograms
-------------------------------------------------------------------------
Authors: Susanna Guatelli, Kuba Moscicki
for comments, advices, doubts and questions:
guatelli@ge.infn.it, Jakub.Moscicki@cern.ch
- last modified: Susanna Guatelli and Kuba Moscicki 29/11/2005
Gabriele Cosmo