Skip to content

Latest commit

 

History

History
367 lines (262 loc) · 16.9 KB

OutputDescription.rst

File metadata and controls

367 lines (262 loc) · 16.9 KB
Raw

Output Description

Output Description

A detailed description of the possible output formats generated by running SModelS <runningSModelS> and their content is given below. For simplicity we will assume that all printer options in the parameters file <parameterFile> are set to True, so the output information is maximal1.

Screen (Stdout) Output

The stdout (or log output <logOut>) is intended to provide extensive information about the database <Database>, the decomposition <Decomposition>, the theory predictions <TheoryPredictions> and the missing topologies <topCoverage>. It is most convenient if the input is a single file and not a folder, since the output is quite extensive. If all the options in stdout-printer are set to True (see parameters file <parameterFile>), the screen output contains the following information:

  • information about the basic input parameters and the status of the run:

/images/gluino_squarks.slha.log

  • a list of all the experimental results<ExpResult> considered (if printDatabase = True). Note that this list corresponds to all the results selected in the database options (see parameters file <parameterFile>). If addAnaInfo = True, for each experimental result<ExpResult> entry a list of all the simplified models (or elements <element>) constrained by the analysis is also shown using the bracket notation <bracketNotation>:

/images/gluino_squarks.slha.log

  • a full list of the topologies <topology> generated by the decomposition <Decomposition> (if printDecomp = True). Each topology <topology> entry contains basic information about the topology <topology> as well as the number of elements <element> with this topology <topology> and the sum over all the elements <element> weights. If addElementInfo = True, the elements <element> belonging to each topology <topology> are also explicitly shown, as well as the element <element>'s mass, final states <final states>, weight, the PIDs of the intermediate particles <odd states> contributing to the element <element> and the element ID:

/images/gluino_squarks.slha.log

  • a list of all the theory predictions <TheoryPredictions> obtained and the corresponding experimental result<ExpResult> upper limit. For each experimental result<ExpResult>, the corresponding id, signal region (data set<DataSet>) and sqrts as well as the constrained simplified models (txnames <TxName>) are printed. After this basic information, the signal cross section (theory prediction <TheoryPredictions>), the list of condition values <ULconditions> (if applicable) and the corresponding observed upper limit are shown. Also, if available, the expected upper limit is included. If computeStatistics = True, the χ2 and likelihood values are printed (see likelihood calculation <likelihoodCalc>). Finally, if printExtendedResults = True, basic information about the elements <element> being constrained, such as their masses, IDs and PIDs, is also shown.

/images/gluino_squarks.slha.log

  • summary information about the missing topologies <topCoverage>, if testCoverage = True. The total missing topology cross section corresponds to the sum of cross sections of all elements <element> which are not tested by any experimental result<ExpResult>. If, however, the element <element> is constrained by one or more experimental results<ExpResult>, but its mass is outside the efficiency or upper limit grids (see EM-type results <EMtype> and UL-type results <ULtype>), its cross section is included in the total cross section outside the grid. Finally, the elements <element> which contribute to the total missing topology cross section are subdivided into elements <element> with long decays or with asymmetric branches (see coverage tool <topCoverage> for more details)

/images/gluino_squarks.slha.log

  • detailed information about the missing topologies with highest cross sections. The element <element> cross section (weight) as well as its description in bracket notation <bracketNotation> is included. If addCoverageID = True, all the elements <element> IDs contributing to the missing topology are shown. These IDs can be traced back to the corresponding elements <element> using the decomposition <Decomposition> information obtained with printDecomp = True and addElementInfo = True.

/images/gluino_squarks.slha.log

  • detailed information about the topologies which are outside the experimental results<ExpResult> grid. If addCoverageID = True, all the elements <element> IDs contributing to the missing topology are shown.

/images/gluino_squarks.slha.log

  • information about the missing topologies with long cascade decays. The long cascade decays are classified by the initially produced mother particles. If more than one pair of mothers are contributing to the same class of elements, the full list is given in the comment. For definiteness all lists are sorted. If addCoverageID = True, all the elements <element> IDs contributing to the missing topology are shown.

