PAOFLOW.hamiltonian.do_momentum#

Functions#

do_momentum(data_controller)

Compute momentum matrix elements in the Bloch eigenstate basis.

Module Contents#

PAOFLOW.hamiltonian.do_momentum.do_momentum(data_controller)[source]#

Compute momentum matrix elements in the Bloch eigenstate basis.

Parameters:

data_controller (DataController) – Object providing data_arrays and data_attributes. Required arrays: dHksp (shape (nktot, 3, nawf, nawf, nspin)), v_k (shape (nktot, nawf, bnd, nspin)), degen (nested list of degenerate subspace indices).

Returns:

Adds the following key to data_controller.data_arrays:

  • pksp : np.ndarray, shape (nktot, 3, nawf, nawf, nspin), complex — the momentum matrix elements \(\langle n\mathbf{k} | \hat{p}_l | m\mathbf{k} \rangle\) for each Cartesian direction \(l\), projected onto the Bloch eigenstate basis and Hermitian-symmetrised.

Return type:

None

Notes

For each k-point and Cartesian direction \(l\), the momentum operator matrix element is computed in the Bloch eigenstate basis via perturb_split():

\[p^l_{nm}(\mathbf{k}) = \langle n\mathbf{k} | \partial H / \partial k_l | m\mathbf{k} \rangle\]

Hermitian symmetry is then enforced as

\[p^l \leftarrow \frac{p^l + (p^l)^\dagger}{2}\]

Degenerate subspaces at each k-point are handled by perturb_split() to ensure a well-defined basis.