checkmate is hosted by Hepforge, IPPP Durham

Tutorial - Part 1: Our First Model Point Test

Initialising CheckMATE

Please go to the directory /home/checkmate/tools/CheckMATE-2.0.0-beta/bin where you should find the CheckMATE executable.

To enter the cross sections, event files and other settings, CheckMATE provides two possible means. For now we will stick to the more intuitive way, which is to provide a single text file with all the options inside (a so called parameter file).

In the same folder you should find an example parameter file testparam.dat with a minimally working example. Moreover, in example_run_cards/all_parameters_explained.dat one finds an exhaustive explanation of all possible parameters and CheckMATE setups.

If we have event files to provide, the structure of such a parameter file looks as follows: ## General Options
[Parameters]
Name: (a string that defines the name of the output directory)
Analyses: (which analysis / analyses to be tested)
(if wanted, set extra parameters here via 'Parameter: Value')

## Process Information (Each new process 'X' must start with [X])
[(Process Name 1)]
XSect: (number) (unit)
Events: (location of the event file for process 1)

[(Process Name 2)]
XSect: (number) (unit)
Events: (location of the event file for process 2)

...

Using what we have, we want to run the following settings:

  • Our run should have the name 'cMSSM'.
  • We want to use analysis 'atlas_1405_7875' (we will see later why).
  • To make our results easier to compare, we should use 'RandomSeed: 42' as a parameter.
  • We want to use the event files we just created and the NLO+NLL cross sections for the two processes gluinos and stops.

If you run CheckMATE with the correct setup described above, it should start with the following crosscheck output:

The following settings are used:
Analyses:
    atlas_1405_7875 (ATLAS, 0 lepton + 2-6 jets + missingET)
E_CM: 8.0
Processes:
    Name: gluinos
    Input Cross section: 41.4 fb
    Input event file(s):
        /home/checkmate/tutorial/part1/gluino_pair.hepmc

    Name: stops
    Input Cross section: 59.2 fb
    Input event file(s):
        /home/checkmate/tutorial/part1/stop_pair.hepmc

Output Directory:
    /home/checkmate/tools/CheckMATE-2.0.0-beta/results/cMSSM
Additional Settings:
    - Fixed random seed of 42
Is this correct? (y/n)

Write a working parameter card cMSSMparam.dat for the above example. You can (and should) check the syntax yourself by running ./CheckMATE cMSSMparam.dat until the above mentioned output occurs. Please only check the solution after you have managed to construct your own.
[Show Answer]

If your parameter file is ready and working, you can go ahead and start the CheckMATE run by answering y after CheckMATE's startup question. While it is running, let us proceed to the next page where we will briefly discuss what it actually does internally.

Continue