wiki:PublicAnalysisDatabase

Version 255 (modified by jackaraz, 4 years ago) ( diff )

--

MadAnalysis 5 Public Analysis Database (PAD) for recasting LHC results

WANTED: Analysis code

Scientific reproducibility and data preservation solely depend on preserving analysis logic in a reinterpretable form. You can contribute to the HEP community by sharing the LHC recast you have implemented in the MadAnalysis framework, through Public Analysis Database! Please send us your analysis code, detector card, info file and validation note to be included in PAD for public use.

More information and examples can be found in the proceedings of the second MadAnalysis 5 Workshop on LHC recasting in Korea . Analysis codes have been published, documented and got a DOI so that they can now be cited.

This page contains a collection of LHC analyses that have been implemented in the MadAnalysis 5 framework (in the expert mode) described in arXiv:1405.3982 and arXiv:1407.3278. Extensive step-by-step lecture notes can be found in arXiv:1808.00480, and documentation on the treatment of the theoretical uncertainties and high-luminosity extrapolations within the PAD can be found in arXiv:1910.11418.

The simulation of the response of the ATLAS and CMS detector can either be handled by Delphes 3, or through the new built-in SFS fast simulation relying on smearing and efficiency functions documented in arXiv:2006.09387 or here.

For each analysis, a commented C++ code is available for download, provided together with information on the analysis and references to relevant publications. Documentation on the careful validation associated with each implementation is also available.


The current version of MadAnalysis 5 is version 1.8. One of the analyses below however requires a newer version, v1.9.4 (or more recent) that can be obtained from LaunchPad.

In order to use the analyses implemented in the PAD, one needs to install a detector simulator and the corresponding library of recast analyses. Three options are available.

  • The simulation of the detector response can be dealt with Delphes 3. The PAD installation can be achieved by typing install delphes; install PAD in the MadAnalysis 5 shell, and by then restarting the program. This setup concerns most run 2 analyses currently implemented.
  • The simulation of the detector response can be dealt with the SFS infrastructure relying on smearing and efficiency functions. The PAD installation can here be achieved by typing install fastjet; install PADForSFS in the MadAnalysis 5 shell, and by then restarting the program. For now, this alternative to Delphes 3 is rather new and only few analyses use it.
  • The simulation of the detector response can be dealt with the MA5tune of Delphes 3 that is relevant for a good number of run 1 analyses. The PAD installation can be achieved by typing install delphesMA5tune; install PADForMA5tune in the MadAnalysis 5 shell, and by then restarting the program.

Although we have various options for taking care of the detector simulation (SFS, Delphes and DelphesMA5tune), we recommend, when developing a new recasting code, to use the latest MA5 version linked to either the SFS framework, or the standard Delphes 3. The implementation of a new analysis is detailed in arXiv:1808.00480, as well as here for what concerns the SFS. In a nutshell, new analyses (within the PAD or separately) can be added by running the script newAnalyzer.py (located in PAD/Build/SampleAnalyzer), passing as an argument the name of the analysis of interest. For instance,

 python newAnalyzer.py cms_sus_14_001 cms_sus_14_001

will create and modify the necessary files for adding the analysis named cms_sus_14_001. In particular, a pair of header and source C++ files cms_sus_14_001.cpp and cms_sus_14_001.h is now available in the sub-directory PAD/Build/SampleAnalyzer/User/Analyzer. We can now either implement the analysis on our own, or replace the newly created files with those shared by somebody else (or downloaded from the list below in case the automatic PAD installation introduced above is not used).

We strongly encourage users to publish their re-implemented LHC analyses on the MadAnalysis 5 dataverse. This way they become individually citable. Please send us an email to get your recast code added to the dataverse and to the PAD. Recommendations regarding the proper validation are given in arXiv:1407.3278 and arXiv:1808.00480. Note that for every analysis that is part of the PAD, a detailed validation note is required.

