The Muon Spectroscopy Computational Project

Software and methods to make the muon spectroscopist's life easier

Logo

People

Publications

Tutorials

Software

Funding

Contributing

View Organization on Github

The Unperturbed Electrostatic Potential method

Here we present our software implementation of the Unperturbed Electrostatic Potential (UEP) Method: a method that requires only one DFT calculation, which is used to compute the electronic density of the host material. This, in turn, is used to calculate the minima of the host material’s electrostatic potential and to estimate the stopping site of the diamagnetic muon, relying on the approximation that the muon’s presence does not significantly affect its surroundings.

The UEP method can be used with a complementary tool, which evaluates the interstitial high-symmetry sites in the host material that have not yet been occupied by a muon. In practice, very often, the muon stopping site will be a high-symmetry site of the crystal that has not already been occupied by another atom. Hence, the complementary tool performs a crystallographic analysis of the pure system as a useful first step. We have explained how this complementary tool works here.

A detailed description of this methodology is given in this paper by S. Sturniolo and L. Liborio.

Details of the software implementation

The commands for running the UEP method re the following:

pm-uep-opt performs an optimization of the muon position by minimising the classical electrostatic forces -which originates on the unperturbed electrostatic potential- that act on the muon;

pm-uep-plot produces 1D and 2D plots describing the UEP along specific paths or planes defined in the crystalline structure; and

pm-muairss its application is twofold: first, it is used to produce batches of structure files with a muon defect added following a Poisson random distribution. These mmuonated structural files are the ones optimized with pm-uep-opt and, then, pm-muairss is used again to analyse and cluster the results of these optimizations.

For the UEP scripts, parameter files in the YAML format are necessary. These scripts are run with the commands:

pm-uep-plot <parameters file>

pm-uep-opt <parameters file>

Finally, pm-muairss has both a “write” and a “read” mode: one to create the batches of structure files with a muon defect, and the other to interpret the results of their optimization. It also needs both a structure and a parameter YAML file as inputs. To avoid mistakenly overwriting important data, the default mode is read. The two modes are used as follows:

pm-muairss -t w <structure file> <parameters file> # To write

pm-muairss -t r <structure file> <parameters file> # To read

The -t r argument is optional; if omitted, read mode is assumed. For the parameter files, each script has its own arguments that can be set using them. A detailed description of the specific accepted parameters for the YAML files, and their meaning for each script, is provided here.

An example of a possible work pipeline to use the UEP method could then be as follows:

The clusters with the largest number of muons will then roughly correspond to the minima of the electrostatic potential, with have the largest attraction basin and are likely to be representing a muon stopping site in that host material.

Examples of application of the UEP method

Magnetite (Fe3O4)

Potential muon stopping sites in Fe3O4 magnetite are experimentally well known. The stopping sites are:

The figure below show the O(111) site predicted by the UEP method:

And this other figure below shows an example of a planar region, perpendicular to the (111) direction, which is indicated in yellow:

The muon is located at ≈1.3 Å from its closest oxygen atom in this planar region. A detailed description of the input and output files, resulting from the application of the UEP method to Fe3O4, is in this document.

Hosted on GitHub Pages — Theme by orderedlist