= Running GiBUU on a Windows System =

== Step 1: Downloading the code ==

=== For GiBUU developers ===
 1. Install [http://www.chiark.greenend.org.uk/~sgtatham/putty/ putty] on your system
       * At JLU Giessen you may also use the [http://www.uni-giessen.de/hrz/service/icd.html automatic network installation]: Choose "Weitere Software" and then "putty".
 2. Set up a ssh-key pair to be used with putty.
    *  cf. http://www.noah.org/wiki/Tortoise_SVN_with_PuTTY
 3. Install [http://tortoisesvn.tigris.org/ tortoise] on your system
 4. Make sure "Pageant" is running and your ssh-key is loaded.
 4. Download GiBUU to your windows hard drive.  Details:
    1. Right click on your Desktop: After installing [http://tortoisesvn.tigris.org/ tortoise] a menu item "SVN checkout" should be available. 
    2. Left click on "SVN checkout".
    3. Enter in the field "URL of repository" 
       {{{
       svn+ssh://yourName@tp11.physik.uni-giessen.de/home/svn/buu/GiBUU/   
       }}}
       to download the code. Replace "yourName" by your user name ;)
    4.  Choose checkout directory, e.g.
       {{{
       C:\GiBUU 
       }}}    
       * Please take care, that the full path where you store GiBUU does not include any blanks. 
       * Especially "C:\Dokumente und Einstellungen\..." is no good, but "C:\GiBUU" is fine!
    5. Click on "ok", and then "yes" to create the checkout directory.
      

=== For normal users ===
 1. [wiki:GiBUUDownload#Gettingfullaccess  Get your  login account] or just [http://gibuu.physik.uni-giessen.de/GiBUU/login login].
 2. Download the [http://gibuu.physik.uni-giessen.de/GiBUU/browser/releases/ tar-ball] to your system. 
     * Please take care, that the path where you store the tar-ball does not include blanks. 
     * Especially "C:\Dokumente und Einstellungen\..." is no good, but "C:\work\" is fine!

== Step 2: Compiling & Running GiBUU ==
 1. Download [http://www.cygwin.com/ cygwin] 
 2. Setup cygwin. In the package selection choose additionally:
    * devel/gcc4-fortran
    * devel/make
    * utils/which
    * utils/bzip2
 3. After the installation finished, start cygwin.
 4. Go to the GiBUU directory
    * If you downloaded the tar ball, change to the download directory (e.g. 
      {{{
       cd /cygdrive/c/work 
      }}}
      Now unpack the tar-ball
      {{{  
      tar xzf tarballName.tgz
      }}}
    * If you used svn to get the code, then simply "cd" to the code directory,             e.g. 
       {{{ 
       cd /cygdrive/c/GiBUU
       }}}
 5.  Go to workingCode and type
     {{{
     make renew
     }}}
     and thereafter
     {{{
     make
     }}}
 6.  After make is done, you will find the executable "main.x" in the "testRun" directory. Sample jobcards are available in testRun/jobCards, cf.  also [wiki:FAQ our FAQ page] for more informations.