Skip to main content

A Python package for high-energy physics analysis to provide SUSY cross section data

Project description

Build Status Coverage Status License: MIT

susy_cross_section: Table-format cross-section data handler

A Python package for cross section tables and interpolation.

Quick Start

This package supports Python 2.7 and 3.5+.

Install simply via PyPI and use a script as:

$ pip install susy-cross-section
$ susy-xs-get 13TeV.n2x1+.wino 500
(32.9 +2.7 -2.7) fb
$ susy-xs-get 13TeV.n2x1+.wino 513.3
(29.4 +2.5 -2.5) fb

which gives the 13 TeV LHC cross section to wino-like neutralino-chargino pair-production (p p > n2 x1+), etc. The values are taken from LHC SUSY Cross Section Working Group with interpolation if needed.

You can find a list of supported processes in susy_cross_section/config.py. It is also straight forward to parse your own table files once you provide .info files as you find in susy_cross_section/data/.

You can uninstall this package as simple as

$ pip uninstall susy-cross-section
Uninstalling susy-cross-section-x.y.z:
   ...
Proceed (y/n)?

Introduction

Production cross sections are the most important values for high-energy physics collider experiments. There are many sources for the values, evaluated in various tools or schemes. For SUSY scenarios, the values provided by LHC SUSY Cross Section Working Group are the most famous source of the "nominal" cross section expectation. However, their results as well as results provided in other references are not in machine-readable format and the data are provided in various format.

This package provides a module susy_cross_section to handle those data. Any table-like files can be interpreted and read as a https://pandas.pydata.org/ DataFrame object, once an annotation file (info files in JSON format) is provided, so that one can easily interpolate the grid by, e.g., scipy.interpolate.

For simpler use-case, a command-line script susy-xs-get is provided, with which one can get the cross section in several simple scenarios.

Several data tables are included in this package, which is taken from, e.g., LHC SUSY Cross Section Working Group. In addition, one can use their own files by writing annotations, so that they interpolate their data with pre-installed interpolator.

More information to use as a Python package will be given in API references (to be written), and to use as a script can be found in their help:

$ susy-xs-get --help
Usage: susy-xs-get [OPTIONS] TABLE ARGS...

  Interpolate cross-section data using the standard scipy interpolator (with
  log-log axes).

Options:
  ...

License

The program codes included in this repository are licensed by Sho Iwamoto / Misho under MIT License.

Original cross-section data is distributed by other authors, including

References (original data)

Project details


Download files

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

Files for susy-cross-section, version 0.0.3
Filename, size File type Python version Upload date Hashes
Filename, size susy_cross_section-0.0.3-py2.py3-none-any.whl (529.4 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size susy_cross_section-0.0.3.tar.gz (167.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page