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

WANTED: Analysis codes

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 Public Analysis Database (PAD)! 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.

MadAnalysis is a 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 the PAD page).

For downloads, an overview of the project or for any question, please visit us on ​GitHub

Reference cards

• Reference for normal mode (for MadAnalysis 5 v1.6): ​here
• Reference for normal mode (for MadAnalysis 5 v1.8): ​here
• Reference for expert mode (for MadAnalysis 5 v1.6): ​here

Documentation

• Change log and new functionalities in version 1.4: ​here
• Download the user manual: ​Comput. Phys. Commun. 184 (2013) 222-256 (​arXiv:1206.1599 [hep-ph])
• Documentation for the expert mode: ​Eur.Phys.J. C74 (2014) 10, 3103 (​arXiv:1405.3982 [hep-ph])
• Documentation on the PAD: ​Eur.Phys.J. C75 (2015) 2, 56 (​arXiv:1407.3278 [hep-ph])
• Documentation on uncertainties and HL extrapolations in PAD: ​Eur.Phys.J. C80 (2020) 6, 531 (​arXiv:1910.11418 [hep-ph])

• Documentation on simplified detector simulations: ​Eur. Phys. J. C 81, 329 (2021) (​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: ​Tutorials

FAQ

• Normal mode

Communication

• Talks: Talks, posters and lectures on MadAnalysis 5.