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

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

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

Reference cards

• Reference for normal mode (for MadAnalysis 5 v1.6): ​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])

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).

Tutorials

• Collection of tutorials for the normal and expert mode: ​https://madanalysis.irmp.ucl.ac.be/wiki/tutorials

Communication

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