Getting started
Simulator dependencies
Make sure the following tools are installed and running:
MadGraph (we have tested our setup with version 2.8.0+). See MadGraph’s website for installation instructions. Note that MadGraph requires a Fortran compiler as well as Python 3.7+.
For the analysis of systematic uncertainties, LHAPDF6 has to be installed with Python support (see also the documentation of MadGraph’s systematics tool).
For the detector simulation part, there are different options. For simple parton-level analyses, we provide a bare-bones option to calculate truth-level observables which do not require any additional packages. We have also implemented a fast detector simulation based on Delphes with a flexible framework to calculate observables. Using this adds additional requirements:
echo "install pythia8" | python3 <MadGraph_dir>/bin/mg5_aMC
echo "install Delphes" | python3 <MadGraph_dir>/bin/mg5_aMC
Finally, Delphes can be replaced with another detector simulation, for instance a full detector simulation based
with Geant4. In this case, the user has to implement code that runs the detector simulation, calculates the observables,
and stores the observables and weights in the HDF5 file. The DelphesProcessor
and LHEProcessor
classes might provide
some guidance for this.
Install MadMiner
To install the MadMiner package with all its Python dependencies, run pip install madminer
.
To get the latest development version as well as the tutorials, clone the GitHub repository
and run pip install -e .
from the repository main folder.