What's New
The major novelties of all releases since v1.0 are as follows:
- added
resummino cross section <xsecResummino>
computer- fixed bug in computation of error on muhat, for pyhf likelihoods (affects mostly the numpy backend)
- small change in initialisation of gradient descent method for computation of combined mu_hat, to increate robustness of method
- fixed bug in initialisation of
analyses combination <analysesCombination>
- smodels version now printed in all output formats
- fixed bug for reading
QNUMBERS blocks <qnumberSLHA>
from SLHA files- small fixes in how pythia6 and pythia8 are built
- small fix in truncated Gaussian llhd experimental feature
- small fix in computation of combined upper limits
- combinationmatrices are now forced to be symmetric
- added isCombinableWith method also for CombinedDataSets
- added a recipe for how to use a combinations matrix
- runtime.nCPUs() now returns number of available CPUs, not all CPUs
xsecComputer <xsecCalc>
now has --tempdir option- StatsComputer now has CLs method
- changed default prompt width from 1e-8 to 1e-11 GeV in code
- fixed bug for an LHE input only with anti-particles
- fixed error that truncated signal yields when computing expected upper limits
- added minMass parameter for setting a minimum mass threshold for BSM masses
- fixed C++ interface to work with python 3.11
- bumped up pythia8 from 8.307 to 8.308
- SModelS can now track inter-analyses combinability at the level of whole analyses as well as individual signal regions
- added support for
SLv2 <SLV2>
(Gaussian with a skew), arXiv:1809.05548- refactored the statistics modules
- introduced "full_llhds" database add-on (see
parameter.ini file <parameterFileDatabase>
)
database <Database>
extension, added new results from 6 ATLAS and 4 CMS analyses (hfm=HistFactory model, cov=covariance matrix for SR combination):
- results from ATLAS: ATLAS-SUSY-2018-05 (UL,EM+hfm), ATLAS-SUSY-2018-32 (EM+hfm), ATLAS-SUSY-2018-41 (EM+cov, updated), ATLAS-SUSY-2018-42 (UL,EM), ATLAS-SUSY-2019-02 (UL,EM+cov), ATLAS-SUSY-2013-12 (8TeV, EM)
- results from CMS: CMS-SUS-19-010 (UL), CMS-SUS-20-004 (UL,EM), CMS-SUS-21-002 (UL,EM+cov)
- added expected ULs to CMS-SUS-19-009
- fixes in
analyses combinations <analysesCombination>
, simplified and pyhflikelihoods <likelihoodCalc>
- small fixes for python 3.10
- bumped up pythia8 from 8.306 to 8.307
- included
example on how to plot likelihoods from analysis combination <Examples>
- small bug fix for particle addition
- removed dependency on importlib.metadata to make it work with python <= 3.7
- introduced (user-defined)
combinations of analyses <analysesCombination>
- changed expected limits computed with pyhf from post-fit to pre-fit
- a few smaller changes around expected likelihoods and limits
- changed default value of
promptWidth parameter <parameterFileModel>
from 1e-8 to 1e-11 GeV- allow
ncpus <parameterFileNcpus>
to take on zero and negative values in ini file [meaning use all but this (absolute) number of CPU cores]- notion of "nonaggregated" databases introduced
- small fixes in the
Howto's <Examples>
- updates in references.bib, installation notes
- more small fixes in unit tests
database <Database>
extension, added new results from 4 ATLAS and 11 CMS analyses:
- results from ATLAS: ATLAS-SUSY-2018-08 (UL+EM), ATLAS-SUSY-2018-40 (UL+EM), ATLAS-SUSY-2018-41 (UL+EM), ATLAS-SUSY-2019-09 (UL+EM, full likelihood)
- results from CMS: CMS-SUS-16-050 (EM), CMS-SUS-18-004 (UL), CMS-SUS-18-007 (UL), CMS-SUS-19-008 (UL), CMS-SUS-19-011 (UL), CMS-SUS-19-013 (UL), CMS-SUS-20-001 (UL), CMS-SUS-20-002 (UL)
- recast with MadAnalysis5: CMS-SUS-16-039 (EM), CMS-SUS-16-048 (EM), CMS-SUS-19-006 (EM); all incl. covariance matrices
- caching weight matrix in simplified
likelihoods <likelihoodCalc>
- notion of "debug" databases introduced
- introduced
reportAllSRs <parameterFileReportAllSRs>
option- tiny fix in mybinder link (see https://pypi.org/project/smodels/)
- small fixes in unit tests
- improved truncated Gaussians in likelihoodsFromLimits (but kept as experimental feature)
experimental features <parameterExperimentalFeatures>
can now be turned on via ini file
- Ability to merge
Databases <parameterFileDatabase>
using '+' as a delimiter: "latest_fastlim" and "official_fastlim" are now written as "latest+fastlim", and "official+fastlim".- useSuperseded flag in getExpResults is marked as deprecated, as we now just put superseded results in separate database
data sets<DataSet>
now have an .isCombinableWith function- Slightly extended output of
summary printer <parameterFileSummaryprinter>
- Added scan summary (
summary.txt <scanSummary>
) when running over multiple files- Added
expandedOutput <parameterFileSLHAprinter>
option to slha-printerOutput <outputDescription>
for efficiency-map results now reportsL, L_max and L_SM <likelihoodCalc>
- The
likelihood <likelihoodCalc>
is now maximized only for positive values of the signal strength in the computation of L_max- Pythia8 version in
xsecComputer <xsecCalc>
updated from 8226 to 8306- Improved
interactive plots <interactivePlots>
database <Database>
updated with results from 5 new ATLAS and 1 new CMS analyses:CMS-EXO-19-010 (disappearing tracks) UL, ATLAS-SUSY-2016-08 (displaced leptons) EM, ATLAS-SUSY-2018-10 (1l+jets) UL+EM, ATLAS-SUSY-2018-12 (0l+jets) UL+EM, ATLAS-SUSY-2018-22 (0l+jets) UL+EM, ATLAS-SUSY-2018-23 (EWino, WH) UL
- added EM results for
ATLAS-SUSY-2017-03 (EWino, WZ), ATLAS-SUSY-2018-06 (EWino, WZ), ATLAS-SUSY-2018-14 (sleptons), CMS-SUSY-14-021 (stops)
- created and added THSCPM10 and THSCPM11 EMs for ATLAS-SUSY-2016-32;
- replaced some 8 TeV ATLAS conf notes with the published results
(ATLAS-CONF-2013-007 -> ATLAS-SUSY-2013-09, ATLAS-CONF-2013-061 -> ATLAS-SUSY-2013-18, ATLAS-CONF-2013-089 -> ATLAS-SUSY-2013-20)
- corrected off-shell regions of some existing
EM-type results <EMtype>
(in three 13 TeV and eigth 8 TeV analyses).
- Introduction of
particle class <particleClass>
- Introduction of model class (see
Basic Input <basicInput>
)- Input model can now be defined by an SLHA file with
QNUMBERS blocks <qnumberSLHA>
- Unified treatment of SLHA and LHE input files (see
decomposer <decomp>
andLHE-reader <lhereader>
)Decomposition <decomposition>
andexperimental results<ExpResult>
can now handlelifetime dependent results <widthGrid>
- Added
field "type" <txnameFile>
to the experimental results in the database- Added (optional)
field "intermediateState" <txnameFile>
to the experimental results in the database- Inclusive branches can now describe inclusive vertices
- Added possibility for analysis specific detector size
- New
missing topologies <topCoverage>
algorithm and output- Added "latest" and "latest_fastlim"
Database <parameterFileDatabase>
abbreviations- Added support for central database server
- Small bug fix in
likelihood computation <likelihoodCalc>
- Small fix due to an API change in pyhf 0.6
- Changes in output:
width values added <pyOut>
,coverage groups <coverageGroups>
and others (seeoutput description <outputDescription>
for details)- Added option for signal strength multipliers in
cross section calculator <xsecCalc>
- Small bug fixes in
models <basicInput>
- added pyhf support
- pickle path bug fix
- bug fix for parallel xseccomputers
- Introduced the SMODELS_CACHEDIR environment variable to allow for a different location of the cached database file
- fixed dataId bug in datasets
database <Database>
updated with results from more than 20 new analyses- server for databases is now smodels.github.io, not smodels.hephy.at
- small bug fix for displaced topologies
- small fix in slha printer, r_expected was r_observed
Downloaded database files <parameterFilePath>
now stored in $HOME/.cache/smodels
- Updated official
database <Database>
, added T3GQ eff maps and a few ATLAS 13 TeV results, see github database release page- Database "official" now refers to a database without fastlim results, "official_fastlim", to the official database with fastlim
- List displaced signatures in
missing topologies <topCoverage>
- Improved description about lifetime reweighting in doc
- Fix in
cluster<ULcluster>
for asymmetric masses- Small improvements in the
interactive plots tool <interactivePlots>
- Fix in particleNames.py for non-MSSM models
- Fixed the marginalize recipe
- Fixed the T2bbWWoff 44 signal regions plots in ConfrontPredictions in manual
- Decomposition and experimental results can include non-MET BSM final states (e.g. heavy stable charged particles)
- Added lifetime reweighting at
decomposition <Decomposition>
for meta-stable particles- Added finalState property for Elements
- Introduction of
inclusive simplified models <inclusiveSMS>
- Inclusion of HSCP and R-hadron results in the database
- Support for
covariance matrices <combineSRs>
and combination of signal regions (seecombineSR <parameterFileCombineSRs>
inparameters file <parameterFile>
)- New plotting tool added to smodelsTools (see
Interactive Plots Maker <interactivePlots>
)- Path to particles.py can now be specified in parameters.ini file (see
model <parameterFileModel>
inparameters file <parameterFile>
)- Wildcards allowed when selecting analyses, datasets, txnames (see
analyses <parameterFileAnalyses>
,txnames <parameterFileTxnames>
anddataselector <parameterFileDataselector>
inparameters file <parameterFile>
)- Option to show individual contribution from topologies to total theory prediction (see
addTxWeights <parameterFileAddTxWeights>
inparameters file <parameterFile>
)- URLs are allowed as database paths (see
path <parameterFilePath>
inparameters file <parameterFile>
)- Python default changed from python2 to python3
- Fixed lastUpdate bug, now giving correct date
- Changes in pickling (e.g. subpickling, removing redundant zeroes)
- Added fixpermissions to smodelsTools.py, for system-wide installs (see
Files Permissions Fixer <permissionsFixer>
)- Fixed small issue with pair production of even particles
- Moved the
code documentation <CodeDocs>
to the manual- Added
option for installing <phenoInstallation>
within the source folder
- Database update only, the code is the same as v1.1.1
C++ Interface<Cpp>
- Support for pythia8 (see
Cross Section Calculator <xsecCalc>
)- improved binary database
- automated SLHA and LHE file detection
- Fix and improvements for missing topologies
- Added SLHA-type output
- Small improvements in interpolation and clustering
- the inclusion of efficiency maps (see
EM-type results <EMtype>
)- a new and more flexible database format (see
Database structure <databaseStruct>
)- inclusion of likelihood and χ2 calculation for
EM-type results <EMtype>
(seelikelihood calculation <likelihoodCalc>
)- extended information on the
topology coverage <topCoverage>
- inclusion of a database broswer tool for easy access to the information stored in the database (see
database browser <databaseBrowser>
)- the database now supports also a more efficient
binary format <databasePickle>
- performance improvement for the
decomposition <Decomposition>
of the input model- inclusion of new simplified results to the
database <Database>
(including a few 13 TeV results)Fastlim <addingFastlim>
efficiency maps can now also be used in SModelS