GiBUU is hosted by Hepforge, IPPP Durham

GiBUU release notes

After downloading the current GiBUU public release via subversion, please read the contained README to get started. See also our FAQ site.


We do not publish every revision of the code. Especially we retain parts of the code representing ongoing doctoral theses or other unpublished work. Therefore results published by our group may not (yet) be reproducible by the public releases below.


GiBUU 2017 (10/xx/2017)

to be done

  • JLAB/CLAS12 RunGroupA initialization (contributed by Michael Kunkel)
  • some neutrino fluxes added/updated
  • back reactions for decay into 3 mesons added (detailed balance)
  • minor renaming/deleting of flags in namelists
    • debugflags removed from all namelists
    • 'propagation': e.g. predictorCorrector --> Mode, DerivativeType --> RungeKuttaOrder
    • 'propagation': useCoulomb --> useCoulombDirectly to avoid misunderstandings
  • make neutrino runs silent by default:
    • 'neutrino_induced': new switch printAbsorptionXS
    • 'neutrinoAnalysis': new switch Xsection_analysis, default of detailed_diff_output set to false
  • minor bugfixes and modifications, cosmetics

GiBUU 2016 (02/08/2016)

  • updated K0 production cross sections (arXiv:1404.7011)
  • Kaon potentials in RMF mode
  • new Skyrme parametrization (-> Shanghai meeting)
  • non-linear symmetry energy (contributed by Gaochan Yong)
  • in-medium cross section parametrization in Skyrme mode (according to arXiv:1403.7363)
  • new parametrization of em. N-Delta transition form factor by Ramalho & Pena (arXiv:1512.03764)
  • all major neutrino fluxes, including LBNF-DUNE and new BNB, implemented
  • more realistic 2p2h cross section implemented, with neutrino-antineutrino and neutrino-electron consistency
  • local collision criterion also for real-real collisions
  • fulfill detailed balance in K Kbar <-> mes mes' (correct spectral shape, not only pole masses)

GiBUU 1.6 (10/01/2013)

  • String threshold for baryon-baryon collisions increased to 3.4 +- 0.1 GeV
  • Extended resonance model from EPJ A48 (2012) 111 enabled by default
  • Kaon potentials added (in RMF mode)
  • Possibility to tune the Kaon production cross sections in baryon-baryon collisions
  • improved \(\pi\pi\) cross sections, \(f_2(1270)\) resonance added
  • Pythia updated to version 6.4.27
  • 2p-2h contributions for neutrino-induced events added
  • Flux distributions of all major long baseline neutrino experiments implemented
  • Energy reconstruction and migration matrices for neutrino experiments implemented
  • Oscillation analysis for neutrino experiments implemented
  • First 'full' release of GiBUU with all code-parts included

GiBUU 1.5 (07/10/2012)

  • Extended resonance model from arXiv:1203.3557 available (but not enabled by default)
  • Statistical Multifragmentation Model (SMM) by A. Botvina et al. included, cf. Phys.Rept. 257 (1995) 133-221
  • HNV model Phys.Rev. D76 (2007) 033005 (7 interfering diagrams) for neutrino-nucleon interaction at low energies included, cf.Phys.Rev. D82 (2010) 093001
  • DLS and HADES acceptance filters included
  • Improved kaon- and antikaon-nucleon cross sections
  • Included J/Psi production in antiproton-proton collisions
  • PYTHIA updated to version 6.4.26
  • DIS processes (via PYTHIA) in neutrino interactions included
  • Relativistic mean field model treatment of perturbative particle propagation optionally included
  • svn access to the release branch for registered users (read-only)
  • Many other improvements

GiBUU 1.4.1 (11/24/2011)

  • Bugfix release
  • A few problems reported by external users have been fixed, mostly in antiproton-nucleus reactions (thanks to Yue Ma, Josef Pochodzalla, Olaf Hartmann and others)
  • Some problems with specific compilers have been addressed

GiBUU 1.4.0 (09/01/2011)

  • Implementation of a statistical annihilation model (I.A. Pshenichnov et al) for antinucleon-nucleon annihilation into mesons including KKbarX production channels (good for beam momenta above 2-3 GeV/c). At lower beam momenta this model is supplemented by phenomenological branching ratios.
  • Many new elementary reaction channels added (e.g. Nbar N -> Ybar Y, Nbar N -> Xibar Xi, Y N -> Y N, Xi N -> Y Y). For details see arXiv:1107.2326.
  • PYTHIA updated to version 6.4.25.
  • Many other improvements.

