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.24/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)
SLHAFile: (which spectrum file to use)
(if wanted, set extra parameters here via 'Parameter: Value')

## Process Information (Each new process 'X' must start with [X])
[(Process Name 1)]
Pythia8Process: (production process eg. p p > go go)
XSect: (number) (unit)
MaxEvents: (number of events to be generated)

[(Process Name 2)]
Pythia8Process: (production process eg. p p > go sq)
XSect: (number) (unit)
MaxEvents: (number of events to be generated)

...

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

  • Our run should have the name 'cMSSM'.
  • We want to use analysis 'atlas_1712_02332' (we will see later why).
  • To make our results easier to compare, we should use 'RandomSeed: 10' 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 squarks.

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_1712_02332 (squarks and gluinos, 0 lepton, 2-6 jets)
E_CM: 13.0
Processes:
    Name: glu_glu
    Input Cross section: 0.34 fb
    Associated event files and/or Monte-Carlo generation runs:
        Pythia8 Events
            - internal identifier: 'glu_glu'
            - simplified SUSY process: p p > go go
            - at most 1000 events are generated and analysed

    Name: glu_sq
    Input Cross section: 0.97 fb
    Associated event files and/or Monte-Carlo generation runs:
        Pythia8 Events
            - internal identifier: 'glu_sq'
            - simplified SUSY process: p p > go sq
            - at most 1000 events are generated and analysed

    Name: sq_sq
    Input Cross section: 0.41 fb
    Associated event files and/or Monte-Carlo generation runs:
        Pythia8 Events
            - internal identifier: 'sq_sq'
            - simplified SUSY process: p p > sq sq
            - at most 1000 events are generated and analysed

Output Directory:
    /home/checkmate/tools/CheckMATE-2.0.24/results/part1
Additional Settings:
    - SLHA file cMSSM.slha will be used for event generation
    - Fixed random seed of 10
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