Wavefunction Files#

The wavefunction input to SAFIRE determines how the Auxiliary-Field Quantum Monte Carlo random walk is importance-sampled and constrained. Wavefunctions also define the initial condition of the Walkers.

SAFIRE supports wavefunctions which are linear combinations

\[|\Psi_\mathrm{T} \rangle = \sum^{N_\mathrm{det}}_n C_n | \Phi_n \rangle\]

of Slater determinants \(|\Phi_n\rangle\) with complex coefficients \(C_n\).

There are two kinds of these multi determinant wavefunctions:

  1. Nonorthogonal multi-Slater determinant (NOMSD) wavefunctions consist of strictly nonorthogonal Slater determinants. Each individual determinant is specified as a complete matrix of orbitals.

  2. Particle-hole multi-Slater determinant (PHMSD) wavefunctions are configuration-interaction-like wavefunctions where all individual Slater determinants are mutually orthogonal and specified in terms of occupancy vectors of a set of reference orbitals.

General Storage Conventions#

For general HDF5 format conventions, see General Storage Conventions in Hamiltonian Files.

NOMSD#

afqmc.h5

  • Wavefunction/

    • NOMSD/

      • 🏷️ format_version 1

      • 🏷️ spin_type

      • ci_coeffs \((N_\mathrm{det},)\)

      • PsiT_<k>/ \((N_\sigma, n_\mathrm{pol} M)\), a CSR matrix

Entry

Description

spin_type

The spin symmetry of the wavefunction, "closed", "collinear" or "noncollinear".

ci_coeffs

The complex coefficients \(C_n\) of the determinants.

PsiT_<k>

The conjugate transpose of the orbital matrix of spin \(\sigma\) of determinant \(n\), with \(k = n_\mathrm{spin} n + \sigma\): PsiT_<2n> (\(\uparrow\)) and PsiT_<2n+1> (\(\downarrow\)) for collinear wavefunctions, PsiT_<n> otherwise. It has one row per electron of that spin, \(N_\sigma = N_\uparrow\) or \(N_\downarrow\), and one row per electron, \(N_\sigma = N\), for noncollinear wavefunctions.

PHMSD#

afqmc.h5

  • Wavefunction/

    • PHMSD/

      • 🏷️ format_version 1

      • 🏷️ spin_type "collinear"

      • 🏷️ number_of_orbitals \(M\)

      • ci_coeffs \((N_\mathrm{det},)\)

      • occa \((N_\mathrm{det}, N_\uparrow)\)

      • occb \((N_\mathrm{det}, N_\downarrow)\)

      • PsiT_<k>/ \((M_\mathrm{ref}, n_\mathrm{pol} M)\), optional, a CSR matrix

Entry

Description

spin_type

The spin symmetry of the wavefunction, "collinear".

number_of_orbitals

The number of spatial orbitals \(M\).

ci_coeffs

The complex coefficients \(C_n\) of the determinants.

occa, occb

The occupied orbitals of each determinant, integers. For example if \(N_\uparrow=N_\downarrow=2\), \(N_\mathrm{det}=2\), \(M=4\), and \(|\Psi_\mathrm{T}\rangle = |0,1\rangle|0,1\rangle + |0,1\rangle|0,2\rangle\) then occa = \([[0, 1], [0, 1]]\) and occb = \([[0, 1], [0, 2]]\).

PsiT_<k>

By default, the occupancies refer to the basis the Hamiltonian is written in. If these entries are present, they specify orbitals that should be used instead. Each is the conjugate transpose of the matrix of the \(M_\mathrm{ref}\) reference orbitals in the basis of the Hamiltonian. There is either one, PsiT_0, shared by both spins, or PsiT_0 (\(\uparrow\)) and PsiT_1 (\(\downarrow\)) for a spin-resolved reference.