[[TOC(WikiStart,physicsInput,download,Paper,GiBUU_Code_history,GiBUUTeam,depth=2)]] = 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 the quantum-kinetic [wiki:physicsInput 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; incoming lepton energies can go up to 1 TeV. 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'''[[br]] ''O. Buss, T. Gaitanos, K. Gallmeister, H. van Hees, M. Kaskulov, O. Lalakulich, A. B. Larionov, T. Leitner, J. Weil, U. Mosel''[[br]] [http://dx.doi.org/10.1016/j.physrep.2011.12.001 Phys. Rept. 512 (2012) 1-124] / [http://inspirehep.net/record/912923 Inspire] The numerical implementation, named '''GiBUU''' (aka ''The Giessen BUU Project''), is written in modular [wiki:programmingLiterature Fortran 2003] and based upon a [http://subversion.tigris.org/ Subversion] version control system, which allows for a concise control over the full development phase of the code. The [wiki:GiBUU_Code_history 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: * [https://www.uni-giessen.de/fbz/fb07/fachgebiete/physik/institute/theorie Institut für Theoretische Physik] of the [http://www.uni-giessen.de Justus-Liebig-Universität Giessen]. * [http://www.jinr.ru/main-en/ Joint Institute for Nuclear Research], Dubna * [http://www.physics.auth.gr/en/sections/2/people/215 Physics Department], Aristotle University of Thessaloniki {{{ #!comment * [https://www.uni-frankfurt.de/51086393 Institut für Theoretische Physik] of the [http://www.uni-frankfurt.de Goethe Universität Frankfurt] }}} {{{ #!NewsFlash = News = * '''21. Feb. 2024: [wiki:releaseNotes 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: [wiki:releaseNotes 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: [wiki:releaseNotes 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: [wiki:releaseNotes GiBUU 2023 has been released.] * new elementary e+N and nu+N prescription according [https://inspirehep.net/literature/771332 Christy-Bosted fits] when using 'initNeutrino' (for details see http://arxiv.org/abs/2308.16161) [[BR]] 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 {{{ #!comment * '''23. Mar. 2023: [wiki:releaseNotes GiBUU 2021 patch 4 has been released.] * "equal weights mode" for neutrino induced events * automatically generated 'namelists.pdf' added * memory leak fixed in !RootTuple v1.0.1 * cosmetics and minor bug fixes * '''1. Mar. 2023: [wiki:releaseNotes GiBUU 2021 patch 3 has been released.] * bugfix for positions of particles from neutrino 2pion-background * '''8. Feb. 2023: [wiki:releaseNotes GiBUU 2021 patch 2 has been released.] * extended OSCAR 2013 output format * residue scaling: bugfixes, also now for lowPhoton * simplify input of projetile and target nucleus by replacing the input variables 'projectile_A/Z' and 'target_A/Z' just by 'A/Z' * neutrino output into a named pipe instead of '!FinalEvents.dat' * cosmetics and minor bug fixes * 14. Apr. 2022: informations in the wiki added about [wiki:HowToFortranNMLtools tools working with Fortran namelist/jobcards] * ''' 11. May 2021: [wiki:releaseNotes GiBUU 2021 patch 1 has been released.] * improved transition from RES to DIS, for W = 2 -3 GeV * 2pi background improved, fixed to data for e-p scattering * Q^2^ cutoff for DIS removed, to account for high omega, low Q^2^ events * bug fix so that NC processes also run now * cosmetics and minor bug fixes * '''8. Feb. 2021: [wiki:releaseNotes GiBUU 2021 has been released.] * Modifications of rho-spectral function and dilepton production (https://inspirehep.net/literature/1818931) * improved 2pi background in e+N and nu+N collisions, improved transition from RES to DIS * Calculation of nuclear residue (cf. https://inspirehep.net/literature/1710338) * restrict number of ejected nucleons in perturbative runs by residue * implement in-medium changes of NN cross sections }}} * '''Earlier Releases: see [wiki:releaseNotes Release Notes ]''' {{{ #!comment * 8. Sept. 2020: ''patch 8:'' allow for filenames with up to 1000 characters * 3. June 2020: ''patch 7:'' bugfix pion-BG for antiNC, position output in ROOT files * 3. March 2020: ''patch 6:'' antiparticles in !FinalEvents.dat; Collision List * 10. Dec. 2019: ''patch 5:'' bugfix for A+A collisions * 5. Nov. 2019: ''patch 4:'' minor corrections for CLAS * 5. Aug. 2019: ''patch 3:'' minor bugfix for reading fluxes * 16. April 2019: ''patch 2:'' DUNE fluxes updated * 26. March 2019: ''patch 1:'' Default treatment of DIS events changed: momentum conservation improved * '''8. Feb. 2019: [wiki:releaseNotes GiBUU 2019 has been released.] }}} {{{ #!comment * 25. May 2018: New "General Data Protection Regulation" by the EU implemented (Privacy Policy) * '''13. Dez. 2017: Bugfix concerning perturbative weight of outgoing lepton in neutrino events * '''17. Nov. 2017: Slides from tutorial at NuSTEC School 2017 [wiki:tutorial17 available.] * '''29. Okt. 2017: [wiki:releaseNotes GiBUU 2017 has been released.] }}} }}} == General Info == The GiBUU Model * [wiki:physicsInput Physics input] -- Learn more about our model * [wiki:ErrorXSection Plots of input cross sections] * [wiki:Paper Publications] * [wiki:Talks Presentations] * [wiki:MovieMain Visualizations, Movies] The GiBUU Team * [wiki:GiBUUTeam Project members and collaborators] * [wiki:GiBUU_Code_history Code History] -- How this code evolved == Using GiBUU == * Get-it-running: ([wiki:impatient ...for the impatients: the installation in less than 10 lines]) 0. [wiki:tools Prerequisites] -- Used software and tools 1. [wiki:download Download] -- Get the GiBUU source code 2. [wiki:compiling Compiling GiBUU] 3. [wiki:running Running GiBUU] -- How to run a simulation * [wiki:releaseNotes Release Notes] * [https://www.hepforge.org/lists/listinfo/gibuu-announce Subscribe to the 'GiBUU-announce' mailing list] {{{#!comment * [//license Register] -- Become a registered GiBUU user }}} * Tutorials: * [wiki:tutorial19 Tutorial for neutrino-induced reactions (U.Mosel, K.Gallmeister, 2019)] * [wiki:tutorial17 Tutorial for neutrino-induced reactions (K.Gallmeister, 2017)] * [wiki:dileptons Tutorial: Dilepton simulations (J.Weil, 2016)] * [wiki:tutorial Tutorial: pp to AA (J.Weil, 2014)] * [wiki:HowTos] -- some general short tutorials * [wiki:FAQ] -- Frequently Asked Questions == Documentation == * Automatic Code Documentation (Robodoc): * [//Documentation2023/ Release 2023][[BR]] ([//Documentation2023/code/masterindex.html Index], [//Documentation2023/code/robo_namelist.html Namelists], [//Documentation2023/code/robo_output.html Output files]) [//Documentation2023/namelists.pdf Namelists as single file] * [//Documentation/ Current Development Version][[BR]] ([//Documentation/code/masterindex.html Index], [//Documentation/code/robo_namelist.html Namelists], [//Documentation/code/robo_output.html Output files]) [//Documentation/namelists.pdf Namelists as single file] * [wiki:ParticleIDs GiBUU particle numbering scheme] * [wiki:jobCards Job cards] -- Examples for GiBUU input files * Some Introductions: * [wiki:EventOutput Event Output] -- How to obtain event output at all * [wiki:perWeight] -- How to obtain cross sections from the event files * [wiki:EqualWeight] -- How to use the 'equal perweight mode' * [wiki:CollisionList] -- How to write out all interaction history * [wiki:CrosssectionPlotter Cross Section Plotter] -- How to generate plots of elementary XS interactivly * [wiki:LoC Lines of Code] == About GiBUU == * [https://www.pro-physik.de/nachrichten/ein-lasso-fuer-die-geisterteilchen Ein Lasso für die Geisterteilchen], pro-physik, 27. September 2016 * [https://cerncourier.com/a/neutrinos-on-nuclei/ Neutrinos on nuclei] (by U. Mosel), CERN Courier, 22. September 2017 * Neutrino Long-Baseline Experiments and Nuclear Physics (by U. Mosel), in: [http://www.nupecc.org/npn/npn294.pdf 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" [https://www.uni-giessen.de/de/ueber-uns/pressestelle/pm/pm58-24neutrinoexperiment Pressemitteilung der JLU Gießen Nr. 58, 11. April 2024] == External Projects == * [wiki:ExternalPublications Publications using GiBUU] * J. Schumann for KM3Net: '''km3buu''', Python wrapper around GiBUU, docker container, output transformation[[br]] for details see [https://indico.cern.ch/event/1019958/contributions/4418465/attachments/2278516/3871123/PyHEP2021_KM3NeT_km3py_overview_jschumann.pdf Python-based tools and frameworks for KM3NeT], talk at [https://indico.cern.ch/event/1019958/timetable/#20210705.detailed PyHEP 2021 workshop, 5.7.-9.7.2021][[br]] 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, [https://en.wikipedia.org/wiki/Runes Runes] were used. [https://de.wikipedia.org/wiki/Gebo The seventh rune], looking similar to the letter 'X', has a pronounciation as 'gebo'. Its meaning is [https://runesecrets.com/rune-meanings/gebo '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 [https://en.wikipedia.org/wiki/Laxgibuu wikipedia] [https://www.firstvoices.com/explore/FV/Workspaces/Data/Nisga'a/Nisga'a/Nisga'a/learn/words?page=1&pageSize=25&sortBy=ecm:fulltextScore&sortOrder=desc&searchTerm=gibuu&searchStyle=match&searchByTitle=true&searchByDefinitions=true&searchPartOfSpeech=Any&searchByTranslations=false dictionary] == For Developers == * [wiki:wikiInternal Internal pages] (link only available for developers after [/login login]) == Contact == * [mailto:gibuu@projects.hepforge.org Email to GiBUU group] [[BR]] * [mailto:gallmei@th.physik.uni-frankfurt.de Email to webmaster] [[BR]] * [wiki:GiBUUTeam#Contact Postal address] == Privacy Policy == [wiki:Privacy_Policy Privacy Policy]