[[TOC(WikiStart,releaseNotes,windows,depth=2)]] 
= 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.
    *  Go via putty, e.g., to tp1 an run "ssh-keygen". Generate a dsa-keyfile called "dsa.pub". Then execute
       {{{
       cat dsa.pub >> .ssh/authorized_keys
       }}}
    * Open in your Windows "PuTTYgen"
    * Choose "conversions" and read in your freshly created private (not public!) dsa key. Save the key after conversion as a ".ppk"-file
    * Open putty's pageant
    * Load the freshly created .ppk-file
        * Hint: Add the command "pageant 'path to your ppk.file'" as a link to your Windows-Autostart, such that pageant is started at system start.
 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 bw FORT=gfortran-4
    }}}
 6. After make is done, you will find the executable "main.x" in the "testRun" directory, where you can run GiBUU with the command
    {{{
    ./main.x < jobCardName
    }}} 
    Sample jobcards are available in testRun/jobCards, cf.  also [wiki:FAQ our FAQ page] for more informations.