/images/gluino_squarks.slha.log

  • information about the missing topologies with asymmetric decays. The asymmetric branch decays are classified by the initially produced mother particles. If more than one pair of mothers are contributing to the same class of elements, the full list is given in the comment. For definiteness all lists are sorted. If addCoverageID = True, all the elements <element> IDs contributing to the missing topology are shown.

/images/gluino_squarks.slha.log

Log Output

The log-type output is identical to the screen output <screenOut>, except that it is redirected to a .log file. The filename is set as the <input file>.log and stored in the output folder (see the runSModelS options <runSModelS>).

Summary File Output

The summary-type output is similar to the screen output <screenOut>, but restricted to the list of theory predictions <TheoryPredictions> and model coverage <topCoverage>. The output is printed to the file <input file>.smodels and stored in the output folder (see the runSModelS options <runSModelS>).

Below we describe in detail the blocks contained in the summary output:

  • information about the basic input parameters and the status of the run:

/images/gluino_squarks.slha.smodels

  • a list of all the theory predictions <TheoryPredictions> obtained and the corresponding experimental result<ExpResult> upper limit. If expandedSummary = False only the most constraining experimental result<ExpResult> is printed. For each theory prediction <TheoryPredictions> entry, the corresponding experimental result<ExpResult> id, the signal region (data set<DataSet>) used (only for EM-type results <EMtype>) and the experimental result<ExpResult> sqrts is printed. Furthermore, the txnames <TxName> contributing to the signal cross section, the theory cross section (Theory_Value), the observed upper limit (Exp_limit), the (theory cross section)/(observed upper limit) ratio (r) and, when available, the (theory cross section)/(expected upper limit) ratio (r_expect) are also printed. For UL-type results <ULtype> the condition violation (see upper limit conditions <ULconditions>) is also included. Finally, if computeStatistics = True, the χ2 and likelihood values (for EM-type results <EMtype>) are printed:

/images/gluino_squarks.slha.smodels

  • the maximum value for the (theory cross section)/(observed upper limit) ratio. If this value is higher than 1 the input model is likely excluded by one of the experimental results<ExpResult> (see confronting predictions <confrontPredictions>)

/images/gluino_squarks.slha.smodels

  • summary information about the missing topologies <topCoverage>, if testCoverage = True. The total missing topology cross section corresponds to the sum of all elements <element> cross sections which are not tested by any experimental result<ExpResult>. If, however, the element <element> is constrained by one or more experimental results<ExpResult>, but its mass is outside the efficiency or upper limit grids (see EM-type results <EMtype> and UL-type results <ULtype>), its cross section is included in the total cross section outside the grid. Finally, the elements <element> which contribute to the total missing topology cross section are subdivided into elements <element> with long decays or with asymmetric branches (see coverage tool <topCoverage> for more details)

/images/gluino_squarks.slha.smodels

  • detailed information about the missing topologies with highest cross sections. The element <element> cross section (weight) as well as its description in bracket notation <bracketNotation> is included.

/images/gluino_squarks.slha.smodels

  • detailed information about the topologies which are outside the experimental results<ExpResult> grid:

/images/gluino_squarks.slha.smodels

  • information about the missing topologies with long cascade decays:

/images/gluino_squarks.slha.smodels

  • information about the missing topologies with asymmetric decays:

/images/gluino_squarks.slha.smodels

Python Output

The Python-type output is similar to the screen output <screenOut>, however converted to a Python dictionary. If all options are set to True, it includes information about the decomposition <Decomposition>, the list of theory predictions <TheoryPredictions> and model coverage <topCoverage>. The output is printed to the file <input file>.py and stored in the output folder (see the runSModelS options <runSModelS>).

Below we describe in detail the dictionary keys and values contained in the Python dictionary output:

  • information about the basic input parameters and the status of the run stored under the OutputStatus key:

