checkmate is hosted by Hepforge, IPPP Durham

CheckMATE Tutorial @ CheckMATE 2 Online


This tutorial will guide you through some practical examples to learn how CheckMATE works. We have chosen three toy models which you will consecutively analyse. In addition to CheckMATE, we will also run some other tools that are useful for collider phenomenology. To help aid understanding, we will also encounter some quick questions to make sure that the meaning behind the tasks is also clear. This is important as CheckMATE can be used for a large class of different models and hence it is important when looking at particular examples why certain features of a given model require a certain setup.

Along the way you will find the following three important icons:

Question marks provide you with small questions that usually go slightly beyond the explanations before and test the general understanding. Some are more, some are less difficult, depending on your background knowledge. What do you think can you do in order to check your answers?
[Show Answer]

Exlamation marks require your active participation. These are the most important bits of the tutorial and you should not continue without having completed the task (unless explicitly told, as we sometimes might do two things in parallel).
For now, you just have to go to the CheckMATE homepage and press CTRL+D to bookmark it for the future.

Obviously, this is a combination of the above two. You have to perform an active task in order to find an answer which you then can check. Click on the CheckMATE logo at the top of this page to look at the larger version. What is written on the two kings? What does it mean?
[Show Answer]


The practical examples of this tutorial all relate to a virtual machine that has been set up for you. You cannot participate in the tutorial without having the virtual disk downloaded and the machine being set up! You can find more information on the virtual machine here.

The machine runs linux and you will need some standard commands to follow the tasks here:

  • cd dir     enters directory dir
  • cat file     prints the content of file inside the terminal
  • emacs file     opens emacs editor to edit file
  • ./executable param1 param2 ...     runs the executable in the current directory with parameters param1 etc

Copying/Pasting can be done by either using right-click or using the key shortcuts (Shift + Ctrl + C/V). Beware that there is an extra Shift here, as Ctrl + C kills the current process!


In exercise 1 you will test a very simple single model point with CheckMATE by first creating the event files and using a tool to calculate the cross sections. We will then have a quick look at the results.
Start Exercise 1

In exercise 2 you will have to generate events for a given SUSY model yourself. We will then try to reproduce ATLAS exclusion lines ourselves to see how reliable CheckMATE is in setting limits.
Start Exercise 2

You will use your knowledge from the previous exercise to simulate events for the MC4BSM model (and by that know how to test in principle any model with CheckMATE)
Start Exercise 3