Skip to main content

A tool for interpreting simplified-model results from the LHC

Project description

GitHub Project PyPI version CodeFactor Colab Docs

SModelS v2

SModelS – A tool for interpreting simplified-model results from the LHC.

SModelS is an automatic, public tool for interpreting simplified-model results from the LHC. It is based on a general procedure to decompose Beyond the Standard Model (BSM) collider signatures presenting a Z2 symmetry into Simplified Model Spectrum (SMS) topologies. Our method provides a way to cast BSM predictions for the LHC in a model independent framework, which can be directly confronted with the relevant experimental constraints.


For instructions on how to install SModelS, see the section Installation of the SModelS online manual.

Running SModelS

SModelS provides a command-line tool ( for the basic functionalities, which can be executed as:

./ -p <parameter file> -f <input file or directory> -o <output directory>

For help instructions:

./ -h

An example file on how to call the SModelS libraries from your own Python code can be found in

Detailed explanations on how to use SModelS, including explanations of the output, can be found in the section Using SModelS of the SModelS online manual.

A few example input files are provided in the inputFiles folder and can be used to test


If you use this software please cite both the SModelS v1.1 and v1.2 manuals, the original SModelS publication, as well as the programs it makes use of (pythia8/pythia6, NLL-fast and pyslha). If you use specifically the long-lived particles implementation, please cite also this paper. For the Run2 database, cite the v1.2 manual and the databaseUpdate paper.

For your convenience, the relevant citations are provided in bibtex format in references.bib.

For citing the experimental analyses in the database, you can use smodels-database/database.bib.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

smodels-2.3.3.tar.gz (3.3 MB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page