Mg5aMC@NLO

Contents:

Runcard structure

  • The output.txt file (compulsory). This file contains the instructions to generate the source code for the relevant process. For details, please see arXiv:1804.10017 and arXiv:1405.0301. The variable @OUTPUT@ must be used to generate the directory containing the source files.

  • The launch.txt file (compulsory). This file contains the instructions to run the relevant process, including the relevant physical parameters and cuts, more info in Launch.

  • The analysis.f file (compulsory). This Fortran file must fill the histograms from which the HwU files (histograms with uncertainties) and the PineAPPL grids are generated. Note that a single histogram must not contain more than 100 bins, otherwise MadGraph5_aMC@NLO will crash. However, big histograms can be split up into multiple histograms, for which the runner will merge the PineAPPL grids together.

  • The *.patch file(s) (optional). These are one or more .patch files that are applied after MadGraph5_aMC@NLO has generated the sources.

Additional metadata

  • output.txt: contains the generated output.txt script (after all substitutions have been done)

  • launch.txt: contains the generated launch.txt script (after all substitutions have been done)

  • patch: a list of patches’ names, one per row (corresponding to those described in Patches)

  • tau_min: the minimum \(\tau\) value set by the user

  • user_cuts: user defined cuts and cuts values, one per row in the format cut=value (cuts are those defined in Cuts)

Note

It is guaranteed that the keys listed above are always present in grid’s metadata (even if some of the corresponding values might be empty).

Output

  • DATASET: The directory created by mg5_aMC. A few interesting files in this subdirectory are:

    • Events/-/MADatNLO.HwU: histograms with uncertainties (HwU)

    • Events/-/amcblast_obs_-.pineappl: grids created by mg5_aMC, not yet merged together

  • output.txt: Run card for the ‘output’ phase, with all variables substituted to their final values

  • output.log: Output of the external runner during the ‘output’ phase

  • launch.txt: Run card for the ‘launch’ phase, with all variables substituted to their final values

  • launch.log: Output of the external runner during the ‘launch’ phase

  • pineappl.convolute: Output of pineappl convolute

  • pineappl.orders: Output of pineappl orders

  • pineappl.pdf_uncertainty: Output of pineappl pdf_uncertainty