.. McMule documentation master file, created by
   sphinx-quickstart on Tue Nov 15 13:47:33 2022.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

McMule
==================================

.. authors:: CITATION.cff

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   getting-started.rst
   structure.rst
   validator.rst
   general.rst
   menu-file.rst
   libmcmule.rst
   pymule.rst
   technical.rst
   new.rst
   fks.rst
   glossary.rst
   bibliography.rst
   pid.rst
   pieces.rst
   libmcmule_full.rst
   pymule_full.rst

(**M**\ onte **c**\ arlo for **Mu**\ ons and other **le**\ ptons) is a generic framework for higher-order QED calculations of scattering and decay processes involving leptons.
It is written in Fortran 95 with two types of users in mind.
First, several processes are implemented, some at :term:`NLO`, some at :term:`NNLO`.
For these processes, the user can define an arbitrary (infrared safe), fully differential observable and compute cross sections and distributions.
McMule's processes, present and, future, are listed in :numref:`tab_mcmuleprocs` together with the relevant experiments for which the cuts are implemented.
Second, the program is set up s.t. additional processes can be implemented by supplying the relevant matrix elements.

.. _tab_mcmuleprocs:
.. table:: Processes implemented in McMule
   :widths: auto

   ====================================== ========= =============================== =============================
   **process**                            **order** **experiments**                 **comments**
   :math:`\mu\to\nu\bar\nu e`             NNLO      MEG, DUNE                       polarised, massified & exact
   :math:`\mu\to\nu\bar\nu e\gamma`       NLO       MEG, Mu3e, Pioneer              polarised
   :math:`\mu\to\nu\bar\nu eee`           NLO       MEG, Mu3e                       polarised
   :math:`\mu\to\nu\bar\nu e\gamma\gamma` LO        MEG                             polarised
   :math:`\tau\to\nu\bar\nu e\gamma`      NLO       BaBar                           cuts in lab frame
   :math:`\tau\to\nu\bar\nu l\ell\ell`    NLO       Belle II
   :math:`e^+e^-\to \mu^+\mu^-`           NNLO      MUonE                           massified mixed corrections
   :math:`\ell p\to\ell p`                NNLO      MUSE, Prad, ULQ2, Amber         dipole approximation for TPE
   :math:`eN\to eN`                       NNLO      Prad, ULQ2                      electronic corrections only
   :math:`e^-e^-\to e^-e^-`               NNLO      Prad2, MOLLER                   complete
   :math:`e^+e^-\to e^+e^-`               NNLO
   :math:`e^+e^-\to \gamma\gamma`         NNLO      Daphne
   :math:`e^+e^-\to \mu^+\mu^-`           NNLO      VEPP, BES, Daphne, Belle        massified mixed corrections
   :math:`e^+e^-\to \ell^+\ell^-\gamma`   NLO       VEPP, BES, Daphne
   :math:`e^+e^-\to \pi^+\pi^-`           NLO       VEPP, BES, Daphne
   ====================================== ========= =============================== =============================

The public version of the code can be found at

   https://gitlab.com/mule-tools/mcmule

To obtain a copy of the code, ``git`` is recommended

.. code:: bash

   $ git clone --recursive https://gitlab.com/mule-tools/mcmule

Alternatively, we provide pre-compiled binaries for Linux systems on `our website <https://mule-tools.gitlab.io/download.html>`_.

We provide instructions on how is used in Section :ref:`sec_getting_started`.

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`