This tutorial teaches you the basics of the Monte Carlo Event Generator Herwig. An installation of Herwig on your own device is not necessary if you use the provided docker image (see next section). If you plan to use Herwig for your own research follow the instructions provided under Installation .

In this tutorial you will learn:

How to simulate LEP events
How to simulate LHC events
How to include rivet analyses and compare simulation with data
How to switch parts of the Event Generator on and off
How to modify parameters of the Parton shower and the Hadronization model
The Les Houches Event Handler

Before you start (docker containers)

All exercises within this tutorial can be done by using the provided docker image for Herwig.
If you have not already installed docker, please follow the instructions on the docker website and install docker on your device.

The required docker containers can be pulled directly from dockerhub with

docker pull hepstore/rivet-herwig:3.1.1-7.2.1

Linux users: sudo docker ...

In order to run Herwig, execute the following shell command

docker run -i  --rm  -u `id -u $USER`:`id -g`  -v $PWD:$PWD -w $PWD  hepstore/rivet-herwig:3.1.1-7.2.1 Herwig

This allows the container to access your local files and to write to the current working directory.

Create an alias for Herwig with

alias Herwig='docker run -i  --rm  -u `id -u $USER`:`id -g`  -v $PWD:$PWD -w $PWD  hepstore/rivet-herwig:3.1.1-7.2.1 Herwig'

To run Herwig execute

Herwig

in your terminal.

Create also an alias for the rivet command rivet-mkhtml

alias rivet-mkhtml='docker run -i  --rm  -u `id -u $USER`:`id -g`  -v $PWD:$PWD -w $PWD  hepstore/rivet-herwig:3.1.1-7.2.1 rivet-mkhtml'

If this works, you are ready to start the tutorial with First run: LEP. If you encounter problems, please talk to a tutor.

Instructions:

1. Installation
2. First run: LEP
3. Second run: Z production and jets at the LHC
4. (Advanced) Third run: minimum bias events and soft physics
5. (Advanced) The Les Houches Event Handler

Helpful literature
Herwig manual