Installation

Please note that Gauss is an LHCb-dependent package. If you are looking for an experiment-independent solutions, visit Gaussino:

Gaussino, the experiment-independent, core simulation framework

If you need to make changes to packages that Gauss depends on, such as Detector, please see the full software stack section.

The following instructions assume you already have python options defined in your_options.py. If you don’t, take a look at Running your first simulation.

Gauss only

Running Gauss from the release

Gauss(-on-Gaussino) is released with versions >= 60r0.

source /cvmfs/lhcb.cern.ch/lib/LbEnv
lb-set-platform x86_64_v2-el9-gcc13-opt
lb-run Gauss/v60r0 gaudirun.py your_options.py

Running Gauss from the nightlies

source /cvmfs/lhcb.cern.ch/lib/LbEnv
lb-set-platform x86_64_v2-el9-gcc13-opt
lb-run --nightly lhcb-sim11/latest Gauss/master gaudirun.py your_options.py

Building only a subset of Gauss packages

The example below shows you how to work and build a subset of the packages of Gaussino. We will use lb-dev for this purpose. We are going to need one of the nightly slots mentioned in the previous section.

source /cvmfs/lhcb.cern.ch/lib/LbEnv
lb-dev -c x86_64_v2-el9-gcc13-opt --nightly lhcb-sim11/HERE_PUT_SLOT_NUMBER Gauss/master
cd GaussDev_master
git lb-use Gauss

Configure and build the package you’d like to modify. Below you will find an example for Sim/Gauss.

git lb-checkout Gauss/master Sim/Gauss
make

Full software stack

As Gauss has a lot of project dependencies, building the whole stack by yourself might become not an easy task. Therefore, we recommend using the lb-stack-setup tool. It already does a lot of work for you. You might also benefit from using intellisense for C++/python in VSCode and many more.

curl https://gitlab.cern.ch/rmatev/lb-stack-setup/raw/master/setup.py | python3 - stack
cd stack
make Gauss

It will then ask you provide the name of the nightly slot you want your stack to be based on. For Gauss-on-Gaussino (Sim11) developments, please specify lhcb-sim11.

Attention

Please, always follow the instructions available directly on lb-stack-setup.