The GiBUU project

The GiBUU project provides a unified theory and transport framework in the MeV and GeV energy regimes for

• elementary reactions on nuclei, as e.g.
  • electron + A,
  • photon + A,
  • neutrino + A ,
  • hadron + A (especially pion + A and proton + A)

• and for A + A heavy-ion collisions,

using the same physics input and code. The GiBUU code provides a full dynamical description of the reaction and delivers the complete final state of an event; it can thus be used as an event generator. The source code is freely available.

For all the reactions, the flow of particles is modeled within a Boltzmann-Uehling-Uhlenbeck (BUU) framework. The relevant degrees of freedom are mesons and baryons, which propagate in mean fields and scatter according to cross sections which are applicable to the energy range of a few 10 MeV to about 40 GeV. In the higher energy regimes the concept of pre-hadronic interactions is implemented in order to realize color transparency and formation time effects. For a general overview of the model, its theoretical basis as well as many practical details, refer to the review paper:

Transport-theoretical Description of Nuclear Reactions
O. Buss, T. Gaitanos, K. Gallmeister, H. van Hees, M. Kaskulov, O. Lalakulich, A. B. Larionov, T. Leitner, J. Weil, U. Mosel
​Phys. Rept. 512 (2012) 1-124 / ​Inspire

The numerical implementation, named GiBUU (aka The Giessen BUU Project), is written in modular Fortran 2003 and based upon a ​Subversion version control system, which allows for a concise control over the full development phase of the code.

The history of the code is rather long and reports about several main development steps. The present initiative accomplished a total rewrite of the source code in a present-day computing language. The main goals of this effort were modularization to allow for a more transparent multi-user development process, a strict reduction of global variables for a more transparent debugging procedure, an improved control over the development phase such that modifications can be backtracked and a unified standard version. Therefore every member of the team works on the same single code version, albeit different temporal branches may coexist. Possible technical overhead is compensated by the benefit of a faster distribution of improvements and innovations and their enhanced sustainability.

GiBUU is being developed by a collaboration of people at different institutes:

• ​Institut für Theoretische Physik of the ​Justus-Liebig-Universität Giessen.
• ​Joint Institute for Nuclear Research, Dubna
• ​Physics Department, Aristotle University of Thessaloniki

News

• 21. Feb. 2024: GiBUU 2023, patch 3 has been released.
  • jobcard (and flux, thanks to Max Fieg) added for FASER
  • default changed for initialization of density distribution of nuclei (now ReAdjustForConstBinding=.true.; not for RMF or if not static density)
  • avoid problems for additional Jetset particle decays (thanks to J. Schumann)
  • bugfix for antineutrinos
  • files with tabulations of medium widths in 'buuinput/' in some extra tarball (only needed by some example jobcards for heavy ion collisions)

• 12. Jan. 2024: GiBUU 2023, patch 2 has been released.
  • implement anti-deuteron beam on nuclear target (HeavyIon init)
  • bugfix for lepton masses in electron-/neutrino-nucleon machinery
  • bugfix for RMF propagation of rho, omega and phi mesons

• 7. Dec. 2023: GiBUU 2023, patch 1 has been released.
  • electron-/neutrino-nucleon machinery updated for better pion production results
  • line "version=2023" mandatory in jobcard to avoid outdated jobcards
  • cosmetics and minor bug fixes

