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

= Frequently asked questions =

== Access ==

=== 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.


----

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

You find informations  [wiki:releaseNotes here]. Additionally there is a source code documentation [http://theorie.physik.uni-giessen.de/~gibuu/Documentation/code/robo_sourcefiles.html#top here].

To compile the code you must have some recent fortran compiler installed (cf. "Requirements" in [wiki:releaseNotes the release notes]). Simply go to the base directory and follow the guide given in the file README_Quickstart.txt to compile the source code. After successful compilation, the binary can be found in the "testRun" directory.[[BR]]

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. 

We propose you try compiling the code and running it using a sample job card first. We are on the way to 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].


----


== Operating Systems ==

== Which Operating Systems does GiBUU support? ==

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

 * a modern [wiki:tools Fortran compiler]
 * [http://www.gnu.org/software/make/ make] (steers the build process)
 * [wiki:tools robodoc] is needed to generate the documentation (optional)

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]