gibuu is hosted by Hepforge, IPPP Durham
GiBUU

Version 10 (modified by gallmei, 8 weeks ago) (diff)

adding info about HepMC3 library for future version v2024

Installation instructions for the impatients

If you do not bother about the details, maybe the following instructions are enough for you to get GiBUU running. In any case of troubles, please read the full story,

  1. Prerequisites -- Used software and tools
  2. Download -- Get the GiBUU source code
  3. Compiling GiBUU

In the case you face problems with libRootTuple, follow this direct link.

At the moment, only downloading of tar-balls is possible.

Default Installation

  1. generate base directory:
    mkdir GiBUU; cd GiBUU
    
  1. download and unpacking:
    wget --content-disposition https://gibuu.hepforge.org/downloads?f=release2023.tar.gz
    wget --content-disposition https://gibuu.hepforge.org/downloads?f=buuinput2023.tar.gz
    
    tar -xzvf buuinput2023.tar.gz
    tar -xzvf release2023.tar.gz
    
  1. change into release directory:
    cd release
    
  1. compile GiBUU:
    make
    
  1. run GiBUU:
    ./testRun/GiBUU.x < your_Jobcard
    

Installation with ROOT output

If you want to use the possibility to get event output in ROOT format, the installation has to be slightly modified:

  1. generate base directory:
    mkdir GiBUU; cd GiBUU
    
  1. download and unpacking:
    wget --content-disposition https://gibuu.hepforge.org/downloads?f=release2023.tar.gz
    wget --content-disposition https://gibuu.hepforge.org/downloads?f=buuinput2023.tar.gz
    wget --content-disposition https://gibuu.hepforge.org/downloads?f=libraries2023_RootTuple.tar.gz
    
    tar -xzvf buuinput2023.tar.gz
    tar -xzvf release2023.tar.gz
    tar -xzvf libraries2023_RootTuple.tar.gz 
    
  1. change into release directory:
    cd release
    
  1. a) compile RootTuple library:
    make buildRootTuple
    
  1. b) compile GiBUU:
    make withROOT=1
    
  1. run GiBUU:
    ./testRun/GiBUU.x < your_Jobcard
    

ensure to have something like the following in 'your_Jobcard':

! file: ./analysis/EventOutputAnalysis.f90
&EventOutput
      WritePerturbativeParticles = T
      EventFormat = 4 ! 1=LesHouches, 4=ROOT
/

Installation with HepMC3 output (future v2024)

If you want to use the possibility to get event output in HepMC3 format via the HepMC3 C++ library, the installation has to be slightly modified:

  1. generate base directory:
    mkdir GiBUU; cd GiBUU
    
  1. download and unpacking:
    wget --content-disposition https://gibuu.hepforge.org/downloads?f=release2024.tar.gz
    wget --content-disposition https://gibuu.hepforge.org/downloads?f=buuinput2024.tar.gz
    wget --content-disposition https://gibuu.hepforge.org/downloads?f=libraries2024_HEPMC3.tar.gz
    
    tar -xzvf buuinput2024.tar.gz
    tar -xzvf release2024.tar.gz
    tar -xzvf libraries2024_HEPMC3.tar.gz 
    
  1. change into release directory:
    cd release
    
  1. a) compile !HEPMC3event library:
    make buildHEPMC3event
    
  1. b) compile GiBUU:
    make withHEPMC3=1
    
  1. run GiBUU:
    ./testRun/GiBUU.x < your_Jobcard
    

ensure to have something like the following in 'your_Jobcard':

! file: ./analysis/EventOutputAnalysis.f90
&EventOutput
      WritePerturbativeParticles = T
      EventFormat = 6 ! 1=LesHouches, 6=HepMC3
/