Registered 2013-04-13 by Eric Conte

MadAnalysis 5 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 by a large class of Monte Carlo event generators.

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 latest stable version of the MadAnalysis 5 package can be obtained in two ways:
 - directly from the Bazaar versioning system by typing in a shell:
    bzr branch lp:madanalysis5
 - as a tarball (to be downloaded from the right side of this page).

The v1.4 main improvements are:
   - Root is now optional and Pyroot is not a requirement anymore; this should solve all the compilation issues we had in the past.
   - Matplotlib can be used as a plotting module if root is not present.
   - The layout of the figures generated in the normal mode of running of the code has been improved.
   - The recasting module and the associated PAD installation and running have been simplified.
   - The necessary developments for a full embedding in MadGraph5 has been performed. This should become public shortly.
Detailed release notes:

MadAnalysis 5 requires several external libraries in order to properly run:
 - Python 2.6 or a more recent version (but not the 3.X series)
 - The GNU GCC compiler (or clang for Mac OS X users).
 - GNU make

To benefit from all options coming with the MadAnalysis 5 program, the following (optional) libraries have to be installed:
 - ROOT v5.27 or a more recent version.
 - Zlib headers and libraries (automatic installation: typing 'install zlib' in a madanalysis shell)
 - FastJet 3.0 or more recent (automatic installation: typing 'install fastjet' in s madanalysis shell)
 - latex and pdflatex compilers
 - PAD and PADForMA5tune (see
 - Delphes (automatic installation: typing 'install delphes' in a madanalysis shell)
 - DelphesMA5tune (automatic installation: typing 'install delphesMA5tune' in a madanalysis shell)

If you use MadAnalysis 5, please cite
1. E. Conte, B. Fuks and G. Serret,
    Comput. Phys. Commun. 184 (2013) 222

2. E. Conte, B. Dumont, B. Fuks and C. Wymant,
     Eur. Phys. J. C 74 (2014) 10, 3103

3. B. Dumont, B. Fuks, S. Kraml et al.,
      Eur. Phys. J. C 75 (2015) 2, 56

MadAnalysis 5 has two running modes:
 - The first running mode of the program, easier to handle, uses the strengths of a powerful Python interface in order to implement physics analyses by means of a set of intuitive commands.
 - The second running modes requires to implement the analyses in the C++ programming language, directly within the core of the analysis framework. This opens unlimited possibilities concerning the level of complexity that can be reached, the latter being only limited by the programming skills and the originality of the user.
We refer to the manual and MadAnalysis lectures (see for more information.

Project information


RDF metadata

View full history Series and milestones

trunk series is the current focus of development.

All code Code

Version control system:
Programming languages:
Python, C++

All questions Latest questions

More contributors Top contributors

Get Involved


Latest version is v1.5
released on 2016-12-12

All downloads