PYTHIA 8 Docker image with Python 3 and HEP simulation stack

PYTHIA is a program for the generation of high-energy physics events, i.e. for the description of collisions at high energies between elementary particles such as e+, e-, p and pbar in various combinations.

PYTHIA 8's source is distributed on GitLab and is a product of the PYTHIA development team.

Distributed Software

The Docker image contains:

• Python 3.10
• HepMC3 v3.2.5
• LHAPDF v6.5.3
• FastJet v3.4.0
• PYTHIA v8.308

Installation

• Check the list of available tags on Docker Hub to find the tag you want.
• Use docker pull to pull down the image corresponding to the tag. For example:

docker pull matthewfeickert/pythia-python:pythia8.308

Use

You can either use the image as "PYTHIA as a service", as demoed here with the test script in the repo using the Python bindings

docker run \
  --rm \
  --user $(id -u $USER):$(id -g $USER) \
  --volume $PWD:/home/docker/work \
  matthewfeickert/pythia-python:pythia8.308 \
  'python tests/main01.py > main01_out_py.txt'

or the original C++

docker run \
  --rm \
  --user $(id -u $USER):$(id -g $USER) \
  --volume $PWD:/home/docker/work \
  matthewfeickert/pythia-python:pythia8.308 \
  'g++ tests/main01.cc -pthread -o tests/main01 $(pythia8-config --cxxflags --ldflags); ./tests/main01 > main01_out_cpp.txt'

or you can run interactively

docker run \
  --rm \
  -ti \
  --publish 8888:8888 \
  --user $(id -u $USER):$(id -g $USER) \
  --volume $PWD:/home/docker/work \
  matthewfeickert/pythia-python:pythia8.308