[[TOC(FAQ,depth=3)]] 

= Frequently asked questions =


----

=== How do I get the code? ===
[wiki:GiBUUDownload#Gettingfullaccess Please create your account first ] with which you can then download the source. Thereafter, the source code is available both as a [http://gibuu.physik.uni-giessen.de/GiBUU/downloads tar-ball] (~200 MB) or you can simply [source:releases browse it online]. See the  [wiki:releaseNotes release notes] for details on the source code structure and how to compile the code.

----

=== Is there any kind of documentation? How do I start? ===

You can have a look at our [wiki:releaseNotes release notes] or [http://gibuu.physik.uni-giessen.de/GiBUU/browser/releases/release1.2/README.Quickstart.txt README_Quickstart.txt]. Additional source code documentation can be found [http://gibuu.physik.uni-giessen.de/Documentation/code/robo_sourcefiles.html#top here].

To compile the code you must have some recent fortran compiler installed (cf. [wiki:tools this page]). Simply go to the base directory and type

{{{
make
}}}

More details on the compilation process are given [wiki:compiling here].
After successful compilation, the binary can be found in the '''testRun''' directory. To run the code, you need to prepare a job card defining necessary inputs. This job card is then used in the following way:

{{{
./main.x < jobCard
}}}
Sample job cards are given in the directory ''testRun/jobcards'' and some documentation is given [wiki:jobCards here]. 

We propose you try compiling the code and running it using a sample job card first. We are on the way to [wiki:jobCards document the job cards more properly]. If you need assistance to write your own, please [mailto:GiBUU@theo.physik.uni-giessen.de let us now].

----

=== Which Operating Systems does GiBUU support? ===

GiBUU can be compiled and run on '''Linux''', '''Windows''' or '''Mac OS X'''. The basic [wiki:tools requirements] are:

 * a modern Fortran compiler
 * make
 * perl or makedepf90
 * libbzip2

Other systems (like Solaris, BSD, etc) which fulfill these requirements may also work, but have not been tested.

While GiBUU is primarily targeted at '''Linux''', it can also be run on '''Windows''' (via Cygwin) or '''Mac OS X''' with little additional effort. For details see:

 * [wiki:windows GiBUU on Windows]
 * [wiki:mac GiBUU on Mac]

----

=== Why do I get the error message "cannot find -lbz2" when compiling GiBUU ? ===

The bzip2 library is required for compiling GiBUU since release 1.3. In particular the static version of this library is needed (libbz2.a). More details can be found [wiki:bzip2 here].

----

=== My GiBUU simulation stops with some error message. What should I do? ===

Please report it to the [mailto:GiBUU@theo.physik.uni-giessen.de GiBUU mailing list]. Your report should include at least the following information:

 1. the jobcard which exhibits the error
 2. a log file containing the complete GiBUU output

If you can not provide a full log file, please tell us at least

 * your operating system, compiler and GiBUU version (i.e. the first lines of output of ./GiBUU.x)
 * the final error message (i.e. the last few lines of output)

----