gibuu is hosted by Hepforge, IPPP Durham
GiBUU

Changes between Initial Version and Version 1 of running


Ignore:
Timestamp:
Apr 4, 2016, 1:26:29 PM (9 years ago)
Author:
jweil
Comment:

start a wiki page that explains the basics of how to run a GiBUU simulation

Legend:

Unmodified
Added
Removed
Modified
  • running

    v1 v1  
     1= Running a GiBUU simulation =
     2
     3After the GiBUU code has been [wiki:compiling compiled] successfully, the executable "GiBUU.x" can be found in the subdirectory "objects/", and a symbolic link to it is placed in the "testRun/" directory. The executable can either be run directly from one of these places, or it can be put into a separate directory of your choice together with a suitable [wiki:jobCards jobcard] (which we recommend for the sake of a cleaner environment).
     4
     5In principle the executable can also be transferred to a different machine, but it may not necessarily run there (depending on CPU architecture and available libraries). In such a case it can be useful to link the executable statically, as described [wiki:compiling#Staticvs.DynamicLinking here].
     6
     7
     8== Program invocation ==
     9
     10To run GiBUU, just go to the directory where the executable is located and type
     11
     12{{{
     13./GiBUU.x < my_setup.job
     14}}}
     15
     16The file "my_setup.job" should be a valid GiBUU [wiki:jobCards jobcard], containing all the options and parameters for the desired simulation. Several example jobcards are provided in the directory "testRun/jobCards/" and on this [wiki:jobCards wiki page]. If the executable is invoked without specifying a jobcard, i.e. like this
     17
     18{{{
     19./GiBUU.x
     20}}}
     21
     22then it will just print some version information and exit. When reporting any problems with GiBUU, please provide the information given in this header (which will help us to reproduce the problem).
     23
     24After starting a simulation with a proper jobcard, it will print a lot of information to the screen and produce several output files. It can be useful to print the output to a log file (for later reference and inspection), which is achieved via
     25
     26{{{
     27./GiBUU.x < my_setup.job > log.txt
     28}}}
     29
     30This will produce a file "log.txt", which contains all the screen output from GiBUU after the simulation is finished (and be be inspected already while the simulation is running).
     31
     32
     33== Input files ==
     34
     35
     36== Output files ==
     37