= GiBUU release notes = After downloading the current GiBUU public release via [wiki:svn subversion], please read the contained [http://gibuu.hepforge.org/svn/releases/release2016/README.Quickstart.txt README.Quickstart.txt] to get started. See also our [wiki:FAQ FAQ site]. == Disclaimer == 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. === Timeline === * 08. Feb. 2016: [wiki:releaseNotes#GiBUU201602082016 GiBUU 2016] * 01. Oct. 2013: [wiki:releaseNotes#GiBUU1.610012013 GiBUU 1.6] * 10. Jul. 2012: [wiki:releaseNotes#GiBUU1.507102012 GiBUU 1.5] * 24. Nov. 2011: [wiki:releaseNotes#GiBUU1.4.111242011 GiBUU 1.4.1] * 01. Sep. 2011: [wiki:releaseNotes#GiBUU1.4.009012011 GiBUU 1.4.0] * 01. Dec. 2010: [wiki:releaseNotes#GiBUU1.3.112012010 GiBUU 1.3.1] * 23. Apr. 2010: [wiki:releaseNotes#GiBUU1.3.004232010 GiBUU 1.3.0] * 19. May 2009: [wiki:releaseNotes#GiBUU1.2.205192009 GiBUU 1.2.2] * 13. Feb. 2009: [wiki:releaseNotes#GiBUU1.2.102132009 GiBUU 1.2.1] * 21. Jan. 2009: [wiki:releaseNotes#GiBUU1.201212009 GiBUU 1.2] * 31. Okt. 2008: [wiki:releaseNotes#GiBUU1.110312008 GiBUU 1.1] * 29. Apr. 2008: [wiki:releaseNotes#GiBUU1.004292008 GiBUU 1.0] ---- == GiBUU 2016 (02/08/2016) == * updated K0 production cross sections ([http://arxiv.org/abs/1404.7011 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 [http://arxiv.org/abs/1403.7363 arXiv:1403.7363]) * new parametrization of em. N-Delta transition form factor by Ramalho & Pena ([http://arxiv.org/abs/1512.03764 arXiv:1512.03764]) * all major neutrino fluxes, including LBNF-DUNE, implemented * more realistic 2p2h cross section implemented with neutrino-antineutrino consistency == GiBUU 1.6 (10/01/2013) == * [https://gibuu.hepforge.org/Documentation1.6/code/collisions/twoBodyReactions/master_2Body_f90.html#robo1153 String threshold for baryon-baryon collisions] increased to 3.4 +- 0.1 GeV * Extended resonance model from [http://inspirehep.net/record/1094057 EPJ A48 (2012) 111] enabled by default * [https://gibuu.hepforge.org/Documentation1.6/code/rmf/RMF_f90.html#robo313 Kaon potentials] added (in RMF mode) * Possibility to tune the [https://gibuu.hepforge.org/Documentation1.6/code/collisions/twoBodyReactions/baryonBaryon/barBar_BarHypKaon_f90.html#robo2762 Kaon production cross sections] in baryon-baryon collisions * improved \(\pi\pi\) cross sections, \(f_2(1270)\) resonance added * [http://pythia6.hepforge.org/ 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 [http://arxiv.org/abs/1203.3557 arXiv:1203.3557] available (but not enabled by default) * Statistical Multifragmentation Model (SMM) by A. Botvina et al. included, cf. [http://inspirehep.net/record/405803 Phys.Rept. 257 (1995) 133-221] * HNV model [http://inspirehep.net/record/742678 Phys.Rev. D76 (2007) 033005] (7 interfering diagrams) for neutrino-nucleon interaction at low energies included, cf.[http://inspirehep.net/record/860671 Phys.Rev. D82 (2010) 093001] * [http://macdls.lbl.gov/DLS_WWW_Files/Filter_4.1/ DLS] and [http://www-hades.gsi.de/ HADES] acceptance filters included * Improved kaon- and antikaon-nucleon cross sections * Included J/Psi production in antiproton-proton collisions * [http://pythia6.hepforge.org/ 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 * [wiki:svn 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 [http://arxiv.org/abs/1107.2326 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 [http://developer.amd.com/cpu/open64/Pages/default.aspx 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 [http://www.uni-giessen.de/cms/fbz/fb07/fachgebiete/physik/einrichtungen/theorie/theorie1/publications/dissertation/neutrino-nucleus-interactions-in-a-coupled-channel-hadronic-transport-model pdf]) * Formation times according to Gallmeister, Falter, Phys. Lett. B '''630''' (2005), 40, [http://www.slac.stanford.edu/spires/find/hep/www?eprint=nucl-th/0502015 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 [wiki:mac 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 * [wiki:tools makedepf90] is no requirement anymore (dependencies can be generated with "Own_Makedepf90.pl" instead) * Resolved minor issues of the previous release. ---- == GiBUU 1.0 (04/29/2008) == * Initial public release of the GiBUU code! ---- === Requirements === GiBUU is developed primarily for Linux architectures, but works also on Windows and Mac OS X. For the specific requirements, please refer to the [wiki:tools 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: ==== Documentation ==== Includes the automatic documentation which is being generated by the ROBODOC documentation tool. ==== buuinput ==== Includes all input files to the code. ==== release1.X.X ==== 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: ===== objects ===== This directory will contain all the object and module files which are produced during the compilation process. ===== robodoc ===== 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''. ===== testRun ===== 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 }}} ===== code ===== This directory includes the full source code. The main steering program is called '''GiBUU.f90'''. See also the [//Documentation/code/robo_sourcefiles.html GiBUU Documentation] for information on specific source files. [[BR]] Several sub-directories split the code into different topics: * '''analysis''' [[BR]] Includes all analysis routines. * '''collisions''' [[BR]] The collision term. * '''database'''[[BR]] Includes particle ID's, particle properties and decay channels. * '''density'''[[BR]] Density and Pauli blocking routines. * '''init'''[[BR]] Initialization routines. * '''inMediumWidth''' [[BR]] Includes the routines which are used to calculate the in-medium-width. * '''inputOutput''' [[BR]] 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''' [[BR]] Includes numerical subroutines, includes also QUADPACK and CERNLIB fragments. * '''potential''' [[BR]] Potential routines and energy determination routines. * '''propagation'''[[BR]] Routines for propagating the test-particles in time. * '''run'''[[BR]] Run-time check routines. * '''rmf''' [[BR]] Relativistic mean field potential implementation. * '''spectralFunctions''' [[BR]] Routines connected to self energies and spectral functions. * '''storage'''[[BR]] Routines to generate histograms and to store information based on pointer lists. * '''typeDefinitions'''[[BR]] Includes all underlying type definitions, e.g. the definition of the ''particle'' type. * '''width'''[[BR]] 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