Demo of recoupling a decoupled project. Effective likelihoods and template parametrizations are hosted on the web.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Decoupled Demo

This demo repository shows a minimal example of how to use recouple on a decoupled model. Please refer to the documentation shown at the main decouple repository and the paper arXiv:1401.0080 [hep-ph] for more information about decouple and recouple.

For this demo, effective likelihoods and template parametrizations are hosted on this project's github page. You need to have a version of ROOT with PyROOT. Create a virtualenv (which usually comes with your python environment or can be insalled), install the requirements and run make:

virtualenv venv
source venv/bin/activate
pip install -r requirements.txt


make downloads the decoupled files from the web, runs recouple and creates plots.

kVkF kVkF

Setup environment on CERN's lxplus service

Before running the above commands, you need ROOT with PyROOT. If you can import ROOT in python without error then you are already set. If not ...

From the ROOT website (they are slightly outdated: you need SLC6 versions and not SLC5 and a python version that matches the python version ROOT was built with), the instructions for bash are (last tested January 2014):

# for PyROOT, setup Python environment first
export PATH="/afs/$PATH"

. /afs/
. /afs/

Afterwards, continue with the instructions above.


Please cite K. Cranmer, S. Kreiss, D. Lopez-Val and T. Plehn (2014) <> if you find this code useful in your research.


Copyright 2013-2014 Sven Kreiss, Kyle Cranmer

decoupledDemo is free software made available under the MIT License. For details see the LICENSE file.