= !MadAnalysis 5 physics analysis database =

This page contains a collection of LHC analyses that have been implemented in the !MadAnalysis 5 framework (in the expert mode) described in [http://arxiv.org/abs/1405.3982 arXiv:1405.3982 [hep-ph]]. For each analysis, a commented C++ code is available for download, provided together with information on the analysis and references to relevant publications. A careful validation of each implementation is also provided. 

In order to use these files, you need !MadAnalysis 5 version 1.1.11 or higher, as well as our modified version of Delphes, which can be installed with the command 
{{{
 install delphesMA5tune
}}}
within !MadAnalysis 5. If you have an older version of !MadAnalysis 5, first update it to the latest one. 

You then need to create a working directory by starting !MadAnalysis 5 as
{{{
 ./bin/ma5 -E -R
}}}
and follow the instructions displayed to the screen. So far, there is no automatic installation in the form of an analysis library. Instead, analyses have to be added by hand.  This is done by running the script newAnalyzer.py (located in !Build/SampleAnalyzer), passing as an argument the name of the analysis of interest. For instance,
{{{
 python newAnalyzer.py cms_sus_13_011
}}}
will create and modify all necessary files for adding the analysis named cms_sus_13_011. In particular, a pair of header and source C++ files cms_sus_13_011.cpp and cms_sus_13_011.h are now available in the subdirectory !Build/SampleAnalyzer/User/Analyzer. These files must be replaced by those available for download in the database (see list below). A more convenient library mode to install several analyses at once is in preparation.

After execution of an analysis, exclusion under the CLs prescription can be computed with the Python code [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/exclusion_CLs.py exclusion_CLs.py] It requires [http://www.scipy.org/ SciPy] to be installed.
The path to the working directory of interest has to be provided in the variable analysis_path in the beginning of the code. The limit-setting code can also be obtained with the command
{{{
 install RecastingTools
}}}
within !MadAnalysis 5. This will create a local copy of [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/exclusion_CLs.py exclusion_CLs.py] in every new working directory.
In both cases, the code should be called as
{{{
 ./exclusion_CLs.py analysis_name mypoint.txt [run_number] [cross section in pb]
}}}
The exclusion results will be printed on the screen and in an output file located in the directory mypoint.txt/ of the output of the analysis.

''We strongly encourage users to publish their re-implemented LHC analyses via Inspire.'' This way they not only become part of the public database, rendering them as useful as possible to the community, but they also become individually searchable and citable. 

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 [https://launchpad.net/madanalysis5 launchpad page].

== Available Analyses ==

**'' !! please properly cite all the re-implementation codes you are using (see Inspire citation entry) !! **''

=== ATLAS analyses, 8 TeV ===
|| '''Analysis''' || ''' Short Description''' || '''Implemented by''' || '''Code''' || '''Validation note''' || '''Status''' ||
|| [https://atlas.web.cern.ch/Atlas/GROUPS/PHYSICS/PAPERS/SUSY-2013-05/ ATLAS-SUSY-2013-05] (published) || stop/sbottom search: 0 leptons + 2 b-jets || G. Chalons || [https://inspirehep.net/record/1302493/ Inspire] ||[http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/ma5_validation_ATLAS-SUSY-13-05.pdf PDF] [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/plots.tgz (figures)]|| done ||
|| [https://atlas.web.cern.ch/Atlas/GROUPS/PHYSICS/PAPERS/SUSY-2013-11/ ATLAS-SUSY-2013-11] (published) || EWK-inos, 2 leptons + MET || B. Dumont || [http://inspirehep.net/record/1304590/ Inspire] || [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/ma5_validation_ATLAS-SUSY-2013-11.pdf PDF] [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/ma5_validation_ATLAS-SUSY-13-11.tar.gz (source)] || done ||

[http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/delphesMA5tune_card_ATLAS_05.tcl Delphes card] for ATLAS-SUSY-2013-05 [[BR]]
[http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/delphesMA5tune_card_ATLAS_dileptonSUSY.tcl Delphes card] for ATLAS-SUSY-2013-11

=== CMS analyses, 8 TeV ===

|| '''Analysis''' || ''' Short Description''' || '''Implemented by''' || '''Code''' || '''Validation note''' || '''Status''' ||
|| [https://twiki.cern.ch/twiki/bin/view/CMSPublic/PhysicsResultsSUS13011 CMS-SUS-13-011] (published) || stop search in the single lepton mode || B. Dumont, B. Fuks, C.  Wymant || [http://inspirehep.net/record/1301484/ Inspire] [1] [[BR]] || [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/ma5_validation_CMS-SUS-13-011.pdf PDF] [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/ma5_validation_CMS-SUS-13-011.tar.gz (source)] ||  done ||
|| [https://twiki.cern.ch/twiki/bin/view/CMSPublic/PhysicsResultsSUS13012 CMS-SUS-13-012] (published) || gluino/squark search in jet multiplicity and missing energy || S. Bein, D. Sengupta ||  [http://inspirehep.net/record/1305458/ Inspire] [[BR]] || [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/ma5_validation_CMS-SUS-13-012.pdf PDF] [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/cms_sus_13_012.tar.gz (source)] || done ||
|| [https://twiki.cern.ch/twiki/bin/view/CMSPublic/PhysicsResultsSUS13016 CMS-SUS-13-016]  (PAS) || search for gluinos using OS dileptons and b-jets || D. Sengupta, S. Kulkarni || [http://inspirehep.net/record/1305194 Inspire] || [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/ma5_validation_CMS-SUS-13-016.pdf PDF]​ [http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/cms_sus_13_016.tar.gz (source)] || done ||

[http://madanalysis.irmp.ucl.ac.be/attachment/wiki/PhysicsAnalysisDatabase/delphesMA5tune_card_CMS_SUSY.tcl Delphes card] for these analyses

[1] This analysis requires MINUIT libraries. Therefore, the line
{{{
 LIBFLAGS += -lMinuit
}}}
should be added to the Makefile of the Build/ directory before compilation.