= GiBUU release notes = ''' Important:''' To download GiBUU you need to have a login account. If you have no login yet, then please [wiki:GiBUUDownload#Gettingfullaccess create your account here.] After downloading the current [http://gibuu.physik.uni-giessen.de/GiBUU/downloads GiBUU public release] please read the contained 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 be reproducible by the public releases below. === Timeline === * 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 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. For further requirements and details see [wiki:releaseNotes#GiBUU1.004292008 release notes of GiBUU 1.0]. ---- == GiBUU 1.0 (04/29/2008) == === Requirements === GiBUU is developed to work on Linux architectures. To compile the code, the following software packages must be installed on your system: * a modern [wiki:tools fortran compiler] * [wiki:tools makedepf90] (generates dependencies) * [http://www.gnu.org/software/make/ make] (steers the compiling process) To generate the documentation one needs: * [wiki:tools robodoc] === 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. ==== workingCode ==== The ''workingCode'' 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''. Furthermore, 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''. 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: ===== buuinput ===== Includes all input files to the code. Within the directory, the file ''Makefile'' is used to unzip large files and to prepare necessary input. ===== testRun ===== Here the executable "main.x" is found after successful compilation. The sub-directory ''jobCards'' includes sample job cards for different scenarios. To execute a job type: {{{ ./main.x < jobcardName }}} ===== code ===== This directory includes the full source code. The main steering program is called '''main.f90'''. See also the [http://theorie.physik.uni-giessen.de/~gibuu/Documentation/code/robo_sourcefiles.html#top 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. * '''dilepton'''[[BR]] Dilepton yields and analysis. * '''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) ==== ==== Pion induced (low energy) ==== ==== Photon induced (low energy) ==== ==== Electron induced (low energy) ==== ==== Neutrino induced (low energy) ==== ==== Heavy Ion (high energy) ==== ==== Pion induced (high energy) ==== ==== Photon induced (high energy) ==== ==== Lepton (virtual Photon) induced (high energy) ==== ==== 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 ==== ==== Hadron induced ====