PAOFLOW.arpes.matrix_elements#

Dipole photoemission matrix elements of PAO Bloch states with a plane-wave final state.

Notes

For a state \(|n\mathbf k\rangle = \sum_i c_{i,n\mathbf k}|\phi_i,\mathbf k\rangle\) (cell-periodic gauge, BlochHamiltonian) and a photoelectron of momentum \(\mathbf k_f\),

\[M^\alpha_{n\mathbf k} = \sum_i c_{i,n\mathbf k}\,\sigma_i\,e^{-d_i/2\lambda}\, e^{-i(\mathbf k_f-\mathbf k)\cdot\boldsymbol\tau_i}\,s_i \sum_{l'=l_i\pm1} B^{l'}_i(|\mathbf k_f|)\sum_{m'} G^\alpha_{l_i m_i, l' m'}\, Y_{l'm'}(\hat{\mathbf k}_f),\]

with \(s_i\) the sign of the QE harmonic, \(B\) the radial integrals (radial), \(G\) the dipole Gaunt coefficients (harmonics), \(\sigma_i\) the cross-section factor and \(d_i / \lambda\) the depth over the escape depth (chinook M_compute, vectorised over k-points and bands). The position phase is the gauge term that chinook absorbs into its atomic-gauge Bloch sums; it is unity for \(\mathbf k_f = \mathbf k\).

Functions#

dipole_matrix_elements(basis, eigenvectors, k_final, ...)

M[k, n, s, alpha] for a block of k-points and bands.

polarization_weights(M, polarization)

sum_s |eps . M[k, n, s]|^2 for a polarisation vector eps (Cartesian, complex).

Module Contents#

PAOFLOW.arpes.matrix_elements.dipole_matrix_elements(basis, eigenvectors, k_final, radial, escape_depth=None, k_hamiltonian=None)[source]#

M[k, n, s, alpha] for a block of k-points and bands.

Parameters:
  • basis (PhotoemissionBasis)

  • eigenvectors (ndarray (nk, nawf, nb), complex) – Columns are the states (cell-periodic gauge).

  • k_final (ndarray (nk, nb, 3)) – Photoelectron momenta (1/Å); rows of zero norm are states that do not emit.

  • radial (RadialIntegrals) – Radial integrals keyed by Orbital.radial_key.

  • escape_depth (float, optional) – lambda (Å) of the attenuation e^{-d_i / 2 lambda}; None disables it.

  • k_hamiltonian (ndarray (nk, 3), optional) – Momenta at which the states were computed (1/Å); when given, the gauge phase e^{-i (k_f - k).tau_i} is applied (None: chinook’s atomic-gauge convention, no phase).

Returns:

nspin = 1 for a spinless basis, 2 (up, down) for a spinor basis; last axis x, y, z.

Return type:

ndarray (nk, nb, nspin, 3), complex

PAOFLOW.arpes.matrix_elements.polarization_weights(M, polarization)[source]#

sum_s |eps . M[k, n, s]|^2 for a polarisation vector eps (Cartesian, complex).