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,
- Prerequisites -- Used software and tools
- Download -- Get the GiBUU source code
- Compiling GiBUU
In the case you face problems with libRootTuple
, follow this direct link.
At the moment, only downloading of tar-balls is possible.
Default Installation
- generate base directory:
mkdir GiBUU; cd GiBUU
- download and unpacking:
wget --content-disposition https://gibuu.hepforge.org/downloads?f=release2025.tar.gz wget --content-disposition https://gibuu.hepforge.org/downloads?f=buuinput2025.tar.gz tar -xzvf buuinput2025.tar.gz tar -xzvf release2025.tar.gz
For some setups, you may need additional in medium input files:
wget --content-disposition https://gibuu.hepforge.org/downloads?f=buuinput2025_inMed.tar.gz tar -xzvf buuinput2025_inMed.tar.gz
- change into release directory:
cd release
- compile GiBUU:
make
- 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:
- generate base directory:
mkdir GiBUU; cd GiBUU
- download and unpacking:
wget --content-disposition https://gibuu.hepforge.org/downloads?f=release2025.tar.gz wget --content-disposition https://gibuu.hepforge.org/downloads?f=buuinput2025.tar.gz wget --content-disposition https://gibuu.hepforge.org/downloads?f=libraries2025_RootTuple.tar.gz tar -xzvf buuinput2025.tar.gz tar -xzvf release2025.tar.gz tar -xzvf libraries2025_RootTuple.tar.gz
- change into release directory:
cd release
- a) compile RootTuple library:
make buildRootTuple
- b) compile GiBUU:
make withROOT=1
- 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
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:
- generate base directory:
mkdir GiBUU; cd GiBUU
- download and unpacking:
wget --content-disposition https://gibuu.hepforge.org/downloads?f=release2025.tar.gz wget --content-disposition https://gibuu.hepforge.org/downloads?f=buuinput2025.tar.gz wget --content-disposition https://gibuu.hepforge.org/downloads?f=libraries2025_HEPMC3.tar.gz tar -xzvf buuinput2025.tar.gz tar -xzvf release2025.tar.gz tar -xzvf libraries2025_HEPMC3.tar.gz
- change into release directory:
cd release
- a) compile HEPMC3event library:
make buildHEPMC3event
- b) compile GiBUU:
make withHEPMC3=1
- 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 /