[[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 ==
=== Can I run GiBUU on a ''Linux'' system ?? ===
YES, of course! Our requirements are only:
 * a modern [wiki:tools fortran compiler] 
 * [http://www.gnu.org/software/make/ make] (steers the compiling process)
 * To generate the documentation one needs: [wiki:tools robodoc]   

=== Can I run GiBUU on a ''Windows XP'' system ?? ===
YES! See [wiki:windows here for a manual].

=== Can I run GiBUU on a ''Mac OS X'' system ?? ===
Yes. For instructions see [wiki:mac here].