= Installation instructions for the impatients =

If you do not bother about the details, maybe the following instructions are enough for you to get GiBUU running. In any case of troubles, please read the full story,

[[TOC(depth=2)]]

     0. [wiki:tools Prerequisites] -- Used software and tools
     1. [wiki:download Download] -- Get the GiBUU source code
     2. [wiki:compiling Compiling GiBUU]

In the case you face problems with `libRootTuple`, follow this direct [wiki:libRootTuple link].

At the moment, only downloading of tar-balls is possible.


== Default Installation ==

 1. generate base directory:
{{{
mkdir GiBUU; cd GiBUU
}}}

 2. download and unpacking:
{{{
wget --content-disposition https://gibuu.hepforge.org/downloads?f=release2023.tar.gz
wget --content-disposition https://gibuu.hepforge.org/downloads?f=buuinput2023.tar.gz

tar -xzvf buuinput2023.tar.gz
tar -xzvf release2023.tar.gz
}}}

 3. change into release directory:
{{{
cd release
}}}

 4. compile GiBUU:
{{{
make
}}}

 5. run GiBUU:
{{{
./testRun/GiBUU.x < your_Jobcard
}}}

== Installation with ROOT output ==

If you want to use the possibility to get event output in ROOT format, the installation has to be slightly modified:

 1. generate base directory:
{{{
mkdir GiBUU; cd GiBUU
}}}

 2. download and unpacking:
{{{
wget --content-disposition https://gibuu.hepforge.org/downloads?f=release2023.tar.gz
wget --content-disposition https://gibuu.hepforge.org/downloads?f=buuinput2023.tar.gz
wget --content-disposition https://gibuu.hepforge.org/downloads?f=libraries2023_RootTuple.tar.gz

tar -xzvf buuinput2023.tar.gz
tar -xzvf release2023.tar.gz
tar -xzvf libraries2023_RootTuple.tar.gz 
}}}

 3. change into release directory:
{{{
cd release
}}}

 4. a)  compile !RootTuple library:
{{{
make buildRootTuple
}}}

 4. b) compile GiBUU:
{{{
make withROOT=1
}}}

 5. run GiBUU:
{{{
./testRun/GiBUU.x < your_Jobcard
}}}

 ensure to have something like the following in 'your_Jobcard':
{{{
! file: ./analysis/EventOutputAnalysis.f90
&EventOutput
      WritePerturbativeParticles = T
      EventFormat = 4 ! 1=LesHouches, 4=ROOT
/
}}}

== Installation with HepMC3 output (future v2024) ==

If you want to use the possibility to get event output in HepMC3 format via the HepMC3 C++ library, the installation has to be slightly modified:

 1. generate base directory:
{{{
mkdir GiBUU; cd GiBUU
}}}

 2. download and unpacking:
{{{
wget --content-disposition https://gibuu.hepforge.org/downloads?f=release2024.tar.gz
wget --content-disposition https://gibuu.hepforge.org/downloads?f=buuinput2024.tar.gz
wget --content-disposition https://gibuu.hepforge.org/downloads?f=libraries2024_HEPMC3.tar.gz

tar -xzvf buuinput2024.tar.gz
tar -xzvf release2024.tar.gz
tar -xzvf libraries2024_HEPMC3.tar.gz 
}}}

 3. change into release directory:
{{{
cd release
}}}

 4. a)  compile !HEPMC3event library:
{{{
make buildHEPMC3event
}}}

 4. b) compile GiBUU:
{{{
make withHEPMC3=1
}}}

 5. run GiBUU:
{{{
./testRun/GiBUU.x < your_Jobcard
}}}

 ensure to have something like the following in 'your_Jobcard':
{{{
! file: ./analysis/EventOutputAnalysis.f90
&EventOutput
      WritePerturbativeParticles = T
      EventFormat = 6 ! 1=LesHouches, 6=HepMC3
/
}}}