==This is the main page for the Herwig tutorial at the MCnet 2019 school.==
This is the tutorial for the first day of the MCnet school and teaches you the basics of the Herwig Monte Carlo Event Generator. An installation of Herwig on your own device is not necessary if you use the provided virtual docker image (see next section). If you plan to use Herwig for your own research, after the MCnet school, the instructions provided under [[ https://phab.hepforge.org/w/mcnet2019/installation/ | Installation ]] might be helpful.
During the course of 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 [[https://docs.docker.com/install/ | docker website]] and install docker on your personal computer.
The required docker containers can be pulled directly from dockerhub with
docker pull hepstore/rivet-herwig:3.1.1-7.2.1
Remember Linux users: sudo docker
That is basically it! 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 files to the current working directory.
Additionally, you can create an alias 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'
Now, all you have to do to run Herwig is to execute
Herwig
in your terminal.
We also recommend creating 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 [[ https://phab.hepforge.org/w/mcnet2019/firstrun/ | First run: LEP]]. If you have any issues, please talk to a tutor.
**Instructions:**
# [[ https://phab.hepforge.org/w/mcnet2019/installation/ | Installation ]]
# [[ https://phab.hepforge.org/w/mcnet2019/firstrun/ | First run: LEP]]
# [[ https://phab.hepforge.org/w/mcnet2019/secondrun/ | Second run: Z production and jets at the LHC ]]
# [[ https://phab.hepforge.org/w/mcnet2019/thirdrun/ | (Advanced) Third run: minimum bias events and soft physics ]]
# [[ https://phab.hepforge.org/w/mcnet2019/leshouches/ | (Advanced) The Les Houches Event Handler ]]
**Helpful literature**
[[ https://arxiv.org/abs/0803.0883 | Herwig manual ]]