[[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" by typing
       {{{
       ssh-keygen -t dsa
       }}}
       This generates a dsa-keyfile called "id_dsa.pub" in the directory "~/.ssh". 
     * Now execute
       {{{
       cat ~/.ssh.id_dsa.pub >> .ssh/authorized_keys
       }}}
     * Open in your Windows "PuTTYgen"
     * Choose "conversions" and read in your freshly created private (not public!) dsa key, which is given by the file "~/.ssh/id_dsa". Save the key after conversion as a ".ppk"-file
     * Start putty's pageant (Start->Programme->Putty->Pageant)
     * Load the freshly created .ppk-file into pageant
        * 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 ==
=== Using Cygwin ===
 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. Now 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.

=== In a terminal ===
Download your code to a network share, which is also accessible by some linux client. Go via putty to your linux client and compile the code as explained in "Readme_Quickstart.txt".[[BR]]

'''Advantage:''' Much faster compilation and better performance than Cygwin.