Skip to content

Environment

Container

Containers are a convenient environment for running and developing software. This tutorial uses the mucoll container version 2.9.1 with apptainer. This container exists on the CERN Virtual Machine File System (/cvmfs) and includes a baseline version of the muon collider software.

The environment can be started like:

apptainer run \
    -B /scratch/${USER} \
    -B /ospool/uc-shared/project/muoncollider/ \
    /cvmfs/unpacked.cern.ch/gitlab-registry.cern.ch/muon-collider/mucoll-deploy/mucoll:2.9-alma9
source /opt/setup_mucoll.sh

The -B/--bind option tells apptainer which directories to include in the environment. We're including the scratch directory and a muoncollider data directory.

The muon collider software in the container is organized with Spack package manager, as described at mucoll-spack. The average person in this tutorial will not need to interact with Spack unless they want to.

If everything is OK, you should be able to run the following commands with no error messages:

cd /scratch/$USER/tutorial2024
ddsim -h
python -c "import pyLCIO"
python -c "from Configurables import LcioEvent, MarlinProcessorWrapper"
python mucoll-benchmarks/generation/pgun/pgun_lcio.py -h

Additional setups

Muon collider software can be set up in two additional ways:

  • load the environment pre-installed under the dedicated CVMFS repository (CERN Virtual Machine File System)
  • manually install all the software on your machine using Spack package manager, following the instructions

Each method has its own optimal use cases, and for this tutorial we will stick with the container. The additional ways to set up software are described in previous tutorials.