For any information on the implementation of an analysis, on the database or on the expert mode of the program, please visit the 'Answers' section of our LaunchPad page.


In order to test a new physics signal (corresponding to a Monte Carlo sample mysample.hep.gz or mysample.hepmc.gz), it is sufficient to start MadAnalysis 5 in the reco mode (./bin/ma5 -R) and type

    set main.recast = on
    set main.recast.store_root = False
    import <path-to-the-event-sample>
    submit

The interpreter then asks to edit the recasting card where one can tick/un-tick the analyses that need to be recast. One can also use the command

    set main.recast.card_path = <path-to-a-recasting-card>

to provide the recasting card directly. The output directory contains event samples after detector simulation if the store_root option has been set to True, as well as exclusions (1-CLs) and efficiency information for each signal region of each of the selected analyses. The cross section excluded at the 95% CL for each region is also provided as additional information.


Available Analyses

!! please properly cite all the re-implementation codes you are using; here are a PAD BibTeX file and a PADForMA5tune BibTex file for this purpose !!

ATLAS analyses, 13 TeV

Analysis Short Description Implemented by Code Validation note Version
ATLAS-SUSY-2015-06 Multijet + missing transverse momentum (3.2 fb-1) S. Banerjee, B. Fuks, B. Zaldivar Inspire PDF v1.3/Delphes3
ATLAS-SUSY-2016-07 Multijet + missing transverse momentum (36.1 fb-1) G. Chalons, H. Reyes-Gonzalez
J.Y. Araz
Inspire
MA5 dataverse
PDF Pythia files
Sec. 5.2 in 2006.09387
v1.7/Delphes3
v1.8/SFS
ATLAS-SUSY-2018-04 Staus in the ditau + met channel (139 fb-1) J. Lim, C.-T. Lu, J.-H. Park, J. Park MA5 dataverse PDF v1.8/Delphes3
ATLAS-SUSY-2018-06 Electroweakinos with Jigsaw variables (139 fb-1) J.H. Kim, T.G. Lee, J.W. Kim, H. Jang MA5 dataverse PDF v1.8/Delphes3
ATLAS-SUSY-2018-31 Sbottoms in the multibottom (including Higgs decays) + met channel (139 fb-1) J.Y. Araz, B. Fuks MA5 dataverse PDF v1.9/SFS
ATLAS-SUSY-2018-32 Electroweakinos/sleptons in the 2l + met channel (139 fb-1) J.Y. Araz, B. Fuks MA5 dataverse PDF v1.8/Delphes3
ATLAS-SUSY-2019-08 H (into b bbar) + 1 lepton + missing transverse momentum (139 fb-1) M. Goodsell MA5 dataverse PDF v1.8/Delphes3
ATLAS-EXOT-2015-03 Monojet (3.2 fb-1) D. Sengupta Inspire PDF v1.3/Delphes3
ATLAS-EXOT-2016-25 Mono-Higgs (36.1 fb-1) S. Jeon, Y. Kang, G. Lee, C. Yu Inspire PDF v1.6/Delphes3
ATLAS-EXOT-2016-27 Monojet (36.2 fb-1) D. Sengupta Inspire PDF v1.6/Delphes3
ATLAS-EXOT-2016-32 Monophoton (36.1 fb-1) S. Baek, T.H. Jung Inspire PDF v1.6/Delphes3
ATLAS-EXOT-2018-30 W' into lepton+neutrino (139 fb-1) K. Park, S. Lee, W. Jun, U. Min MA5 dataverse PDF v1.8/Delphes3
ATLAS-CONF-2016-086 b-pair + missing transverse momentum (13.3 fb-1) B. Fuks & M. Zumbihl Inspire PDF v1.6/Delphes3
ATLAS-CONF-2019-040 Jets + missing transverse momentum (139 fb-1) F. Ambrogi
J.Y. Araz
Inspire
MA5 dataverse
PDF
TBA
v1.8/Delphes3
v1.8/SFS