GiBUU 1.3.1 (12/01/2010)

  • Bugfix release
  • A few problems reported by external users have been fixed (thanks to the eager testers: Olaf Hartmann, Prajwal Mohanmurthy, Michael Paolone and others)
  • Some smaller bugfixes have been backported from trunk (mostly output problems with the Les Houches format, histograms, etc)
  • Support for the Open64 compiler has been added

GiBUU 1.3.0 (04/23/2010)

  • Neutrino-induced reactions available (a full description of the neutrino part is given in T. Leitner's dissertation pdf)
  • Formation times according to Gallmeister, Falter, Phys. Lett. B 630 (2005), 40, SPIRES entry
  • PYTHIA 6.4 is default by now
  • Many other improvements

GiBUU 1.2.2 (05/19/2009)

  • Bugfix in "Les Houches Event File" output (only relevant for HiLepton/HiPhoton)
  • Otherwise identical to release 1.2.1

GiBUU 1.2.1 (02/13/2009)

  • Support for compiling and running GiBUU on Mac OS X, see GiBUU on Mac.
  • Otherwise identical to release 1.2

GiBUU 1.2 (01/21/2009)

  • Possibility to link code against PYTHIA 6.419
  • Output according Les Houches Event Files Standard.
  • Resolved minor issues of the previous release.

GiBUU 1.1 (10/31/2008)

  • New Makefile concept: better treatment of source code dependencies
  • makedepf90 is no requirement anymore (dependencies can be generated with "" instead)
  • Resolved minor issues of the previous release.

GiBUU 1.0 (04/29/2008)

  • Initial public release of the GiBUU code!


GiBUU is developed primarily for Linux architectures, but works also on Windows and Mac OS X. For the specific requirements, please refer to the prerequisites page.

Source code structure

The GiBUU repository is structured into several directories and the source code itself is sorted into different topics. The following (incomplete) list outlines the directory structure. Within the base directory, one finds the sub-directories:


Includes the automatic documentation which is being generated by the ROBODOC documentation tool.


Includes all input files to the code.


The release directory includes the main source code of the GiBUU project. The file Makefile steers the compilation process and is being documented in the file README.Makefile.txt. The file Makefile.SUB is distributed via make renew as a Makefile to all sub-directories within the code directory. Important sub-directories within workingCode are:


This directory will contain all the object and module files which are produced during the compilation process.


Here all the files related to the robodoc documentation system are found. An example for the documentation usage is presented in DemoFoRobodoc.f90. The file robodoc.css includes the style sheets for the HTML-Documentation, and the ROBODOC configuration is included in the file GenerateDoku.rc.


Here the executable "GiBUU.x" is found after successful compilation. The sub-directory jobCards includes sample job cards for different scenarios. To execute a job type:

./GiBUU.x < jobcardName

This directory includes the full source code. The main steering program is called GiBUU.f90. See also the GiBUU Documentation for information on specific source files.

Several sub-directories split the code into different topics:

  • analysis
    Includes all analysis routines.
  • collisions
    The collision term.
  • database
    Includes particle ID's, particle properties and decay channels.
  • density
    Density and Pauli blocking routines.
  • init
    Initialization routines.
  • inMediumWidth
    Includes the routines which are used to calculate the in-medium-width.
  • inputOutput
    Includes the input module input.f90 for the most important switches, such as e.g. the number of ensembles. Furthermore, this directory provides routines to generate output.
  • numerics
    Includes numerical subroutines, includes also QUADPACK and CERNLIB fragments.
  • potential
    Potential routines and energy determination routines.
  • propagation
    Routines for propagating the test-particles in time.
  • run
    Run-time check routines.
  • rmf
    Relativistic mean field potential implementation.
  • spectralFunctions
    Routines connected to self energies and spectral functions.
  • storage
    Routines to generate histograms and to store information based on pointer lists.
  • typeDefinitions
    Includes all underlying type definitions, e.g. the definition of the particle type.
  • width
    Includes all kinds of routines which are connected to the width and spectral functions of the baryons and mesons.

Details on the initialisation

GiBUU can handle the following processes:

  • elementary
  • Heavy Ion (low energy / high energy)
  • Pion induced (low energy / high energy)
  • Photon induced (low energy / high energy)
  • Electron induced (low energy)
  • Neutrino induced (low energy)
  • Lepton (virtual Photon) induced (high energy)
  • Hadron induced
  • Pions in a BOX of nucleons (continuous boundary conditions)
  • Deltas in a BOX of nucleons (continuous boundary conditions)
  • Groundstate calculation
  • simple transport of a given particle
Last modified 11 days ago Last modified on Oct 10, 2017, 5:54:04 PM