checkmate is hosted by Hepforge, IPPP Durham

CheckMATE Tutorial @ YETI 2015


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 commnds 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

We recommend to use the LXTerminal in the virtual machine, as it is much easier to copy and paste commands! Open it from the task bar -> "Accessories" -> "LXTerminal".
Copying/Pasting can then 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

In exercise 3 you will generate events for a specific DM model, similar to exercise 2, and we will find exclusion limits within this model and compare to other experiments.
Start Exercise 3