ATLAS Delphes 3 parametrisation cards for CONF-2016-086, EXOT-2015-03, SUSY-2015-06, SUSY-2016-07 and CONF-2019-040, EXOT-2016-25, EXOT-2016-27, EXOT-2016-32, EXOT-2018-30, SUSY-2018-04, SUSY-2018-06, SUSY-2018-32 and SUSY-2019-08.
The SFS detector parametrisations can be obtained from the MA5 dataverse links, together with the corresponding analysis codes.

CMS analyses, 13 TeV

Analysis Short Description Implemented by Code Validation note Version
CMS-SUS-16-033 Supersymmetry in the multijet plus missing energy channel (35.9 fb-1) F. Ambrogi and J. Sonneveld Inspire PDF v1.7/Delphes3
CMS-SUS-16-039 Electroweakinos in the SS2L, 3L and 4L channels (35.9 fb-1) B. Fuks and S. Mondal Inspire PDF v1.7/Delphes3
CMS-SUS-16-048 Compressed electroweakinos with soft leptons (35.9 fb-1) B. Fuks
J.Y. Araz
MA5 dataverse
MA5 dataverse
Sec. 19 in 2002.12220
Sec. 5.3 in 2006.09387
v1.8/Delphes3
v1.8/SFS
CMS-SUS-16-052 SUSY in the 1l + jets channel (36 fb-1) D. Sengupta Inspire PDF v1.6/Delphes3
CMS-SUS-17-001 Stops in the OS dilepton mode (35.9 fb-1) S.-M. Choi, S. Jeong, D.-W. Kang et al. Inspire PDF v1.6/Delphes3
CMS-SUS-19-006 SUSY in the HT/missing HT channel (137 fb-1) M. Mrowietz, S. Bein, J. Sonneveld MA5 dataverse PDF v1.8/Delphes3
CMS-EXO-16-010 Mono-Z-boson (2.3 fb-1) B. Fuks Inspire PDF v1.6/Delphes3
CMS-EXO-16-012 Mono-Higgs (2.3 fb-1) S. Ahn, J. Park, W. Zhang Inspire PDF v1.6/Delphes3
CMS-EXO-16-022 Long-lived leptons (2.6 fb-1) J. Chang Inspire PDF v1.7/Delphes3
CMS-EXO-17-015 Leptoquarks + dark matter in the 1mu+1jet+met channel (77.4 fb-1) A. Jueid and B. Fuks MA5 dataverse PDF v1.8/Delphes3
CMS-EXO-17-030 Pairs of trijet resonances (35.9 fb-1) Y. Kang, J. Kim, J. Choi, S. Yun MA5 dataverse PDF v1.8/Delphes3
CMS-HIG-18-011 Exotic Higgs decay in the 2 muons + 2 b-jet channel via 2 pseudoscalars (35.9 fb-1) J.B. Lee and J. Lee MA5 dataverse PDF v1.8/Delphes3
CMS-TOP-17-009 SM four-top analysis (35.9 fb-1) L. Darmé and B. Fuks Inspire PDF v1.7/Delphes3
CMS-TOP-18-003 SM four-top analysis (137 fb-1) L. Darmé and B. Fuks MA5 dataverse PDF v1.8/Delphes3

CMS Delphes 3 parametrisation cards for EXO-16-010 and SUS-17-001, EXO-16-012, EXO-16-022, EXO-17-015, EXO-17-030, SUS-16-039, SUS-16-041, SUS-16-052, SUS-19-006, HIG-18-011, TOP-17-009 and TOP-18-003.
The SFS detector parametrisations can be obtained from the MA5 dataverse links, together with the corresponding analysis codes.


ATLAS analyses, 8 TeV

