SModelS Database

SModelS stores all the information about the experimental results in the 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 overall structure of the directory hierarchy and its contents is depicted in the scheme below:

https://github.com/SModelS/smodels/blob/master/docs/manual/source/images/DatabaseFolders.png

The complete list of analyses and results included in the database can be consulted at http://smodels.hephy.at/wiki/ListOfAnalyses. We note that all the results in the official database release have been carefully validated and the validation material can be found at http://smodels.hephy.at/wiki/Validation.

Installation

The database can conveniently be updated independently from SModelS code updates. It suffices to download or clone this repository to a local folder and correctly set the SModelS database path when running SModelS. For more information check the SModelS online manual.

Adding FastLim data

The official SModelS database can be augmented with data from the fastlim database. A tarball with the properly converted fastlim-1.0 efficiency maps is provided and needs to be exploded in the top level directory of the database.

That is, the following steps need to be performed

cd <smodels-database folder>
tar -xzvf smodels-v1.1-fastlim-1.0.tgz
rm smodels-v1.1-fastlim-1.0.tgz

Once the fastlim folders have been added to the database, SModelS auto-detects fastlim results and issues an acknowledgement. When using these results, please properly cite the fastlim paper; for convenience, a bibtex file is provided in the smodels-fastlim tarball.

Adding one's own results

Adding additional experimental results is a matter of copying and editing text files. Once the new folders and files have been added following the database structure format, SModelS automatically rebuilds the binary (Pickle) database file. The added results will then be available for using with the the SModelS tools.

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

File	Mode	Size
13TeV
8TeV
README.rst	-rw-r--r--	2.4 KB
database.bib	-rw-r--r--	50.1 KB
version	-rw-r--r--	6 bytes

Added images to manual

README.rst