[[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 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 renew
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].


----


== Operating Systems ==

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