New default values for baselines (F.Prino)
[u/mrichter/AliRoot.git] / TFluka / documents / README
CommitLineData
14d3e5e0 1TFLUKA
2======
3
4TFluka is the FLUKA implementation of the Virtual MC. For the time
5being it uses the GEANT4 geometry through Flugg. The geometry itself
6is built to the GEANT4 geometry through geant4_vmc. Please be aware
7that this is still a development project and that many things might
8not work as expected. Fill free to fix them or suggest improvements.
9
10HOW TO BUILD TFLUKA
11===================
12
130) Download (if you read this you have probably already done that) and
14install the default AliRoot.
181017bb 15
441e15fe 161) External packages needed:
181017bb 17
14d3e5e0 18 * Download FLUKA from http://pcfluka.mi.infn.it/ and install it
181017bb 19
14d3e5e0 20 * Download geant4_vmc and install it (together with GEANT4, CLHEP, etc)
b48c05b1 21 See http://root.cern.ch/root/vmc/VirtualMC.html
441e15fe 22 NOTE: All the geant4_vmc headers are assumed to be in
b48c05b1 23 $ALICE/geant4_vmc/include. To put them there execute `gmake includes`
24 in the geant4_vmc/source directory
181017bb 25
14d3e5e0 262) Set your environment:
181017bb 27
14d3e5e0 28 * Set the path to FLUKA in the environment variable FLUPRO
181017bb 29
14d3e5e0 30 * Set your GEANT4 environment in the usual way.
181017bb 31
441e15fe 32 * Make sure that your LD_LIBRARY_PATH includes the path to CLHEP, GEANT4
33 and geant4_vmc libraries
181017bb 34
441e15fe 353) Compile TFluka and Flugg. In AliRoot do:
36
37 * gmake all-TFluka
38
39 * gmake all-Flugg
40
441e15fe 41
441e15fe 42
14d3e5e0 43HOW TO USE TFLUKA
44==================
45
46An small script ($ALICE_ROOT/TFluka/scripts/runalifluka.csh) is
47provided that handles the creation of temporary files that FLUKA
48expects as input. A ROOT macro loads all the needed libraries. Then,
49one should proceed as in any other implementation of the Virtual MC.
50So:
51
521) Execute the $ALICE_ROOT/TFluka/scripts/runalifluka.csh
53
542) [root] .x $ALICE_ROOT/TFluka/macro/loadlibs.C
55
563) [root] gAlice->RunMC();
57
441e15fe 58
14d3e5e0 59This will run 50 particles from TGenerator.
181017bb 60
14d3e5e0 61NOTE: FLUKA uses and external input file to define the materials and
62to assign them to a given region (volume). Whenever you run AliRoot
63with TFluka a temporary directory ('tmp') will be created with, among
64others, a file call flukaMat.inp. The contents of this file should be
65included into $ALICE_ROOT/TFluka/input/alice.inp just after the GEOEND
66card. Then rerun AliRoot with TFluka, since only now the results can
67be meaningful. Please be aware that NEON and SCANDIUM are not
68supported for low energy neutrons and therefore special tricks might be
69needed to run TFluka with them. Also PHOSPHOR should be renamed to
70PHOSPHO. For this last two cases contact A. Fasso on how to solve the
71problem.
181017bb 72
14d3e5e0 73LIST OF DEVELOPERS AND CONTRIBUTORS
74===================================
75F. Carminati
76A. Fasso
77E. Futto
78I. Gonzalez Caballero
79I. Hrivnacova
80A. Morsch