Registered 2014-03-27 by Mihailo Backovic

ATTENTION: MadDM is now a plugin for MadGraph. In order to install it and run it, start madgraph and type

             install maddm

in the command line. Then exit and start maddm with ./

MadDM v.2.0 is numerical tool to compute dark matter relic abundance and dark matter nucleus scattering rates in a generic model. The code is based on the existing MadGraph 5 architecture and as such is easily integrable into any MadGraph collider study. A simple Python interface offers a level of user-friendliness characteristic of MadGraph 5 without sacrificing functionality.

MadDM is able to calculate the dark matter relic abundance in models which include a multi-component dark sector, resonance annihilation channels and co-annihilations.

The direct detection module of the MadDM code calculates spin independent / spin dependent dark matter-nucleon cross sections and differential recoil rates as a function of recoil energy, angle and time. The code provides a simplified simulation of detecor effects for a wide range of target materials and volumes.


MadDM now has its own command line which is designed to resemble the familiar madgraph command line structure.
For example, if you have a model name DMsimp with the dark matter candidate X (with mass MX) and mediator Y (with mass MY and width WY) in the model, you can generate relic density, direct detection etc. by executing the following commands (works as a script as well)

        import model DMsimp
        define darkmatter xd #This command is only necessary if you want to 'force' a DM candidate
        generate relic_density #You can also exclude particles with the '/' syntax
        add direct_detection
        output DMsimp
        #For the 'scan' syntax, any python command works!
        set MX scan:[x for x in range(1, 100)] #sequentially scan over the darkmatter mass (variable MX in this case).
        set MY scan:[x for x in range(1, 100)] #same over the mediator mass
        set WY AUTO

Voila! The output will show up as a 'scan...' file in the output folder of your project.

Project information

Mihailo Backovic
Apache Licence, Simplified BSD Licence, Creative Commons - No Rights Reserved

RDF metadata

View full history Series and milestones

trunk series is the current focus of development.

All code Code

Version control system:
Programming languages:

All questions Latest questions


Latest version is maddmv3.0
released on 2018-03-29

All downloads


  • Update for MadDM v.2.0 released on 2015-06-29
    An update for MadDM v.2.0 is available. The update contains a fix for a small...
  • maddm v2.0 beta update on 2015-06-02
    We have posted an update to the v.2.0 of the MadDM code, which includes some ...
  • MadDM v.2.0 update on 2015-05-28
    We discovered a small bug in the default parameter scanning script of the new...
  • MadDM v.2.0 beta released on 2015-05-19
    We are pleased to release the v.2.0 of the MadDM code. The current upgrade ad...
  • Bug Found and Fixed on 2014-07-07
    A bug in the ChangeParameter() routine has been discovered (credit to Aielet ...