== !MadAnalysis 5 - A package for event file analysis and recasting of LHC results==

{{{
#!html
<div style="background: rgb(0,77,128); padding: 20px 20px; max-width: 425px; margin-left: 20px ; margin-right: 30px; margin-bottom: 20px; float: right;  border-radius: 20px; box-shadow: 5px 5px 10px black;">
  <div style="border: 2px solid rgb(254,174,0); border-radius: 20px; padding: 40px; color: rgb(255,255,255);">
    <h1 style="display: block; text-align: center; margin: 0; font-size: 25px;"><span style="color: rgb(184,44,44);">WANTED:</span> Analysis codes</h1>
    <p style="font-size: 13px; line-height:1.4; text-align: justify;">
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 5 framework, through <a href="http://madanalysis.irmp.ucl.ac.be/wiki/PublicAnalysisDatabase"; style="color:white; font-weight:bold">Public Analysis Database (PAD)</a>! Please send us your analysis code, detector card, info file and validation note to be included in <a href="http://madanalysis.irmp.ucl.ac.be/wiki/PublicAnalysisDatabase"; style="color:white; font-weight:bold">PAD</a> for public use.
</p>
<p style="font-size: 13px; line-height:1.4; text-align: justify; text-indent:20px;">
More information and examples can be found in the proceedings of <a href="https://doi.org/10.1142/S0217732321020016"; style="color:white; font-weight:bold">the second MadAnalysis 5 Workshop on LHC recasting in Korea</a>. Analysis codes have been published, documented and got a DOI so that they can now be cited.
</p>
  </div>
</div>
}}}

!MadAnalysis is a new framework for phenomenological investigations at particle colliders. Based on a C++ kernel, this program allows to efficiently perform, in a straightforward and user-friendly fashion, sophisticated physics analyses of event files such as those generated a large class of Monte Carlo event generators. !MadAnalysis 5 comes with two modes of running. The first one, easier to handle, uses the strengths of a powerful Python interface in order to implement the analysis by the mean of a set of intuitive commands. The second one requires to implement the analysis in the C++ programming language, directly within the core of the analysis framework. This opens unlimited possibilities concerning the level of complexity which can be reached by the analysis, being only limited by the programming skills and the originality of the user.

!MadAnalysis 5 can also be used for the recasting of existing LHC analyses. These features are documented on the MA5 PAD (public analysis database), together with instructions to implement new analyses (see [wiki:PublicAnalysisDatabase the PAD page]).

For downloads, an overview on the project or for any question, please visit us on [https://launchpad.net/madanalysis5 LaunchPad] 

=== Reference cards ===
 * Reference for normal mode (for !MadAnalysis 5 v1.6): [http://madanalysis.irmp.ucl.ac.be/raw-attachment/wiki/WikiStart/MadAnalysis_5_v1_6___Normal_Mode.pdf here]
 * Reference for normal mode (for !MadAnalysis 5 v1.8): [https://madanalysis.irmp.ucl.ac.be/attachment/wiki/WikiStart/normal_mode_v1.8.pdf here]
 * Reference for expert mode (for !MadAnalysis 5 v1.6): [http://madanalysis.irmp.ucl.ac.be/raw-attachment/wiki/WikiStart/MadAnalysis_5_v1_6___Expert_Mode.pdf here]

=== Documentation ===
 * Change log and new functionalities in version 1.4: [http://madanalysis.irmp.ucl.ac.be/raw-attachment/wiki/WikiStart/MA5%20v1.4.pdf here]
 * Download the user manual: [http://www.sciencedirect.com/science/article/pii/S0010465512002950 Comput. Phys. Commun. 184 (2013) 222-256] ([http://arxiv.org/abs/1206.1599 arXiv:1206.1599 [hep-ph]])
 * Documentation for the expert mode: [http://10.1140/epjc/s10052-014-3242-3 Eur.Phys.J. C74 (2014) 10, 3103] ([http://arxiv.org/abs/1405.3982 arXiv:1405.3982 [hep-ph]])
 * Documentation on the PAD: [http://10.1140/epjc/s10052-014-3242-3 Eur.Phys.J. C75 (2015) 2, 56] ([http://arxiv.org/abs/1407.3278 arXiv:1407.3278 [hep-ph]])
 * Documentation on uncertainties and HL extrapolations in PAD: [https://link.springer.com/article/10.1140/epjc/s10052-020-8076-6?wt_mc=Internal.Event.1.SEM.ArticleAuthorIncrementalIssue Eur.Phys.J. C80 (2020) 6, 531] ([https://arxiv.org/abs/1910.11418 arXiv:1910.11418 [hep-ph]])
* Documentation on simplified detector simulations: [https://link.springer.com/article/10.1140%2Fepjc%2Fs10052-021-09052-5#article-info Eur. Phys. J. C 81, 329 (2021)] ([https://arxiv.org/abs/2006.09387 arXiv:2006.09387 hep-ph])

=== External addons ===
 * A first Python code allowing to plot histograms out of SAF files (as generated by !MadAnalysis 5): `git clone https://github.com/crokkon/saf2png` (please check the README for indications on its usage).
 * A second Python code allowing to plot histograms out of SAF files (as generated by !MadAnalysis 5): `git clone https://github.com/irelandscape/safplot` (please check the README for indications on its usage).
 * A third Python code allowing to plot histograms out of SAF files (as generated by !MadAnalysis 5): `git clone https://github.com/effofex/ma5-histo` (please check the README for indications on its usage).
 * A Python code to read each cut flow per signal region and construct LaTeX tables (as generated by !MadAnalysis 5): `git clone https://github.com/jackaraz/ma5_expert.git` (please check the README for indications on its usage).

=== Tutorials ===
 * Collection of tutorials for the normal and expert mode: [https://madanalysis.irmp.ucl.ac.be/wiki/tutorials Tutorials]

=== FAQ ===
 * [wiki:FAQNormalMode Normal mode]

=== Communication ===
 * [wiki:Talks Talks]: Talks, posters and lectures on !MadAnalysis 5.