Database of Experimental AnalysesΒΆ

SModelS stores all the information about the experimental results in an analyses database [*]. The database is organized as files in an ordinary (UNIX) directory hierarchy, with a thin python layer serving as the access to the database.

The top level of the SModelS database categorizes the analyses by LHC center-of-mass energies, \(\sqrt{s}\):

  • 7TeV
  • 8TeV

Also, the top level directory contains a file called version with the version string of the database.

The second level splits the results up between the different experiments:

  • 8TeV/CMS/
  • 8TeV/ATLAS/

The third level of the directory hierarchy encodes the publications:

  • 8TeV/CMS/CMS-PAS-SUS-12-026
  • 8TeV/ATLAS/ATLAS-SUSY-2013-12
  • ...

For each publication, there are two files:

  • sms.py contains the experimental results for the cross-section upper limits as a function of the mass parameters, as python code. The code will fill a nested Dict dictionary with the upper limits. The dictionary keys are the corresponding Txnames for the analysis constraint (see Analyses Names).
  • info.txt contains all the meta information around the publication. Here is the content of CMS-SUS-13-006 as an example:
sqrts: 8.0*TeV
lumi: 19.5/fb
id: CMS-SUS-13-006
url: https://twiki.cern.ch/twiki/bin/view/CMSPublic/PhysicsResultsSUS13006
arxiv: http://arxiv.org/abs/1405.7570
publication: http://link.springer.com/article/10.1140%2Fepjc%2Fs10052-014-3036-7
supersedes: CMS-PAS-SUS-12-022
digitaldata: True

In particular, it defines the center-of-mass energy \(\sqrt{s}\) (in TeV) and the integrated luminosity, \(\mathrm{fb}^{-1}\). Optionally, units (e.g. “* TeV” or “/ fb”) can be added to the number.

The next block:

constraint: TChiWZ -> [[['W']],[['Z']]]
constraint: TSlepSlep -> [[['e+']],[['e-']]]+[[['mu+']],[['mu-']]]
fuzzycondition: TChiWZ -> None
fuzzycondition: TSlepSlep -> Cgtr([[['mu+']],[['mu-']]],[[['e+']],[['e-']]])

holds the constraint and conditions, as described in constraint, and conditions, respectively.

Finally,

axes: TChiWZ: M1 M0, TSlepSlep: M1 M0, TChiChipmSlepL: M1 M0 050 -  M1 M0 005 - M1 M0 095, TChiChipmSlepStau:  M1 M0 050 - M1 M0 005 - M1 M0 095,TChiWZoff: M1 M0, TChiWH: M1 M0

describes the mass planes and how for analyses with intermediate masses, the two-dimensional histograms map onto the three-dimensional SMS parameter space.

[*]Currently only cross section upper limits are included (see UL Analyses).

Previous topic

Theory Predictions

Next topic

SModelS Tools

This Page