General and usage-specific dependencies#

CepGen was designed to require only a limited set of external dependencies for its core features.

Among the mandatory dependencies,

• CMake for the management of the build process,

• GSL, for the integrators definition and general utilitaries. A version greater than or equal to 2.1 is recommended for the bilinear spline interpolation capability. This latter is used in e.g. the MSTW structure functions and KMR $k_{\mathrm{T}}$-factorised gluon flux definitions.

Depending on your system architecture and distribution, these dependencies may be installed the following way:

sudo apt-get install cmake
sudo apt-get install g++ gfortran
sudo apt-get install libgsl2 libgsl-dev

sudo dnf install cmake
sudo dnf install gcc-c++ gcc-gfortran
sudo dnf install gsl gsl-devel

It can further be extended through a set of add-ons loaded through shared libraries into the runtime environment.

For instance, it is highly recommended to install the following dependencies to ease your first steps:

• CepGenPython: complex Python version 2 or 3 steering cards parsing ; it requires the python-devel or libpython-dev development headers to be built,

• CepGenLHAPDF with LHAPDF version 5 or above, for definition of partonic-level nucleon structure functions, and its ${\alpha }_S(Q)$ strong coupling constant evolution algorithm.

A set of add-ons specifically designed to ease your workflow when generating and storing events is also provided, given the following libraries are available on your system:

• CepGenPythia8: Pythia version 8.1 or above, for the various particles decays and excited proton fragmentation, but also the LHEF event format generation,

• CepGenPythia6: Pythia version 6, for the legacy steering of particles decays and excited proton fragmentation,

• CepGenHepMC2 and CepGenHepMC3 for the HepMC version ≥ 2, to handle its various ASCII output formats,

  Note

  From version 3 on, a LHEF output is also supported. If not present, this latter format can be handled through the Pythia 8 interface instead.

• CepGenROOT: for the ROOT ntuples building/histogramming/plotting capabilities widely used in HEP.

CepGen installation#

Start by downloading the latest release in the bucket list of releases. Unpack the sources in a location referred here as: $CEPGEN_SOURCES.

For instance, for a CepGen version x.y.z package:

tar xvfz cepgen-x.y.z.tar.gz

Once you have set up the sources and downloaded/installed the required dependencies, create your building environment (following the CMake convention, this latter is usually the build/ directory). The compilation, and (optional, although very recommended) system installation is hence done with:

mkdir build && cd build
cmake [-DCMAKE_INSTALL_PREFIX=/path/to/install] /path/to/cepgen/sources/
make # optionally, add -jN (N=number of parallel threads for compilation)
make install

Optionally, if Ninja is installed on your system, you may add the extra -GNinja flag to the aforementioned cmake command, and launch the build using the following command:

cmake [-DCMAKE_INSTALL_PREFIX=/path/to/install] -GNinja /path/to/cepgen/sources/
ninja
ninja install

This compilation will build a collection of required sub-libraries to be linked against any executable built on top of CepGen.:

• libCepGen contains all physics constants, calculators, helpers, along with standard objects implementation, nucleon structure function calculators objects, the definition of events and subleading particles objects (useful for analyses of CepGen outputs), and input cards definition and handling parts ;

• libCepGenProcesses contains all processes definitions and implementations.

In addition, upon their availability on your system at compilation time, the collection of libCepGenXXX add-ons described above will be generated for your convenience.

As described here, several test executables can be linked against the CepGen libraries.