Gabriele Cosmo
96 lines
4.0 KiB
Plaintext
96 lines
4.0 KiB
Plaintext
|
|
=========================================================
|
|
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
|