Contur

Contur is a procedure and toolkit designed to probe theories Beyond the Standard Model using measurements at particle colliders. The original procedure is defined in a white paper , which should be used as a reference for the method, with an updated manual here. The statistical approach is also explained in a readme.

Results are available here. This README concentrates on how to get Contur running yourself.

We also have a support mailing list where volunteer developers will do their best to answer your questions: contur-support@cern.ch

In-code documentation

The in-code documentation, processed via Sphinx in the doc directory, is available here.

Getting started

Installation

Installation from conda-forge

Installation using Docker

First contur run

Exclusion plots

Generating your first 2D heatmap

Generating a heatmap using MadGraph

Interactive visualisation

Using machine-learning assisted parameter scanning

Adding new Rivet analyses

Adding a new analysis from your current Rivet release

Adding an new or modified Rivet analysis locally

Adding a new SM prediction

Developer information

See the Developers page.

Docker

Note that Dockerfiles containing a working setup (with or without Herwig) are available in the docker subdirectory. Instructions for how best to use Contur from these are still in preparation, but you can now get the latest by doing docker pull hepstore/contur. The Rivet/Yoda docker setup is quite mature and the guidance here might help.

Open projects

There is a list of open projects where we always welcome contributions!

Directory structure

contur

The main source code and template run area.

data

Common area for all data files (models, modified rivet elements, SM predictions etc)

tests

To run contur's code tests, do make check from the top directory, or to use other pytest options, cd into tests and run $ pytest.