Challenges
Datasets
Workspaces
Papers
Discussions
Leaderboard
Log inSign up
Challenges
Datasets
Workspaces
Papers
Discussions
Leaderboard
Blog
Job Board
Q3AS

© 2026 Aqora Quantum S.A.S.

TermsPrivacyLegal Notice

arXiv:2007.12016 · Computer Physics Communications

ARC 3.0: An expanded Python toolbox for atomic physics calculations

Elizabeth Robertson, Nikola Šibalić, R. M. Potvliege, M. P. A. Jones

Published Jan 1, 2021• 108 citations
arXivHTMLPDF

Abstract

ARC 3.0 is a modular, object-oriented Python library combining data and algorithms to enable the calculation of a range of properties of alkali and divalent atoms. Building on the initial version of the ARC library (Šibalić et al., 2017), which focused on Rydberg states of alkali atoms, this major upgrade introduces support for divalent atoms. It also adds new methods for working with atom–surface interactions, for modelling ultracold atoms in optical lattices and for calculating valence electron wave functions and dynamic polarisabilities. Such calculations have applications in a variety of fields, e.g., in the quantum simulation of many-body physics, in atom-based sensing of DC and AC fields (including in microwave and THz metrology) and in the development of quantum gate protocols. ARC 3.0 comes with an extensive documentation including numerous examples. Its modular structure facilitates its application to a wide range of problems in atom-based quantum technologies. Program Title: ARC 3.0 CPC Library link to program files: https://doi.org/10.17632/c4z4n2cdf7.1 Licencing provisions: BSD-3-Clause Programming language: Python External Routines: NumPy [1], SciPy [1], Matplotlib [2], SymPy [3], LmFit [4] Nature of problem: The calculation of atomic properties of alkali and divalent atoms including energies, Stark shifts and dipole–dipole interaction strengths using matrix elements evaluated through a variety of means. Solution method: Dipole matrix elements are calculated using an analytical semi-classical approximation or wave functions obtained by numerical integration of the radial Schrödinger equation for a one-electron model potential. Interaction energies and shifts due to external fields are calculated using second order degenerate perturbation theory or exact diagonalisation of the interaction Hamiltonian, yielding results valid even at large external fields or small interatomic separation. Additional comments including restrictions and unusual features: External electric and magnetic field must be parallel to the quantisation axis. The accuracy of short range (≲1μm) atom - atom interaction potentials is limited by the truncation of the basis. Only weak magnetic fields are supported as only linear Zeeman shifts are taken into account. Calculations for divalent atoms use a single-electron approximation and calculation of their wave functions is not supported. References [1] T.E. Oliphant, Comput. Sci. Eng. 9 (2007) 10. http://www.scipy.org/. [2] J.D. Hunter, Comput. Sci. Eng. 9 (2007) 90. http://matplotlib.org/. [3] A. Meurer et al., PeerJ Comput. Sci. 3 (2017) e103. https://doi.org/10.7717/peerj-cs.103 [4] M. Newville et al., lmfit/lmfit-py 1.0.0 (Version 1.0.0), Zenodo (2019). https://doi.org/10.5281/zenodo.3588521

DOI
10.1016/j.cpc.2020.107814

Related papers

ARC: An open-source library for calculating properties of alkali Rydberg atoms

Nikola Šibalić, Jonathan D. Pritchard, Charles S. Adams +1 more

We present an object-oriented Python library for the computation of properties of highly-excited Rydberg states of alkali atoms. These include single-body effects such as dipole matrix elements, excited-state lifetimes (radiative and black-body limited) and Stark maps of atoms in external electric fields, as well as two-atom interaction potentials accounting for dipole and quadrupole coupling effects valid at both long and short range for arbitrary placement of the atomic dipoles. The package is cross-referenced to precise measurements of atomic energy levels and features extensive documentation to facilitate rapid upgrade or expansion by users. This library has direct application in the field of quantum information and quantum optics which exploit the strong Rydberg dipolar interactions for two-qubit gates, robust atom-light interfaces and simulating quantum many-body physics, as well as the field of metrology using Rydberg atoms as precise microwave electrometers. Program Title: ARC: Alkali Rydberg Calculator Program Files doi: http://dx.doi.org/10.17632/hm5n8w628c.1 Licensing provisions: BSD-3-Clause Programming language: Python 2.7 or 3.5, with C extension External Routines: NumPy [1], SciPy [1], Matplotlib [2] Nature of problem: Calculating atomic properties of alkali atoms including lifetimes, energies, Stark shifts and dipole–dipole interaction strengths using matrix elements evaluated from radial wavefunctions. Solution method: Numerical integration of radial Schrödinger equation to obtain atomic wavefunctions, which are then used to evaluate dipole matrix elements. Properties are calculated using second order perturbation theory or exact diagonalisation of the interaction Hamiltonian, yielding results valid even at large external fields or small interatomic separation. Restrictions: External electric field fixed to be parallel to quantisation axis. Supplementary material: Detailed documentation (.html), and Jupyter notebook with examples and benchmarking runs (.html and .ipynb). [1] T.E. Oliphant, Comput. Sci. Eng. 9, 10 (2007). http://www.scipy.org/. [2] J.D. Hunter, Comput. Sci. Eng. 9, 90 (2007). http://matplotlib.org/.

