# 2.3. Radial Wavefunctions and Quantum Defects¶

In this tutorial we show how to access quantum defects and wavefunctions, which are used for the computation of matrix elements, using the Python API. Some aspects of this are discussed in Appendix A of the pairinteraction paper J. Phys. B: At. Mol. Opt. Phys. 50, 133001 (2017).

This feature is mostly used internally and therefore the interfaces are not so user-friendly.

Ahead of our Python code, we call an IPython magic function to make the output of plotting commands displayed inline within the notebook.

```
%matplotlib inline
```

Our code starts with loading the required modules for the computation.
It is irrelevant whether we use the `pireal`

or `picomplex`

modules
here, because we do not calculate any matrix elements.

```
# Arrays
import numpy as np
# Plotting
import matplotlib.pyplot as plt
# Operating system interfaces
import sys
# pairinteraction :-)
if sys.platform == "darwin": sys.path.append("/Applications/pairinteraction.app/Contents/Resources")
elif sys.platform == "win32": sys.path.append("C:\Program Files\pairinteraction")
from libpairinteraction import pireal as pi
```

Keep in mind that pairinteraction is a **Rydberg** interaction
calculator. All techniques presented below work well for the
high-\(n\) states of Rydberg atoms, but fail miserably for
low-lying states.

While the pairinteraction software normally uses the unit system described in the introduction, for the wavefunction it has proven advantageous to perform the calculation in atomic units, i.e. all units below are atomic units (in contrast to the presentation in Appendix A of the pairinteraction paper, where we use SI units throughout).

## 2.3.1. Coulomb wavefunctions¶

Using non-relativistic quantum defect theory it is possible to find
radial wavefunctions. Therefore the Schrödinger equation is solved for a
*given* energy eigenvalue, which results in modified radial
wavefunctions with an effective (non-integer) quantum number
\(n^*\). The derivation is discussed in more detail in M. J. Seaton,
Reports on Progress in Physics 46, 167
(1983) (around
equation 2.77).

where \(\Gamma(z)\) is the Gamma function and \(W_{k,m}(z)\) is
the so-called Whittaker function. These wavefunctions are highly
accurate for large distances and have the correct binding energy. You
can access these wavefunctions in pairinteraction using the
`Whittaker`

class.

## 2.3.2. Numerov’s method and model potentials¶

### 2.3.2.1. Model potentials¶

Another method to determine the radial wavefunctions is by solving the
Schrödinger equation numerically using an *effective* Coulomb potential.
The so-called model potential is usually decomposed into three
contributions

The first term is the charge contribution resulting from the charged core which is screened by the filled electron shells

with coefficients \(\alpha_{1,2,3,4}\) depending on the atomic species and the orbital angular momentum \(l\). These coefficients are provided with pairinteraction in an embedded database. It is possible to substitute these coefficients with your own at runtime.

For the core polarization, only the leading dipole term is considered, which results in:

Here, \(\alpha_d\) is again the core dipole polarizability and \(r_c\) is the effective core size, obtained by comparing the numerical solutions with the experimentally observed energy levels.

In addition to these two terms, we add an effective expression for the spin-orbit interaction

where \(\alpha\approx1/137\) is the fine-structure constant.

### 2.3.2.2. Numerov’s method¶

Numerov’s method can be used to solve differential equations of the form

The iterative solution can be achieved as follows:

where \(y_{n}=y(x_{n})\), \(g_{n}=g(x_{n})\), \(s_{n}=s(x_{n})\), and \(h=x_{n+1}-x_{n}\).

To save space it is useful to reduce the sampling towards large distances from the core as the periods of osciallations become longer and longer. To this end we introduce the square root scaling:

This scaling keeps the number of grid points between nodes of the wave function constant. In this scaling the \(g(r)\) in Numerov’s method is given by

We integrate the equation from outside to inside. Since the wavefunction has to decay to zero at infinity we choose \(y_0 = 0\). Now depending on the number of nodes of wavefunction we decide whether to set \(y_1 = \pm\epsilon\), where \(\epsilon\) is a small number. As the inner cutoff we choose an augmented version of the classical turning point

Other schemes for terminating the integration exist which are based on identifying nodes but for large \(n\) the augmented classical turning point works well and is easy to implement.

## 2.3.3. Quantum defects and model potential in pairinteraction¶

The model potentials and quantum defects are stored in a database which is shipped together with pairinteraction. For performance reasons it is baked into the binary so that it is available in memory at all times. The internal database can also be swapped out with a user-provided one at runtime.

To obtain the parameters from the database we use the `QuantumDefect`

class.

```
qd = pi.QuantumDefect("Rb", 50, 0, 0.5)
```

The parameters of the model potentials can be accessed like member
variables of the `qd`

object. They have mnemonic names to mirror their
meaning in the model potentials presented above.

```
print("Core polarizability: ac =",qd.ac)
print("Effective coulomb potential")
print(" Z =",qd.Z,"(core charge)")
print(" a1 =",qd.a1)
print(" a2 =",qd.a2)
print(" a3 =",qd.a3)
print(" a4 =",qd.a4)
print("Effective core radius: rc =",qd.rc)
```

```
Core polarizability: ac = 9.076
Effective coulomb potential
Z = 37 (core charge)
a1 = 3.69628474
a2 = 1.64915255
a3 = -9.86069196
a4 = 0.19579987
Effective core radius: rc = 1.66242117
```

The effective principal quantum number in quantum defect theory is defined as series expansion

Similarly the effective energy eigenvalues are given as

The parameters \(\delta_{0,2,4,6,\dots}\) and \(R^*\) are also loaded from the database, but since they are only important for the calculation of \(n^*\) and \(E_{nlj}\) there is no interface to query their values. The quantities \(n^*\) and \(E_{nlj}\), however, can be queried.

```
print("Effective quantum number: n* =",qd.nstar)
print("State energy: E(n*) =",qd.energy)
```

```
Effective quantum number: n* = 46.868737950193115
State energy: E(n*) = -1497.6342916553963
```

Even though these parameters can be accessed like member variables, they are read-only values and attempting to change them will result in an error.

## 2.3.4. Radial wavefunction in pairinteraction¶

Two types of radial wavefunctions are available in pairinteraction:

- The numerical wavefunctions computed using Numerov’s method and the model potentials.
- The analytical Coulomb wavefunctions based on the Whittaker functions.

Those two schemes can accessed by classes with the names of their
underlying method, `Numerov`

and `Whittaker`

. Merely instatiating an
object of either class only allocates memory but does not perform any
computations. To actually run the integration, you have to call the
`integrate()`

member function.

```
n = pi.Numerov(qd).integrate()
w = pi.Whittaker(qd).integrate()
```

The wavefunctions which we obtain from these methods are unscaled, i.e. they have their original scaling as defined by the calculation. The \(x\)-axes are square root scaled. The result returned by the Coulomb wavefunction method is \(r \;\Psi^{\text{rad}}(r)\). The result calculated by Numerov’s method is \(X(x)\), as defined above, and must be multiplied by \(\sqrt{x}\) to get \(r \;\Psi^{\text{rad}}(r)\).

```
plt.xlabel("$r$ ($a_0$)")
plt.ylabel("$r^2|\Psi(r)|^2$ [a.u.]")
plt.plot(n[:,0]**2,np.abs(np.sqrt(n[:,0])*n[:,1])**2,'-',label="numeric WF")
plt.plot(w[:,0]**2,np.abs(w[:,1])**2,'--',label="Coulomb WF")
plt.legend();
```