Analysis Short Description Implemented by Code Validation note Version
ATLAS-SUSY-2013-05 (published) stop/sbottom search: 0 leptons + 2 b-jets G. Chalons Inspire PDF (figures) MA5tune
ATLAS-SUSY-2013-11 (published) EWK-inos, 2 leptons + MET B. Dumont Inspire PDF (source) MA5tune
ATLAS-HIGG-2013-03 (published) ZH->ll+invisible B. Dumont Inspire PDF (source) MA5tune
ATLAS-EXOT-2014-06 (published) mono-photons + MET D. Barducci MA5tune v1.2/Delphes3 PDF MadGraph cards MA5tune + v1.2/Delphes3
ATLAS-SUSY-2014-10 (published) 2 leptons + jets + MET B. Dumont Inspire PDF (source) MA5tune
ATLAS-SUSY-2013-21 (published) 0 leptons + mono-jet/c-jets + MET G. Chalons, D. Sengupta Inspire PDF (source) MA5tune
ATLAS-SUSY-2013-02 (published) 0 leptons + 2-6 jets + MET G. Chalons, D. Sengupta Inspire PDF MA5tune
ATLAS-SUSY-2013-04 (published) 0 leptons + >6 jets + MET B. Fuks, M. Blanke, I. Galon Inspire PDF MA5tune

Delphes card for ATLAS-SUSY-2013-05, ATLAS-SUSY-2013-21 and ​ATLAS-EXOT-2014-06
Delphes card for ATLAS-SUSY-2013-11, ATLAS-SUSY-2013-02 and ATLAS-HIGG-2013-03
Delphes card for ATLAS-SUSY-2013-04
Delphes card for ATLAS-SUSY-2014-10

CMS analyses, 8 TeV

Analysis Short Description Implemented by Code Validation note Version
CMS-SUS-13-011 (published) stop search in the single lepton mode B. Dumont, B. Fuks, C. Wymant Inspire [1]
PDF (source) MA5tune
CMS-SUS-13-012 (published) gluino/squark search in jet multiplicity and missing energy S. Bein, D. Sengupta Inspire
PDF (source) MA5tune
CMS-SUS-13-016 (PAS) search for gluinos using OS dileptons and b-jets D. Sengupta, S. Kulkarni Inspire PDF(source) MA5tune
CMS-SUS-14-001 (published) Third-generation squarks in fully hadronic final states (monojet analysis) S. Sharma, S. Pandey Inspire PDF MA5tune
CMS-SUS-14-001 (published) Third-generation squarks in fully hadronic final states (top-tag analysis) S. Bein, P. Atmasiddha, S. Sharma Inspire PDF MA5tune
CMS-B2G-12-012 (published) T5/3 top partners in same-sign dilepton channel D. Barducci, C. Delaunay Inspire PDF (source), cards v1.2/Delphes3
CMS-B2G-12-022 (published) Monotops J. Guo, E. Conte, B. Fuks Inspire arXiv v1.2/Delphes3
CMS-B2G-14-004 (published) Dark matter with top quark pairs (single lepton) B. Fuks and A. Martini Inspire PDF MadGraph cards v1.2/Delphes3
CMS-EXO-12-047 (published) Monophoton J. Guo, E. Conte, B. Fuks Inspire PDF Pythia script v1.2/Delphes3
CMS-EXO-12-048 (published) Monojet J. Guo, E. Conte, B. Fuks Inspire PDF MadGraph cards v1.2/Delphes3

Delphes card for CMS-SUS-13-011, CMS-SUS-13-012, CMS-SUS-13-016 and CMS-SUS-14-001 (monojet)
Delphes card for CMS-SUS-14-001 (top-tag)
Delphes card for the CMS-EXO-12-047, CMS-EXO-12-048 and CMS-B2G-12-012 MA5tune (v1.2) analyses
Delphes card for the CMS-B2G-14-004 and CMS-B2G-12-022 MA5tune (v1.2) analyses

[1] This analysis requires MINUIT libraries.

Attachments (99)

Note: See TracWiki for help on using the wiki.