Open Access Article
Ifeanyi J.
Onuorah†
a,
Miki
Bonacci†
bc,
Muhammad M.
Isah
d,
Marcello
Mazzani
a,
Roberto
De Renzi
a,
Giovanni
Pizzi
*bc and
Pietro
Bonfà
*aef
aDepartment of Physics and Earth Sciences, University of Parma, IT-43124 Parma, Italy. E-mail: pietro.bonfa@unipr.it
bPSI Center for Scientific Computing, Theory and Data, CH-5232 Villigen PSI, Switzerland. E-mail: giovanni.pizzi@psi.ch
cNational Centre for Computational Design and Discovery of Novel Materials (MARVEL), Paul Scherrer Institute PSI, CH-5232 Villigen PSI, Switzerland
dDipartimento di Fisica e Astronomia “A. Righi”, Universitá di Bologna, IT-40127 Bologna, Italy
eDipartimento di Scienze Fisiche, Informatiche e Matematiche, University of Modena and Reggio Emilia, IT-41125 Modena, Italy
fCentro S3, CNR-NANO Istituto Nanoscienze, IT-41125 Modena, Italy
First published on 10th January 2025
Positive muon spin rotation and relaxation spectroscopy is a well established experimental technique for studying materials. It provides a local probe that generally complements scattering techniques in the study of magnetic systems and represents a valuable alternative for materials that display strong incoherent scattering or neutron absorption. Computational methods can effectively quantify the microscopic interactions underlying the experimentally observed signal, thus substantially boosting the predictive power of this technique. Here, we present an efficient set of algorithms and workflows devoted to the automation of this task. In particular, we adopt the so-called DFT+μ procedure, where the system is characterized in the density functional theory (DFT) framework with the muon modeled as a hydrogen impurity. We devise an automated strategy to obtain candidate muon stopping sites, their dipolar interaction with the nuclei, and hyperfine interactions with the electronic ground state. We validate the implementation on well-studied compounds, showing the effectiveness of our protocol in terms of accuracy and simplicity of use.
implanted muons.3 It is mostly used to study the magnetic properties of materials, where the muon acts as a tiny magnetometer at an interstitial position in the sample, but it also provides an effective tool to study superconducting order parameters, light particle diffusion, and charge related phenomena.2 The experimentally acquired signal is the muon spin polarization function, which is the time evolution of the muon spin projected along a given direction. In the conventional scheme for data analysis, the main features of the signal are determined by a best fit to an effective model that contains one or more Larmor precession frequencies and their decay in time, or simply exponential decays that result from a distribution of local fields at the muon sites of either nuclear or electronic origin. This approach conveys important information on the system, such as order parameters, transition temperatures, presence of phase separation, but generally delivers only limited microscopic information on the sample under investigation. This is because the muon stopping site and its interactions with the host are generally unknown (at variance with NMR where the position of the nucleus is precisely known). A few experimental approaches such as the measurement of the anisotropy of the Knight/paramagnetic shifts, or of level crossing resonances, can be used to find muon stopping sites,3–5 but they require both extensive beam time and large single crystal compounds, which are not generally available. On the contrary, computational approaches based on the Density Functional Theory (DFT), dubbed DFT+μ in the literature, have been recently shown to be less costly and very accurate in finding the muon stopping site and its hyperfine interactions.6–13 Furthermore, in some cases DFT+μ can be used to describe the long-range structure of a ground-state magnetic order14–17 or to study the extent of the muon-induced perturbation, which generally does not affect the intrinsic properties of the compound being studied, with a few notable exceptions readily identified with the ab initio approach.18–20
Nowadays, the DFT+μ method is well established and its adoption for the interpretation of μSR data is becoming more frequent. However, it is challenging for non-experts to set up the machinery required to perform the simulations and acquire sufficient expertise to use the simulation tools efficiently. Furthermore, even for experienced users, it is still challenging to afford the considerable human effort and time consuming intervention required to track and coordinate the large number of calculations involved. These are often several tens, depending on the initial muon trials sites, and require geometry optimization of large supercells as well as additional post-processing in order to obtain the muon interactions in the sample. These issues have limited a routine usage of the ab initio approaches, as well as its adoption in on-line data analysis alongside experiments. To overcome these challenges, an automated framework is highly desirable.
At the same time, the tremendous increase in the high performance computational (HPC) resources has led to the development of automation infrastructures that allow researchers to define workflows, manage calculations and effectively store and organize results into databases. A number of workflows have already been developed to carry out several high-throughput (HT) studies aimed at material design and discovery targeting different properties or applications.21–31 Automated computational approaches are also a valuable tool for the interpretation of other spectroscopic measurements, such as X-ray photoelectron spectroscopy32 and X-ray absorption spectroscopy,33–35 NMR chemical shifts,36,37 electric field gradients (EFG) for nuclear quadrupole resonance (NQR)38 and IR and Raman spectra.39,40
In this paper, we present robust and fully automated workflows implementing protocols to find the muon stopping sites and quantifying its interactions with the hosting sample. The workflow takes advantage of the AiiDA (Automated Interactive Infrastructure and Database for Computational Science) infrastructure,41–43 which is designed to automate, manage, and store computational models making them easily shareable with the scientific community. A few other tools for muon site identification have been published in recent years (see for example the MuFinder Python package44 or the MuonGalaxy platform45). Our approach differs in at least three aspects. First, by leveraging on the AiiDA platform, we can incrementally adopt relevant methods and tools from other application domains: for example, various DFT engines, accurate and automated treatment of self-interaction correction errors in strongly correlated systems,46 or general purpose graphical user interfaces (GUIs) such as AiiDAlab.47 In addition, the platform allows the design of “code agnostic” workflows which can work with any method that provides forces and total energies for a given structure.48,49 The AiiDA platform also guarantees a continuous support for the rapidly evolving HPC infrastructure, where a variety of different technological and security solutions have been recently introduced. The active development of the AiiDA code ensures a seamless transition between different present and future HPC clusters. Second, we provide complete information on the interaction between the muon and its neighboring environment, considering both hyperfine parameters and the dipolar interaction with the nuclear moments. We note, however, that DFT+μ must be compared to T = 0 μSR results and that muon thermally activated motion, important for the interpretation of many experiments, is beyond the scope of the present workflow. Third, thanks to AiiDA provenance model, all workflows and their provenance are fully tracked and made reproducible and easy to share with the rest of the community.
The paper is organized as follows: we first describe the DFT+μ approach. Then, in the “Results and discussion” section, we first describe the algorithms used to automate the calculations and then illustrate two relevant aspects of the workflows with examples: the novel efficient method developed for finding the converged supercell size (that we validate on neutral and charged calculations in a metal, LaCoPO, and an insulator, LiF) and the crucial importance of the inclusion and automated treatment of Hubbard U parameters (in CuO). Finally, the whole workflow is used to study the muon localization and interactions in selected compounds, validating it against experiments. The systems we consider include the Kagome-structured superconductors (AV3Sb5 A = K, Rb, Cs), a fluoride (CaF2, where the strong 19F–muon dipolar interaction provides a direct experimental benchmark), an antiferromagnetic insulator (La2NiO4) and a ferromagnetic metal (LaCoPO). These examples also help us illustrate the workflow features. Finally, future development directions are discussed.
Experimentally, two different charge states are distinguished: the diamagnetic and the paramagnetic muon. These correspond to the two limiting cases of a bare muon or a muon strongly bound to an electron. These two states are accordingly simulated by considering a positive impurity, Mu+, for the diamagnetic state and neutral impurity, Mu˙ for the paramagnetic one (in analogy with H+ and H˙, where the dot is the symbol for an unpaired radical state) obtained within the DFT approach with a charged or neutral supercell, respectively.‡ The starting charge is evolved with the standard self-consistent scheme and the resulting muon state is inspected from the converged charge density. Notably, in general, negligible differences are observed in metals§ due to the effective screening of the positive charge by the conduction electrons,7,13 whereas distinct solutions may be obtained in insulators.
The identification of candidate interstitial sites for the muon is performed by sampling the voids of the lattice structure. A regular grid or a set of random points is generated. The set of initial positions is later reduced by considering the lattice symmetry of the crystal hosting the muon. For each initial position, all atomic positions are optimized to accommodate the muon until forces acting on all the atoms vanish below a given threshold. A minor technical point is that residual symmetries after the insertion of the muon should be discarded and the cell parameters all remain fixed to avoid introducing spurious stresses due to the (infinitely diluted) impurity.50 The procedure results in optimized muon positions that correspond to distinct local minima in the potential energy surface, usually identified as candidate muon sites. Each unique crystallographic position is characterized by a total energy and, although muons might stop at more than one site, the lowest energy ones are assumed to correspond to the most probable stopping sites in the experiment.
The muon mass being one ninth of the hydrogen mass, its zero point energy (ZPE), typically a fraction of an electronvolt, is not negligible. This implies that, even at T = 0, it is important to assess whether higher energy candidate sites are metastable by virtue of the muon zero point motion (ZPM). A self-consistent treatment of the muon ZPM is not currently included, but is planned in future code developments (see “Future developments” section).
In order to verify the correctness of the identified muon site, it is standard practice to compare the predicted spin polarization function with the one obtained in well characterized experiments. In the following paragraphs we briefly describe how this is generally done.
![]() | (1) |
Non-magnetic fluorides (e.g. LiF, CaF) deserve a special mention as the prototypical example where a strong dipolar interaction among the muon magnetic moment and few close nearest-neighbor large nuclear moments provides a unique signature of the muon stopping site.6–8,51 A frequent geometry is that of a straight symmetric F–Mu+–F bond, whose distances are encoded in the classical dipolar interaction
, where the dipolar field of the N = 2 fluorine nuclear moments is written as
![]() | (2) |
The interaction with electrons in ordered magnets is instead obtained with the usual minimal substitution p → p + Aμ, where Aμ is the magnetic vector potential associated with a muon magnetic moment.2 Straightforward elaborations show that all contributions are linear in the muon magnetic moment mμ and can therefore be expressed as
, where Bμ is an effective internal magnetic field. The internal field is conventionally separated into
| Bμ = Bdip + Bc, | (3) |
![]() | (4) |
plugin (see “Code availability” section), which contains the
(AiiDA workflow), the top-level workflow that we expose to users (and internally calls other workflows or calculations). The workflow features include handling of crystal and magnetic structures leveraging on the Atomic Simulation Environment (ASE)54 and Python Materials Genomics (Pymatgen)55 libraries, generation of the initial interstitial muon positions, and automatic convergence of the supercell size. The AiiDA platform handles the interaction with HPC facilities and performs post-processing operations to fetch and parse results, storing them in a database and thus providing efficient query capabilities. As already mentioned, another important feature provided by AiiDA is the definition of “code agnostic” workflows, thus potentially providing different levels of accuracy/speed for the DFT+μ problem. Numerous interfaces, called plugins, between AiiDA and a variety of electronic structure codes have already been developed and can be adopted to perform the electronic structure calculations. However, at the moment the workflow only interfaces with the Quantum ESPRESSO plane-wave DFT code56via the
plugin.43 The plugin also ensures compatibility with different versions of the code and provides fault tolerant algorithms for different tasks including lattice structure relaxation.
The schematic representation of the workflow is shown in Fig. 1. The input includes the crystallographic structure and, possibly, a magnetic order that can be provided, for instance, via files in CIF and mCIF format. Optional input settings for the DFT calculations are provided as Python variables and transformed into AiiDA data formats. The execution of the workflow involves seven steps, labelled I–VII and discussed below.
![]() | ||
Fig. 1 Schematic representation of the workflow. For a description of each box, see points I–VII in section “Automated workflow design” in the main text. | ||
(I) Generate a number Nμ of initial muon interstitial sites.
(II) Execute the supercell (SC) convergence sub-workflow (see “Supercell convergence workflow” section), unless a given SC size is explicitly provided as input.
(III) Execute the structural relaxation of the Nμ supercells, typically in parallel, on HPC clusters.
(IV) Inspect and ensure that at least 60% of the simulations of step III are completed successfully; if not, the workflow stops due to structural convergence failure.
(V) Collect the relaxed structures and their total energies, and cluster distinct stable structures on the basis of symmetry and total energy differences (see “Unique sites selection” section).
(VI) If a magnetic order is provided as input, obtain the contact contribution (Bc) to the local field from the spin-resolved electronic density computed with a dense reciprocal space grid for the distinct stable structures.
(VII) Compute the muon dipolar field interactions at the relaxed structures and the input magnetic configuration using the MUESR code53 interfaced as an AiiDA calculation function (
).
Notably, thanks to the fault tolerant and fault resilient algorithms of the
, the workflow in step III can handle a range of typical errors, such as unconverged SCF calculations or hitting of walltime limits, ensuring that in most cases the calculations finish successfully. In step V, for magnetic compounds, it can happen that crystallographically equivalent replica of a candidate muon site may be magnetically inequivalent.57 When this happens, step III is reactivated, so that relaxed structures of missing magnetically inequivalent sites are obtained and added to the list. Calculations for the charged supercell for the Mu+ state (default) and neutral for the Mu˙ state (optional) are run independently and controlled in the workflow by the Boolean input parameter
.
Two technical points deserve discussion. First, lattice distortions introduced by the muon are always accounted for in the evaluation of dipolar and contact field contributions. Second, the computation of the dipolar contribution in step VII is performed using the magnetic structure provided as input, typically the experimental one, while the contact contribution in step VI is obtained from the ab initio description of the same system. This implies that the magnetic moments, or even the magnetic order obtained at convergence, may be different from the one provided as input. An example is illustrated in the LaCoPO section below.
The outputs of the workflow include: all the relaxed supercell structures and their total energies, the relaxed supercell structures for symmetry/magnetically inequivalent sites, their relative energies with respect to the lowest energy one, and the computed contact hyperfine and dipolar fields (if applicable). This output is stored in the database, with unique identifiers and appropriate metadata for future reference. AiiDA also allows users to export calculation files for ad-hoc post-processing.
Before concluding this section, two aspects of the automated workflow are further discussed. We search for the candidate muon implantation site by sampling the interstitial space with a grid of na × nb × nc regularly spaced initial positions, with the condition that each starting point is at least 1 Å away from any host atom (if a point is closer to any atom, it is discarded). The three integers are determined as ni = ⌈ai/dμ⌉ from the three lattice parameter ai = a, b, c and a unique input spacing dμ (default value: 1 Å). The lattice symmetry is finally used to eliminate equivalent points, generating a reduced total number Nμ of initial muon interstitial sites. The second point concerns calculations involving complex magnetism with non-collinear and/or incommensurate magnetic orders, that are still challenging for DFT-based automated workflows.26,31 The description of non-collinear magnetism is indeed resource- and time-intensive, as the spins have more degrees of freedom, thus making self-consistent convergence harder to achieve and often requiring the introduction of energy penalties to facilitate the minimization. Thus, in the current version, we have restricted the DFT-based calculations to those cases that can be reasonably approximated within the collinear spin formalism, with quantization axis along the z direction, neglecting spin–orbit coupling (and thus any anisotropy term). This still encompasses a large number of compounds of interest for μSR. The limitation can easily be lifted in future developments, when DFT code advancements addressing these issues become available. Also, for this reason, magnetic contributions from f-electrons, where spin–orbit is important, cannot be currently treated correctly. However, non-collinear input array descriptions of the magnetic order are accepted for an accurate evaluation of the dipolar field sums. The DFT calculations are then performed on a collinear structure automatically obtained by projecting each moment along a global spin axis. The accuracy of this approximation varies case by case and the results obtained for non-collinear or incommensurate magnetic orders should therefore be carefully inspected by the user.
plugin which contains the
. It is also automatically used in the
if the input supercell matrix required for the muon calculations is not provided.
Fig. 2 shows the flowchart describing the supercell convergence algorithm. Starting from the input structure, the first step (a) consists of generating a nearly cubic supercell (implemented using the
Python class of the Pymatgen package55). The size of the generated supercell is controlled by two parameters: a minimum length for the supercell and a minimum number of atoms allowed. These are optional input parameters, whose default values are lat + 1 Å and Nat + 1, respectively, where lat is the length of the smallest lattice vector of the input structure and Nat is the number of atoms in the input structure. Step (b) is accomplished by selecting one Voronoi interstitial node in the unit cell by means of the
Python class of the Pymatgen package, and inserting an atomic site at that position in the supercell using a hydrogen pseudopotential, in order to mimic the muon.¶ The forces acting on all atoms are then obtained from a converged self-consistent DFT calculation in step (c) and are used to check for convergence in step (d).
![]() | ||
Fig. 2 The flowchart of the supercell convergence workflow implemented in the . Steps (a)–(d) are described in further detail in the main text. | ||
Fig. 3 illustrates, both for LaCoPO (a metal) and for LiF (an insulator), that the forces on the atoms obtained with a single SCF calculation decay exponentially with their distance from the muon. The decay length λ is obtained as the best fit to F exp(−λri). Notice that an unrelaxed charged supercell, even without the muon, can show forces on the host atoms. For this reason we always consider the difference between the force on each atom with and without the muon (in the uncharged case the latter vanish). For example, forces on La atoms in unrelaxed charged LaCoPO, Fig. 3(a), decay to a constant, representing the effect of (spurious) electronic charge doping, which is correctly subtracted when force differences are considered in Fig. 3(b).
We assume that convergence is reached when atomic forces decay below a given threshold ΔF, which in the workflow is an optional input parameter, with the default set to 1 × 10−3 Ry Bohr−1 or 0.0257 eV Å−1.|| To obtain a converged supercell, two conditions that ensure vanishing forces within the cell have to be satisfied: the minimum host atomic force is less than ΔF and the maximum ri distance is greater than the minimum convergence distance,
. If convergence is achieved, the workflow returns the supercell used in the last step and the corresponding transformation matrix with respect to the input structure. If convergence is not achieved, a larger supercell is generated and the loop goes back to step (c), provided that the maximum number of iteration is not exceeded.
In the case of LiF, Fig. 3(c) and (d), convergence is achieved in a 4 × 4 × 4 supercell, Fig. 3(d), using the default value of ΔF in the workflow, while forces are still above that threshold at the boundaries of the 3 × 3 × 3 supercell, as visible in Fig. 3(c).
In order to verify our assumption that residual forces on atoms are a good proxy for convergence, we select a set of relevant muon-related quantities, namely the muon total energy differences, the computed hyperfine field at the muon, and the bond distance between the muon and nearest neighbor host, and we then explicitly check their convergence in LiF and Fe. At variance with the previous approach, here we relax all atomic positions for each supercell size, which becomes quickly very expensive. A k-point grid distance of 0.1 Å−1 has been utilized for the calculations. In LiF, we compute two quantities for four supercell sizes: the Mu+ DOS level, i.e., the energy position from the Fermi energy of the Mu+ peak in the density of states (DOS), that we show in Fig. 4(a), and the F–Mu+ distance, shown in Fig. 4(b), for the muon at the F–Mu+–F site.6,7 As shown, they meet indeed the convergence criterion in the same 4 × 4 × 4 supercell found by the much more efficient force-difference method. We run similar checks for Fe, where the two candidate muon sites are the octahedral (μO) and tetrahedral (μT) interstitial sites. Here, we compare and show in Fig. 4(c) and (d) the total energy difference between μO and μT, and the calculated contact field at both sites. The force difference method predicts the supercell convergence to be achieved with a 3 × 3 × 3 conventional cubic cell, which is indeed confirmed by the trend of the quantities shown in Fig. 4(c) and (d).
In order to identify symmetry-inequivalent muon sites, clustering algorithms60 based on the conventional hierarchical and k-means method have been proposed.61 However, here we introduce a more tailored, simpler and efficient method based on three quantities: (i) the Euclidean distance between sites, (ii) the total energy differences, and (iii) crystallographic and magnetic symmetries. The usage of these quantities are controlled by the tolerance values, namely: Δε, Δd, and a separate tolerance distance Δs for symmetry related replicas. Our clustering algorithm considers only the symmetry of the muon site, since equivalent muon sites will induce equivalent crystal distortions. The algorithm is initialized with the unit cell, with its symmetry operations and the magnetic unit cell (if applicable). All relaxed muon positions and their corresponding total energies are then added. Unique candidate muon sites are selected according to the following three steps:
(1) Remove duplicate positions within intersite distance Δd and energy Δε tolerance, while retaining only that with the lowest energy.
(2) Remove the crystal-symmetry equivalent positions within symmetry Δs and energy Δε tolerance, while retaining only the lowest-energy inequivalent ones.
(3) Add magnetically inequivalent positions. This is performed generating the replica of the crystalline-equivalent sites in the magnetic unit cell and removing those that are equivalent under magnetic symmetry. Any new site generated this way is resubmitted to the standard workflow in step III of the “Automated workflow design” section.
Step 1 saves a list of n2 ≤ Nμ positions and their corresponding energies, step 2 adds a restricted list of n3 < n2 distinct candidate muon sites with their energies and step 3 (when applicable) adds a separate list of m magnetically inequivalent site(s). Finally, the algorithm outputs n3 unique candidate muon sites and, in case, the new m magnetic inequivalent positions whose structural relaxations must be performed. The algorithm is based on the Pymatgen libraries that can reproduce the symmetry operations pertinent to the input structures of the workflow. The default tolerance values are Δd = 0.5 Å, Δs = 0.05 Å, Δε = 0.05 eV.
A number of advanced corrections already exist to amend this problem. These include the usage of hybrid functionals, such as the Heyd–Scuseria–Ernzerhof (HSE) functional,62 the meta-GGA exchange–correlation functionals, in particular the strongly constrained and appropriately normed (SCAN) approach63 and its more recent variants such as rSCAN64 and r2SCAN,65 and the GW method.66 However these approaches, even though semi- or non-empirical (i.e., not parameter dependent), are very computational demanding.67 An alternative route is provided by the DFT + U method,68–70 which delivers an excellent trade-off between accuracy and efficiency. However, the major drawback for automation is that the Hubbard U value is system dependent. One option to obtain its value is using the linear response approach,70–72 that however significantly increases the calculation cost. Nevertheless, even though the values of U vary with each compound, it has been shown that adapting a set of optimal fixed calibrated U values provides an acceptable compromise73 for improving the description of electronic correlations and further facilitates the seamless automation of high-throughput workflows.22,23,25,27–31 In the current version of the DFT+μ workflow we have therefore implemented as default the optimal Hubbard U values reported in ref. 73 for the following transition-metal ions: Co, Cr, Fe, Mn, Mo, Ni, V, W, Cu, which were obtained from the calibration of formation energies in transition-metal oxides. We note that, alternatively, we let the user provide a set of custom Hubbard U values as an input to the workflow. We note that the possibility of using the DFT + U approach is a novel feature for automated DFT+μ workflows. Furthermore, thanks to the integration with AiiDA, the workflow can be easily extended to more advanced approaches such as the automatic U determination from linear response, as mentioned above, as soon as they become available as AiiDA workflows.
As an example, let us consider cupric oxide (CuO). Its ground state may be seen as a chain antiferromagnet (AFM), ordering three-dimensionally in an A-type collinear AFM structure. It is well known that LDA or GGA incorrectly yields a metallic and non-magnetic ground state for CuO,74 whereas DFT + U75–77 reproduces the known antiferromagnetic ground state. Zero-field μSR (ZF-μSR) detects four distinct internal fields (74 mT, 80 mT, 88 mT, 136 mT) at low temperatures78–81 and four distinct field values are indeed reproduced with U = 4.0 eV, the adopted reference value for Cu.73 They correspond to the two pairs of crystallographic magnetically inequivalent sites bound to each O, shown in Fig. 5(a). Their dipolar Bdip and contact Bc fields, as well as their vector sum modulus Bμ are compared with the experiment in Fig. 5(b). The agreement is reasonably good and Fig. 5(c) shows the dependence of the contact term Bc on the value of the Hubbard U. While a vanishing value is obtained for U = 0 eV, finite values of U all provide reasonable predictions of Bc. This example indicates that the muon hyperfine interaction is sensitive to the treatment of the electronic correlations, and highlights how not including a finite U value results in an incorrect prediction also at the qualitative level.
We note that the positive muon stabilizes in the minimum of the electrostatic potential, more likely being attracted to the most electronegative atomic sites, implying that implantation site is determined by the larger scale of the electric interactions and it may be not sensitive to the much smaller scale of magnetic interaction. This assumption is borne out by the CuO case, where the site is also correctly predicted with U = 0 eV, whereas the correct self consistent hyperfine coupling requires the Hubbard correction. However, the use of DFT + U+μ is known to be relevant also for the localization problem in other cases, such as that of MnO.57
. The set includes non-magnetic and magnetic metals and magnetic insulators. To demonstrate the level of automation possible, thanks to our workflows, the calculations reported below were executed providing only the minimum required input to the workflow, i.e., the crystal and magnetic structures, and keeping the default settings for other optional inputs; furthermore, the
is used to obtain the converged supercell size for each case.
For all calculations, we have used plane-wave based DFT as implemented in the Quantum ESPRESSO suite of codes.56 The standard solid-state pseudopotentials (SSSP) library set optimized for efficiency of the Perdew–Burke–Ernzerhof (PBE) functional (SSSP PBE efficiency v1.3) have been used.82 The validation cases reported below have been performed using default plane-wave and density cutoffs as provided by SSSP. In this context we underline that it is possible that self-consistent convergence, particularly for large cells, can be influenced by the choice of the pseudopotentials, exchange–correlation functional and plane-wave cutoffs. Particular attention is required in selecting these parameters, otherwise the already benchmarked set of pseudopotentials from the SSSP library used in this work is a good choice. A Gaussian smearing with 0.01 Ry width and electronic convergence threshold of 10−6 Ry were utilized for all calculations. A k-point grid distance of 0.301 Å−1 has been utilized to obtain a Monkhorst–Pack grid for Brillouin zone sampling unless otherwise stated. The total computational resources required to run the examples in this section amounted to 342
580 CPU hours on the Leonardo Supercomputer (CINECA).
, we compute the muon stopping sites in these samples with the hexagonal lattice (P6/mmm space group, no. 191), and we further simulate the time-dependent muon ZF polarization spectra.
The supercell workflow produces identical transformation matrices in all three systems:
for handling Mu+ and Mu˙ calculations, we select calcium fluoride (CaF2), known to give rise both to the well characterized51 F–Mu+–F center, and to a Mu˙ state localized at the centre of the primitive cell.6,7
The charge state is controlled in the workflow by the Boolean input parameter
, which is
by default, yielding the Mu+ state, and must be set to
for the Mu˙ state. The converged supercell size is 3 × 3 × 3 for the charged state and 2 × 2 × 2 for the neutral state. This is a general finding: larger supercell sizes are required in the presence of charged interstitials with respect to the neutral case due to the longer-range Coulomb interaction between spurious periodic images.
For the charged state, the lowest energy sites consist of the muon bonding linearly to two neighbor F nuclei with distance 1.13 Å (very close to the 1.172(1) Å value obtained from experiment87), forming the so called F–Mu+–F bond and shown in Fig. 7(a). This site is in agreement with earlier findings.6,7 On the other hand, the lowest energy site in the neutral supercell calculations consists of a muon at the centre of the unit cell,** as shown in Fig. 7(b). Fig. 7(c) and (d) show the displacements from equilibrium of the host Ca and F ions vs. their distance from the muon for the lowest energy Mu+ and Mu˙ sites, respectively. As expected, much larger displacements are obtained close to charged Mu+ than to neutral Mu˙.
to use the default Hubbard U = 6.4 eV for Ni. At variance with the literature,93 the non-magnetic metallic state obtained at U = 0 is replaced by an insulating antiferromagnetic ground state with average magnetic moment of 1.59 μB on Ni, in agreement with neutron experiments (reporting 1.68 μB and 1.62 μB, respectively88,94). A small induced contribution at the planar O site is also observed. The workflow produces four distinct candidate muon sites forming bonds of length ∼1 Å to an O site, as shown in Fig. 8(b)–(e): two bound to the apical O site, labelled A1 and A2, and two bound to the planar O site, labelled P1 and P2, plus an unstable, very high-energy site (>2.5 eV), located at an interstitial site between two consecutive perovskite layers (not shown). By the minimal-energy argument adopted before, we expect muons to localize at the A1 site, and possibly at the A2 site.
This site assignment is confirmed by the muon internal fields calculated within the workflow. Fig. 8(f) shows the Fermi contact Bc and the magnetic dipole Bdip contributions to the internal field Bμ at all four candidate sites. In all the cases, the contribution from Bdip is dominant while those from Bc are almost vanishing. Fig. 8(f) reveals that the values of Bμ computed at sites A1 and A2 are in reasonable agreement with the high (265.6 mT) and low (14.8 mT) internal fields observed in experiments,89–91 also considering the present neglect in the workflow of the quantum zero-point vibrations. Notice that our site assignment partially contradicts earlier non ab initio speculations based on magnetic dipolar field analysis,89–91 where the low internal field was correctly assigned to a muon bound to the apical oxygen, whereas the high internal field was attributed to muon localizing at the planar P2 site. Our findings are strongly supported by a very good reproduction of the magnetic interactions.
Fig. 9(a) shows the LaCoPO unit cell and the positions of the four distinct candidate muon sites, labelled μ1 to μ4. The relative energies and the computed internal field contributions are shown in Fig. 9(b). Site μ1, located 1.47 Å away from the P site along the c axis (see Fig. 9) and towards the La–O layer, is the lowest energy site, whereas the next lowest is site μ2, located 1.50 Å away from the Co site along the c axis and towards the La–O layer. The assignment of the unique experimental internal field to site μ1 is in agreement with our minimal argument and with the earlier study.96 Site μ2 has been reported to be unstable owing to the muon ZPM.96 In Fig. 9(b), we show the contributions to the total internal field for all four candidate sites that we obtained. For all sites but μ4, a sizeable contribution due to the contact hyperfine term Bc is observed. Notice that the ferromagnetic ground state that we obtain shows an average magnetic moment localized on Co atoms of 0.7 μB, more than twice the experimental value. The computed internal field Bμ at site μ1 is 166 mT. The value largely overestimates the experimental value, which is expected since Bc is directly proportional to the magnetic moment.
We emphasize that an improved agreement is already provided by the possibility to evaluate the distant dipole sums with the experimental magnetic structure, including the value of the moments. However, users must be aware that the results provided by the workflow in this case are not “self consistent”, since the contact contribution is obtained instead with the ab initio moments. A crude correction consists in re-scaling11 the value of Bc by a factor mexp/mab initio, which yields Bμ = 46 mT, closer to the experimental value (note, however, that we do not expect a perfect quantitative agreement, also because we are not accounting for the muon ZPM). A better ab initio solution would be to include a self-consistent correction of the magnetic moment using the reduced Stoner theory modification to the exchange–correlation functional.11,97
In the classical limit, thermal muon diffusion can be investigated using the nudged elastic band (NEB) method, that can track the barrier and the minimum energy path connecting the specified initial and final sites.101 Future developments will optionally include this method in the workflow. This information contributes to the prediction of the temperature dependence of the μSR signal.
When the electronic contribution to the muon polarization function is negligible, numerical evaluation of the time evolution of the spin of the muon due to its interaction with the surrounding nuclei is straightforward.87,102–104 Future development of the workflow will include the evaluation of dipolar and quadrupolar contributions103 thus allowing to extract accurate polarization functions from the first principles simulations.
Another improvement that may be considered is the implementation of the reduced Stoner theory correction to the exchange–correlation functional11,97 aimed at a more accurate description of the magnetic ground state and in turn the muon contact hyperfine contribution, particularly for itinerant electron systems where the magnetic moments are poorly estimated with DFT.
On the more technical side, while our automated selection of numerical parameters is able to deliver full automation and provides converged results, in some cases those values could be adapted, so as to run cheaper simulations without significantly affecting the physical results. For example, in LaCoPO, the use of a much smaller 2 × 2 × 1 cell (32 atoms, instead of the 144 atoms of the 3 × 3 × 2 cell obtained from the convergence workflow) and a larger spacing of 1.2 Å for the sampling muon grid (15 initial positions instead of 20), still gives identical results within numerical accuracy. Likewise, for LaNiO2, the interstitial space can also be properly sampled by increasing the muon grid spacing to dμ = 1.6 Å, resulting in only 10 supercells to be computed instead of 52, thus saving computational cost. Therefore, some parameters of the workflow could be further optimized to minimize computational cost.
Moreover, we provide predefined input settings of the workflow, and we demonstrate that these are sufficient to fully automate and provide accurate results for DFT+μ calculations. In addition, if computational resources are limited, it is possible for an experienced user to manually provide less optimal input parameters that still provide reasonably converged results in a shorter time, possibly with looser convergence thresholds.
Our automated workflow represents a powerful tool that will encourage, facilitate and promote the usage of ab initio calculations by the μSR community, opening up the possibility to perform muon simulations routinely alongside experimental measurements.
and the
are actively developed and can be downloaded from the respective GitHub repositories at https://github.com/positivemuon/aiida-muon (v1.0.3, also deposited on Zenodo and available at https://zenodo.org/records/14594493) and https://github.com/positivemuon/aiida-impuritysupercellconv (v1.0.1, also deposited on Zenodo and available at https://zenodo.org/records/14594496). These workflows rely on the
plugin, available at https://github.com/aiidateam/aiida-quantumespresso.
| This journal is © The Royal Society of Chemistry 2025 |