qlanth is a Mathematica package that can be used to calculate the level structure of lanthanide ions embedded in crystals. For this purpose it uses a single configuration description with the effective Hamiltonian shown below. This Hamiltonian aims to describe the observed properties of ions embedded in solids in a picture that imagines them as free-ions but modified by the influence of the lattice in which they find themselves in.

This picture is one that developed and mostly matured in the second half of the last century from the efforts of Brian Judd, Hannah Crosswhite, Michael Reid, Bill Carnall, Brian Wybourne, Katherine Rajnak, and others. The goal of this code is to provide a modern implementation of the calculations that resulted from their work, with the aim of fixing some small errors that might have been included at the time these calculations were made. It also aims to provide useful electronic versions of the data these Hamiltonians may produce, including energies and eigenvectors.

qlanth also includes data that might be of use to those interested in the single-configuration description of lanthanide ions, separate to their specific use in this code. These data include the coefficients of fractional parentage (as calculated by Velkov and parsed here), and reduced matrix elements for all the operators listed above in the effective Hamiltonian. These are provided as standard Mathematica associations that should be simple to use elsewhere.

The included Mathematica notebook qlanth.nb has examples of the functions included in this package. The /examples folder includes notebooks for several of the trivalent lanthanide ions in LaF3, showing also comparisons against the published results of Carnall. LaF3 is remarkable in that it was one of the systems in which a systematic study [Carnall (1989)] of most of the trivalent lanthanide ions were studied.

There is also a documentation document (qlanth.pdf) that contains additional theoretical and practical details.

References

• Dodson, Christopher M., and Rashid Zia. “Magnetic Dipole and Electric Quadrupole Transitions in the Trivalent Lanthanide Series: Calculated Emission Rates and Oscillator Strengths.” Physical Review B 86, no. 12 (September 5, 2012): 125102. 🔗
• Velkov, Dobromir. “Multi-Electron Coefficients of Fractional Parentage for the p, d, and f Shells.” John Hopkins University, 2000. 🔗
• Nielson, C. W., and George F Koster. "Spectroscopic Coefficients for the pⁿ, dⁿ, and fⁿ Configurations, 1963. 🔗
• Wybourne, Brian. "Spectroscopic Properties of Rare Earths", 1965.
• Hansen, JE, BR Judd, and Hannah Crosswhite. “Matrix Elements of Scalar Three-Electron Operators for the Atomic f-Shell.” Atomic Data and Nuclear Data Tables 62, no. 1 (1996): 1–49. 🔗
• Carnall, W. T., G. L. Goodman, K. Rajnak, and R. S. Rana. “A Systematic Analysis of the Spectra of the Lanthanides Doped into Single Crystal LaF3.” The Journal of Chemical Physics 90, no. 7 (1989): 3443–57. 🔗

Acknowledgements

• This code was originally authored by Christopher Dodson and Rashid Zia, and was rewritten and expanded by David Lizarazo at Brown University. It has also benefited from the helpful discussions with Tharnier Puel at the University of Iowa.

• This work is supported by the National Sicence Foundation Grant No. 1922278.