arXiv:1612.05529•Computer Physics Communications•Aug 5, 2017•519 citations

Diatomic-py: A Python module for calculating the rotational and hyperfine structure of 1Σ molecules

Jacob A. Blackmore, Philip D. Gregory, Jeremy M. Hutson +1 more

We present a computer program to calculate the quantised rotational and hyperfine energy levels of Σ1 diatomic molecules in the presence of dc electric, dc magnetic, and off-resonant optical fields. Our program is applicable to the bialkali molecules used in ongoing state-of-the-art experiments with ultracold molecular gases. We include functions for the calculation of space-fixed electric dipole moments, magnetic moments and transition dipole moments. Program Title: Diatomic-Py CPC Library link to program files: https://doi.org/10.17632/3yfxnh5bn5.1 Developer's repository link: https://doi.org/10.5281/zenodo.6632148 Licensing provisions: BSD 3-clause Programming language: Python ≥ 3.7 Nature of problem: Calculation of the rotational and hyperfine structure of Σ1 molecules in the presence of dc magnetic, dc electric, and off-resonant laser fields. Solution method: A matrix representation of the Hamiltonian is constructed in the uncoupled basis set. Eigenstates and eigenenergies are calculated by numerical diagonalization of the Hamiltonian. Additional comments including restrictions and unusual features: Restricted to calculating the Stark and Zeeman shifts with co-axial electric and magnetic fields.

arXiv:2205.05686•Computer Physics Communications•Aug 29, 2022•16 citations

ElecSus: Extension to arbitrary geometry magneto-optics

James Keaveney, Charles S. Adams, Ifan G. Hughes

We present a major update to ElecSus, a computer program and underlying model to calculate the electric susceptibility of an alkali-metal atomic vapour. Knowledge of the electric susceptibility of a medium is essential to predict its absorptive and dispersive properties. In this version we implement several changes which significantly extend the range of applications of ElecSus, the most important of which is support for non-axial magnetic fields (i.e. fields which are not aligned with the light propagation axis). Supporting this change requires a much more general approach to light propagation in the system, which we have now implemented. We exemplify many of these new applications by comparing ElecSus to experimental data. In addition, we have developed a graphical user interface front-end which makes the program much more accessible, and have improved on several other minor areas of the program structure. Program Title: ElecSus Program Files doi: http://dx.doi.org/10.17632/h7cj8bz4bd.1 Licensing provisions: Apache License, Version 2.0 Programming language: Python External routines/libraries: SciPy library [1] 0.15.0 or later, NumPy [1], matplotlib [2], sympy [3], lmfit 0.9.5 or later [4], wxpython (required for GUI only) Nature of problem: Calculating the weak-probe electric susceptibility of an alkali-metal vapour. The electric susceptibility can be used to calculate spectra such as transmission and Stokes parameters. Measurements of experimental parameters can be made by fitting the theory to data. Solution method: The transition frequencies and wavelengths are calculated using a matrix representation of the Hamiltonian in the completely uncoupled basis. A suite of fitting methods are provided in order to allow user supplied experimental data to be fit to the theory, thereby allowing experimental parameters to be extracted. Restrictions: Results are only valid in the weak-probe regime. [1] T. E. Oliphant, Comput. Sci. Eng. 9, 10 (2007). http://www.scipy.org/ [2] J. D. Hunter, Comput. Sci. Eng. 9, 10 (2007). http://matplotlib.org/ [3] A. Meurer et. al, PeerJ Comp. Sci. 3, e103 (2017) http://www.sympy.org/ [4] M. Newville et al., LMFIT: Non-Linear Least-Square Minimization and Curve-Fitting for Python, Zenodo (2014). DOI:10.5281/zenodo.11813 https://lmfit.github.io/lmfit-py/

