• Dockers scripts here>
  

The Linux x86 version must be compiled at 32 bits with g77 but can run on both 32 and 64 bit machines while the Linux x86_64 version must be compiled with gfortran and works only on 64 bits machine. The latter is still tentative, we cannot exclude some issues with that version. The code has been checked and validated for these platforms/compilers only for the time being.

1. The user must defines few environmental variables:
   • FLUPRO: pointing to the directory where the distribution tar file will be decompressed. If you work on bash do:
     

      > export FLUPRO=/pathto/fluka 

     or if you work on csh or tcsh do:
     

      > setenv FLUPRO /pathto/fluka 

     
     If the directory does not exist you should first create it by:
     

     > mkdir /pathto/fluka

     
     
   • FLUFOR (optional): containing the compiler type (gfortran or g77) which must be coherent with the architecture of the package you downloaded.
     If you work on bash do:

     > export FLUFOR=g77 

     or

     > export FLUFOR=gfortran

     
     while if you work on csh or tcsh do:

     > setenv FLUFOR g77

     or

     > setenv FLUFOR gfortran

     In case FLUFOR is not set the script does an attempt of checking if the name of the $FLUPRO directory contains the gfor string. In this case gfortran is selected. If the FLUFOR variable is not set and the compiler platform name is not coded in the directory name g77 is selected.
     
     
   • GFORFLU (optional): set to specify the specific version of gfortran to be used if more than one is available (i.e. if on your machine gfortran points to a version < 4.6, and gfortran46 points to version 4.6, you can set GFORFLU to gfortran46 and happily use the FLUKA gfortran 64 bits version).
   
   Note: Such definition of the environment variables are lost when you log out. In order to make it permanently available you should add the export/setenv command to your shell configuration file:
   • If you work on bash add them to your .bashrc file;
   • If you work on csh (or tcsh) add them to your .cshrc (or .tcshrc) fill
   
   
2. Go to the FLUPRO directory and move there the selected FLUKA package

    > cd $FLUPRO

   then
   

    > cp /path/fluka2021.2.1-linuxAA.tar.gz ./

   or
   

    > cp /path/fluka2021.2.1-linux-gfor64bitAA.tar.gz ./

3. Uncompress the tar.gz the package

    > tar -zxvf fluka2021.2.1-linuxAA.tar.gz

   or

    > tar -zxvf fluka2021.2.1-linux-gfor64bitAA.tar.gz

4. Compile the flutils, link and install FLUKA by typing:

    > make

   this creates the default executable flukahp and compiles auxiliary programs in the directory flutil.

In order to be able to perform nucleus-nucleus interactions, a special executable linking the event generator libraries already included in the distributed package, is needed. To create it, the script ldpmqmd in $FLUPRO/flutil has to be launched:

		$FLUPRO/flutil/ldpmqmd
	

The default name of the executable coming out is flukadpm3. You can set a different name through the option - o. This is useful when linking in addition one's own user routines. A list of options supported by the script lfluka (internally used by ldpmqmd) is shown issuing the command

		$FLUPRO/flutil/lfluka -h
	

Note that the twin script ldpm2qmd allows to link a previous version of the DPMJET event generator (DPMJET-2.53 instead of DPMJET-3).

In order to run FLUKA, one has to prepare an input file (e.g. myproblem.inp) looking like the examples available in the $FLUPRO directory. It is recommended to work/run in a directory different from the installation one, i.e. outside $FLUPRO. Detailed instructions for building a FLUKA input can be found in the Beginner guide of the Manual. The run is started launching the script rfluka

		$FLUPRO/flutil/rfluka myproblem [without ".inp"]
	

The standard executable $FLUPRO/flukahp will be used. A different executable to be used can be specified through the option - e. A list of options supported by the script rfluka is shown issuing the command

		$FLUPRO/flutil/rfluka -h
	

A lecture focused on installing and running FLUKA is provided as a part of the user course material (Installation, Release Notes).

With the FLUKA package, you received a current version of the FLUKA manual. The manual is the major source of information/help for preparing and running FLUKA. It is available also online.

Take a look also at the RELEASE-NOTES.

Always a good way to get started with a new software tool is to study well documented examples. We are trying to provide a series of such examples for various physics conditions.

Last updated: 23rd of September, 2021