/images/gluino_squarks.slha.py

  • a full list of the elements <element> generated by the decomposition <Decomposition> (if addElementList = True) stored under the Element key. Each list entry contains basic information about the elements <element>. The list can be considerably long, so it is recommended to set addElementList to False, unless the decomposition <Decomposition> information is required by the user.

/images/gluino_squarks.slha.py

  • a list of all the theory predictions <TheoryPredictions> obtained for the experimental results<ExpResult>, stored under the ExptRes key. For each list entry, the corresponding result id, the experimental result<ExpResult> type (if UL-type result <ULtype> or EM-type result <EMtype>), the signal region (data set<DataSet> ID), the sqrts and luminosity, the constrained simplified models (txnames <TxName>), the signal cross section (theory prediction), the corresponding observed upper limit and the maximum condition violation (see upper limit conditions <ULconditions>) are shown. Furthermore, the masses of the elements <element> contributing to the signal cross section and the χ2 and likelihood values (if computeStatistics = True) are also included.

/images/gluino_squarks.slha.py

  • a list of missing topologies (if testCoverage = True), stored under the Missed Topologies key. For each list entry, the element <element> cross section (weight), the element <element> IDs contributing to the topology and the element <element> description in bracket notation <bracketNotation> is included.

/images/gluino_squarks.slha.py

  • a list of topologies which are outside the experimental results<ExpResult> grid (if testCoverage = True), stored under the Outside Grid key. For each list entry, the element <element> cross section (weight) and the element <element> description in bracket notation <bracketNotation> is included.

/images/gluino_squarks.slha.py

  • a list of topologies with long cascade decays (if testCoverage = True), stored under the Long Cascades key. For each list entry, the element <element> cross section (weight) and the PIDs of the mothers are included. The mother PIDs are given in a nested list, as more than one pair might contribute to the same class of elements <element>.

/images/gluino_squarks.slha.py

  • a list of topologies with asymmetric branch decays (if testCoverage = True), stored under the Asymmetric Branches key. For each list entry, the element <element> cross section (weight) and the PIDs of the mothers are included. The mother PIDs are given in a nested list, as more than one pair might contribute to the same class of elements <element>.

/images/gluino_squarks.slha.py

XML Output

The xml-type output is identical to the python output <pyOut>, however converted to a xml format. The output is printed to the file <input file>.xml and stored in the output folder (see the runSModelS options <runSModelS>).

Since the output information and options are the same as described for python output <pyOut>, we simply show below an excerpt of the xml file to illustrate the output format:

/images/gluino_squarks.slha.xml

SLHA Output

An SLHA-type output format is also available containing a summary of the theory predictions <TheoryPredictions> and missing topologies <topCoverage>. The file contains the SLHA-type blocks: SModelS_Settings, SModelS_Exclusion, SModelS_Missing_Topos, SModelS_Outside_Grid, SModelS_Long_Cascade and SModelS_Asymmetric_Branches. Below we give a description of each block together with a sample output.

  • information about the main input parameters:

/images/gluino_squarks.slha.smodelsslha

  • information about the status of the input model: excluded (1), not excluded (0) or not tested (-1):

/images/gluino_squarks.slha.smodelsslha

  • followed by the list of experimental results. If the model is excluded, all results with r-value greater than one are shown. If the point is not excluded, only the result with the highest r-value is displayed. For each experimental result, the Txname <TxName>, the r-value, the condition violation <ULconditions> and the experimental result ID are shown. If computeStatistics = True, the χ2 and likelihood values for EM-type results <EMtype> are also printed:

/images/gluino_squarks.slha.smodelsslha

  • a list of missing topologies (up to 10) and their weights (if testCoverage = True):

/images/gluino_squarks.slha.smodelsslha

  • a list of topologies which are outside the experimental results<ExpResult> grid (if testCoverage = True):

/images/gluino_squarks.slha.smodelsslha

  • a list of topologies with long cascade decays (if testCoverage = True):

/images/gluino_squarks.slha.smodelsslha

  • a list of topologies with asymmetric branch decays (if testCoverage = True):

/images/gluino_squarks.slha.smodelsslha

  1. Some of the output may change depending on the database version used.↩