arXiv:1708.05305•Computer Physics Communications•Dec 11, 2017•58 citations

The PairInteraction Toolkit for Modeling Rydberg Physics in Alkali and Alkaline-Earth-Like Atoms

Johannes Mögerle, Frederic Hummel, Alicia Keil +8 more

Rydberg atoms provide a powerful platform for exploring strongly interacting quantum systems, both in free space and in structured electromagnetic environments, with growing applications in quantum technology. Accurately modeling their single-atom properties and mutual interactions is essential for interpreting experiments and designing new architectures. We present a unified theoretical framework for Rydberg atoms and their interactions based on multi-channel quantum defect theory (MQDT) and static electromagnetic Green's tensors. MQDT provides a precise description of Rydberg states of divalent atoms such as strontium and ytterbium, while the Green's tensor formalism provides a general and flexible approach for calculating interactions between two Rydberg atoms in arbitrary geometries, including modifications induced by nearby surfaces. We implement this framework in an updated version of the open-source toolkit PairInteraction [Weber et al., J.~Phys.~B~50 (2017)]. The implementation leverages high-performance libraries and achieves speedups of one order of magnitude for pair-potential calculations compared to prior software. We demonstrate the capabilities of the toolkit through example applications to divalent atoms and show excellent agreement with experimental data for an exemplary Stark map of $^{174}$Yb. The modular software architecture enables the community to extend it further.

physics.atom-phCross-listedarXiv:2605.14993•Scientific Reports•May 15, 2026•11 citations

ElecSus: A program to calculate the electric susceptibility of an atomic ensemble

Mark A. Zentile, James Keaveney, Lee Weller +3 more

We present a computer program and underlying model to calculate the electric susceptibility of a gas, which is essential to predict its absorptive and dispersive properties. Our program focuses on alkali-metal vapours where we use a matrix representation of the atomic Hamiltonian in the completely uncoupled basis in order to calculate transition frequencies and strengths. The program calculates various spectra for a weak-probe laser beam in an atomic medium with an applied axial magnetic field. This allows many optical devices to be designed, such as Faraday rotators/filters, optical isolators and circular polarisation filters. Fitting routines are also provided with the program which allows the user to perform optical metrology by fitting to experimental data. Program title: ElecSus Catalogue identifier: AEVD_v1_0 Program summary URL:http://cpc.cs.qub.ac.uk/summaries/AEVD_v1_0.html Program obtainable from: CPC Program Library, Queen’s University, Belfast, N. Ireland Licensing provisions: Apache License, version 2 No. of lines in distributed program, including test data, etc.: 191 270 No. of bytes in distributed program, including test data, etc.: 309 4994 Distribution format: tar.gz Programming language: Python. Computer: Any single computer running Python 2. Operating system: Linux, Mac OSX, Windows. RAM: Depends on the precision required and size of the data set, but typically not larger than 50 MiB. Classification: 2.2, 2.3. External routines: SciPy library [1] 0.12.0 or later, NumPy [1], matplotlib [2] Nature of problem: Calculating the weak-probe electric susceptibility of an alkali-metal vapour. The electric susceptibility can be used to calculate spectra such as transmission and Stokes parameters. Measurements of experimental parameters can be made by fitting the theory to data. Solution method: The transition frequencies and wavelengths are calculated using a matrix representation of the Hamiltonian in the completely uncoupled basis. A suite of fitting methods are provided in order to allow user supplied experimental data to be fit to the theory, thereby allowing experimental parameters to be extracted. Restrictions: Only describes a magnetic field parallel to the laser beam propagation direction. Results are only valid in the weak-probe regime. Running time: At standard precision less than a second for a theory curve, fitting will take 10 s to 20 min depending on the method used, the number of parameters to fit and the number of data points. References: [1] T.E. Oliphant, Comput. Sci. Eng. 9, 10 (2007). http://www.scipy.org/. [2] J.D. Hunter, Comput. Sci. Eng. 9, 10 (2007). http://matplotlib.org/.

arXiv:1409.1873•Computer Physics Communications•Dec 11, 2014•150 citations

Calculation of Rydberg interaction potentials

Sebastian Weber, Christoph Tresp, Henri Menke +4 more