• 31. Aug. 2023: GiBUU 2023 has been released.
  • new elementary e+N and nu+N prescription according ​Christy-Bosted fits when using 'initNeutrino' (for details see ​http://arxiv.org/abs/2308.16161)
    main switch new_eN in namelist 'nl_neweN'
  • OutChannels-Analysis also for events when using 'initNeutrino'
  • improve resonance production in lowPhoton/Electron in RMF mode
  • tachyons removed in RMF mode
  • number of ensembles<100 need to be enforced by a minus sign in the jobcard
  • "equal weights mode" for events using the 'HiLepton' init
  • bugfix for detailed balance in n pi+ <-> p pi0
  • modifications for newest compiler versions
  • (huge) refactoring, cosmetics, renaming and minor bug fixes

• Earlier Releases: see Release Notes

General Info

The GiBUU Model

• Physics input -- Learn more about our model
  • Plots of input cross sections
• Publications
• Presentations
• Visualizations, Movies

The GiBUU Team

• Project members and collaborators
• Code History -- How this code evolved

Using GiBUU

• Get-it-running: (...for the impatients: the installation in less than 10 lines)
  0. Prerequisites -- Used software and tools
  1. Download -- Get the GiBUU source code
  2. Compiling GiBUU
  3. Running GiBUU -- How to run a simulation
• Release Notes
• ​Subscribe to the 'GiBUU-announce' mailing list
• Tutorials:
  • Tutorial for neutrino-induced reactions (U.Mosel, K.Gallmeister, 2019)
  • Tutorial for neutrino-induced reactions (K.Gallmeister, 2017)
  • Tutorial: Dilepton simulations (J.Weil, 2016)
  • Tutorial: pp to AA (J.Weil, 2014)
• HowTos -- some general short tutorials
• FAQ -- Frequently Asked Questions

Documentation

• Automatic Code Documentation (Robodoc):
  • Release 2023
    (Index, Namelists, Output files) Namelists as single file
  • Current Development Version
    (Index, Namelists, Output files) Namelists as single file
• GiBUU particle numbering scheme
• Job cards -- Examples for GiBUU input files
• Some Introductions:
  • Event Output -- How to obtain event output at all
  • perWeight -- How to obtain cross sections from the event files
  • EqualWeight -- How to use the 'equal perweight mode'
  • CollisionList -- How to write out all interaction history
  • Cross Section Plotter -- How to generate plots of elementary XS interactivly
• Lines of Code

About GiBUU

• ​Ein Lasso für die Geisterteilchen, pro-physik, 27. September 2016
• ​Neutrinos on nuclei (by U. Mosel), CERN Courier, 22. September 2017
• Neutrino Long-Baseline Experiments and Nuclear Physics (by U. Mosel), in: ​Nuclear Physics News, v52, no 4, Dec. 2019
• "Simulation ganz seltener Stöße von Neutrinos; Gießener Physikerteam berechnet Reaktionen im künftigen internationalen Neutrino-Experiment DUNE" ​Pressemitteilung der JLU Gießen Nr. 58, 11. April 2024

External Projects

• Publications using GiBUU
• J. Schumann for KM3Net: km3buu, Python wrapper around GiBUU, docker container, output transformation
  for details see ​Python-based tools and frameworks for KM3NeT, talk at ​PyHEP 2021 workshop, 5.7.-9.7.2021
  code available at GitHub: ​https://github.com/KM3NeT/km3buu
• The GenieHad Event Generation Framework by the REDTOP experiment at Fermilab: ​https://redtop.fnal.gov/the-geniehadevent-generation-framework/
• Docker: multiple dockerfiles: ​https://github.com/luketpickering/numc_dockerfiles

Trivia

• The name of the project and its pronounciation should not be confused with a german coffee seller (Hamburg)
• In the germanic languages before the adoption of the latin alphabet, ​Runes were used. ​The seventh rune, looking similar to the letter 'X', has a pronounciation as 'gebo'. Its meaning is ​gift, present. (cf. K.Düwel, "Runenkunde", Springer, 2008 ​https://doi.org/10.1007/978-3-476-01419-1)
• 'gibuu' translates to 'wolf' in the Gitxsan and Nisga'a languages ​wikipedia ​dictionary

For Developers

• Internal pages (link only available for developers after login)

Contact

• ​Email to GiBUU group
  
• ​Email to webmaster
  

• Postal address

Privacy Policy

Privacy Policy