Welcome to MuDirac’s documentation

Contents:

• Installation of MuDirac
  • Dependencies
  • Building MuDirac
  • Install MuDirac using conda
  • Usage
• Theory
  • Prediction of frequencies and probabilities of transition between energy levels of muonic atoms
  • Modelling ground state nuclear properties using muonic x-ray measurements
• Input keywords
  • String keywords
  • Boolean keywords
  • Floating point keywords
  • Integer keywords
• Example of MuDirac Usage
  • Modelling of frequencies and probabilities of transition between energy levels of muonic atoms
  • Modelling ground state nuclear properties using muonic x-ray measurements

MuDirac is a simulation software that integrates the Dirac equation for muonic atoms to compute their X-Ray transition energies; it is written in C++ and can be found on GitHub. The use and functioning of MuDirac is extensively documented in the publications mentioned below, which should be cited by any work using it. In this documentation we will provide information on MuDirac’s parameters, plus tutorials on how to start using it for simple cases.

Mudirac on Galaxy

Mudirac can be run without any installaiton in Galaxy. Mudirac is available as a Galaxy tool on MaterialsGalaxy in the Other Muon Tools section of the tool panel.

Citing MuDirac

For the theoretical background on the software and examples of its applications, see:

• Sturniolo, S, Hillier, A. Mudirac: A Dirac equation solver for elemental analysis with muonic X‐rays. X‐Ray Spectrom. 2020; 1– 17. https://doi.org/10.1002/xrs.3212

• L. Liborio et. al., MuDirac 1.3.0: A Sustainable Software Tool for Calculating Ground State Nuclear Properties Using Muonic X-Ray Measurements. https://arxiv.org/abs/2605.00554

Please cite the above publications if you make use of the software in your work.

Contact

leandro.liborio@stfc.ac.uk

Acknowledgments

Written with funding from the Ada Lovelace Centre, in collaboration with the ISIS Muon Group.