Abstract The strong interaction between individual Rydberg atoms provides a powerful tool exploited in an ever-growing range of applications in quantum information science, quantum simulation and ultracold chemistry. One hallmark of the Rydberg interaction is that both its strength and angular dependence can be fine-tuned with great flexibility by choosing appropriate Rydberg states and applying external electric and magnetic fields. More and more experiments are probing this interaction at short atomic distances or with such high precision that perturbative calculations as well as restrictions to the leading dipole–dipole interaction term are no longer sufficient. In this tutorial, we review all relevant aspects of the full calculation of Rydberg interaction potentials. We discuss the derivation of the interaction Hamiltonian from the electrostatic multipole expansion, numerical and analytical methods for calculating the required electric multipole moments and the inclusion of electromagnetic fields with arbitrary direction. We focus specifically on symmetry arguments and selection rules, which greatly reduce the size of the Hamiltonian matrix, enabling the direct diagonalization of the Hamiltonian up to higher multipole orders on a desktop computer. Finally, we present example calculations showing the relevance of the full interaction calculation to current experiments. Our software for calculating Rydberg potentials including all features discussed in this tutorial is available as open source.

arXiv:1612.08053•Journal of Physics B Atomic Molecular and Optical Physics•May 19, 2017•201 citations
ARC 3.0 is a modular, object-oriented Python library combining data and algorithms to enable the calculation of a range of properties of alkali and divalent atoms. Building on the initial version of the ARC library (Šibalić et al., 2017), which focused on Rydberg states of alkali atoms, this major upgrade introduces support for divalent atoms. It also adds new methods for working with atom–surface interactions, for modelling ultracold atoms in optical lattices and for calculating valence electron wave functions and dynamic polarisabilities. Such calculations have applications in a variety of fields, e.g., in the quantum simulation of many-body physics, in atom-based sensing of DC and AC fields (including in microwave and THz metrology) and in the development of quantum gate protocols. ARC 3.0 comes with an extensive documentation including numerous examples. Its modular structure facilitates its application to a wide range of problems in atom-based quantum technologies. Program Title: ARC 3.0 CPC Library link to program files: https://doi.org/10.17632/c4z4n2cdf7.1 Licencing provisions: BSD-3-Clause Programming language: Python External Routines: NumPy [1], SciPy [1], Matplotlib [2], SymPy [3], LmFit [4] Nature of problem: The calculation of atomic properties of alkali and divalent atoms including energies, Stark shifts and dipole–dipole interaction strengths using matrix elements evaluated through a variety of means. Solution method: Dipole matrix elements are calculated using an analytical semi-classical approximation or wave functions obtained by numerical integration of the radial Schrödinger equation for a one-electron model potential. Interaction energies and shifts due to external fields are calculated using second order degenerate perturbation theory or exact diagonalisation of the interaction Hamiltonian, yielding results valid even at large external fields or small interatomic separation. Additional comments including restrictions and unusual features: External electric and magnetic field must be parallel to the quantisation axis. The accuracy of short range (≲1μm) atom - atom interaction potentials is limited by the truncation of the basis. Only weak magnetic fields are supported as only linear Zeeman shifts are taken into account. Calculations for divalent atoms use a single-electron approximation and calculation of their wave functions is not supported. References [1] T.E. Oliphant, Comput. Sci. Eng. 9 (2007) 10. http://www.scipy.org/. [2] J.D. Hunter, Comput. Sci. Eng. 9 (2007) 90. http://matplotlib.org/. [3] A. Meurer et al., PeerJ Comput. Sci. 3 (2017) e103. https://doi.org/10.7717/peerj-cs.103 [4] M. Newville et al., lmfit/lmfit-py 1.0.0 (Version 1.0.0), Zenodo (2019). https://doi.org/10.5281/zenodo.3588521
We present an object-oriented Python library for the computation of properties of highly-excited Rydberg states of alkali atoms. These include single-body effects such as dipole matrix elements, excited-state lifetimes (radiative and black-body limited) and Stark maps of atoms in external electric fields, as well as two-atom interaction potentials accounting for dipole and quadrupole coupling effects valid at both long and short range for arbitrary placement of the atomic dipoles. The package is cross-referenced to precise measurements of atomic energy levels and features extensive documentation to facilitate rapid upgrade or expansion by users. This library has direct application in the field of quantum information and quantum optics which exploit the strong Rydberg dipolar interactions for two-qubit gates, robust atom-light interfaces and simulating quantum many-body physics, as well as the field of metrology using Rydberg atoms as precise microwave electrometers. Program Title: ARC: Alkali Rydberg Calculator Program Files doi: http://dx.doi.org/10.17632/hm5n8w628c.1 Licensing provisions: BSD-3-Clause Programming language: Python 2.7 or 3.5, with C extension External Routines: NumPy [1], SciPy [1], Matplotlib [2] Nature of problem: Calculating atomic properties of alkali atoms including lifetimes, energies, Stark shifts and dipole–dipole interaction strengths using matrix elements evaluated from radial wavefunctions. Solution method: Numerical integration of radial Schrödinger equation to obtain atomic wavefunctions, which are then used to evaluate dipole matrix elements. Properties are calculated using second order perturbation theory or exact diagonalisation of the interaction Hamiltonian, yielding results valid even at large external fields or small interatomic separation. Restrictions: External electric field fixed to be parallel to quantisation axis. Supplementary material: Detailed documentation (.html), and Jupyter notebook with examples and benchmarking runs (.html and .ipynb). [1] T.E. Oliphant, Comput. Sci. Eng. 9, 10 (2007). http://www.scipy.org/. [2] J.D. Hunter, Comput. Sci. Eng. 9, 90 (2007). http://matplotlib.org/.
We present a computer program to calculate the quantised rotational and hyperfine energy levels of Σ1 diatomic molecules in the presence of dc electric, dc magnetic, and off-resonant optical fields. Our program is applicable to the bialkali molecules used in ongoing state-of-the-art experiments with ultracold molecular gases. We include functions for the calculation of space-fixed electric dipole moments, magnetic moments and transition dipole moments. Program Title: Diatomic-Py CPC Library link to program files: https://doi.org/10.17632/3yfxnh5bn5.1 Developer's repository link: https://doi.org/10.5281/zenodo.6632148 Licensing provisions: BSD 3-clause Programming language: Python ≥ 3.7 Nature of problem: Calculation of the rotational and hyperfine structure of Σ1 molecules in the presence of dc magnetic, dc electric, and off-resonant laser fields. Solution method: A matrix representation of the Hamiltonian is constructed in the uncoupled basis set. Eigenstates and eigenenergies are calculated by numerical diagonalization of the Hamiltonian. Additional comments including restrictions and unusual features: Restricted to calculating the Stark and Zeeman shifts with co-axial electric and magnetic fields.
We present a major update to ElecSus, a computer program and underlying model to calculate the electric susceptibility of an alkali-metal atomic vapour. Knowledge of the electric susceptibility of a medium is essential to predict its absorptive and dispersive properties. In this version we implement several changes which significantly extend the range of applications of ElecSus, the most important of which is support for non-axial magnetic fields (i.e. fields which are not aligned with the light propagation axis). Supporting this change requires a much more general approach to light propagation in the system, which we have now implemented. We exemplify many of these new applications by comparing ElecSus to experimental data. In addition, we have developed a graphical user interface front-end which makes the program much more accessible, and have improved on several other minor areas of the program structure. Program Title: ElecSus Program Files doi: http://dx.doi.org/10.17632/h7cj8bz4bd.1 Licensing provisions: Apache License, Version 2.0 Programming language: Python External routines/libraries: SciPy library [1] 0.15.0 or later, NumPy [1], matplotlib [2], sympy [3], lmfit 0.9.5 or later [4], wxpython (required for GUI only) Nature of problem: Calculating the weak-probe electric susceptibility of an alkali-metal vapour. The electric susceptibility can be used to calculate spectra such as transmission and Stokes parameters. Measurements of experimental parameters can be made by fitting the theory to data. Solution method: The transition frequencies and wavelengths are calculated using a matrix representation of the Hamiltonian in the completely uncoupled basis. A suite of fitting methods are provided in order to allow user supplied experimental data to be fit to the theory, thereby allowing experimental parameters to be extracted. Restrictions: Results are only valid in the weak-probe regime. [1] T. E. Oliphant, Comput. Sci. Eng. 9, 10 (2007). http://www.scipy.org/ [2] J. D. Hunter, Comput. Sci. Eng. 9, 10 (2007). http://matplotlib.org/ [3] A. Meurer et. al, PeerJ Comp. Sci. 3, e103 (2017) http://www.sympy.org/ [4] M. Newville et al., LMFIT: Non-Linear Least-Square Minimization and Curve-Fitting for Python, Zenodo (2014). DOI:10.5281/zenodo.11813 https://lmfit.github.io/lmfit-py/
Rydberg atoms provide a powerful platform for exploring strongly interacting quantum systems, both in free space and in structured electromagnetic environments, with growing applications in quantum technology. Accurately modeling their single-atom properties and mutual interactions is essential for interpreting experiments and designing new architectures. We present a unified theoretical framework for Rydberg atoms and their interactions based on multi-channel quantum defect theory (MQDT) and static electromagnetic Green's tensors. MQDT provides a precise description of Rydberg states of divalent atoms such as strontium and ytterbium, while the Green's tensor formalism provides a general and flexible approach for calculating interactions between two Rydberg atoms in arbitrary geometries, including modifications induced by nearby surfaces. We implement this framework in an updated version of the open-source toolkit PairInteraction [Weber et al., J.~Phys.~B~50 (2017)]. The implementation leverages high-performance libraries and achieves speedups of one order of magnitude for pair-potential calculations compared to prior software. We demonstrate the capabilities of the toolkit through example applications to divalent atoms and show excellent agreement with experimental data for an exemplary Stark map of 174^{174}174Yb. The modular software architecture enables the community to extend it further.
We present a computer program and underlying model to calculate the electric susceptibility of a gas, which is essential to predict its absorptive and dispersive properties. Our program focuses on alkali-metal vapours where we use a matrix representation of the atomic Hamiltonian in the completely uncoupled basis in order to calculate transition frequencies and strengths. The program calculates various spectra for a weak-probe laser beam in an atomic medium with an applied axial magnetic field. This allows many optical devices to be designed, such as Faraday rotators/filters, optical isolators and circular polarisation filters. Fitting routines are also provided with the program which allows the user to perform optical metrology by fitting to experimental data. Program title: ElecSus Catalogue identifier: AEVD_v1_0 Program summary URL:http://cpc.cs.qub.ac.uk/summaries/AEVD_v1_0.html Program obtainable from: CPC Program Library, Queen’s University, Belfast, N. Ireland Licensing provisions: Apache License, version 2 No. of lines in distributed program, including test data, etc.: 191 270 No. of bytes in distributed program, including test data, etc.: 309 4994 Distribution format: tar.gz Programming language: Python. Computer: Any single computer running Python 2. Operating system: Linux, Mac OSX, Windows. RAM: Depends on the precision required and size of the data set, but typically not larger than 50 MiB. Classification: 2.2, 2.3. External routines: SciPy library [1] 0.12.0 or later, NumPy [1], matplotlib [2] Nature of problem: Calculating the weak-probe electric susceptibility of an alkali-metal vapour. The electric susceptibility can be used to calculate spectra such as transmission and Stokes parameters. Measurements of experimental parameters can be made by fitting the theory to data. Solution method: The transition frequencies and wavelengths are calculated using a matrix representation of the Hamiltonian in the completely uncoupled basis. A suite of fitting methods are provided in order to allow user supplied experimental data to be fit to the theory, thereby allowing experimental parameters to be extracted. Restrictions: Only describes a magnetic field parallel to the laser beam propagation direction. Results are only valid in the weak-probe regime. Running time: At standard precision less than a second for a theory curve, fitting will take 10 s to 20 min depending on the method used, the number of parameters to fit and the number of data points. References: [1] T.E. Oliphant, Comput. Sci. Eng. 9, 10 (2007). http://www.scipy.org/. [2] J.D. Hunter, Comput. Sci. Eng. 9, 10 (2007). http://matplotlib.org/.
Abstract The strong interaction between individual Rydberg atoms provides a powerful tool exploited in an ever-growing range of applications in quantum information science, quantum simulation and ultracold chemistry. One hallmark of the Rydberg interaction is that both its strength and angular dependence can be fine-tuned with great flexibility by choosing appropriate Rydberg states and applying external electric and magnetic fields. More and more experiments are probing this interaction at short atomic distances or with such high precision that perturbative calculations as well as restrictions to the leading dipole–dipole interaction term are no longer sufficient. In this tutorial, we review all relevant aspects of the full calculation of Rydberg interaction potentials. We discuss the derivation of the interaction Hamiltonian from the electrostatic multipole expansion, numerical and analytical methods for calculating the required electric multipole moments and the inclusion of electromagnetic fields with arbitrary direction. We focus specifically on symmetry arguments and selection rules, which greatly reduce the size of the Hamiltonian matrix, enabling the direct diagonalization of the Hamiltonian up to higher multipole orders on a desktop computer. Finally, we present example calculations showing the relevance of the full interaction calculation to current experiments. Our software for calculating Rydberg potentials including all features discussed in this tutorial is available as open source.