SAFIRE for Lattice Models#
Some Preliminaries#
SAFIRE can handle model Hamiltonians of the form
where
and,
\(\mu\), \(\nu\) are compound indices, \(\mu = (i,p,m)\), \(\nu = (j,q,n)\), that include the lattice site index, (\(i\), \(j\)), sublattice, (\(p\), \(q\)) and band (\(m\), \(n\)) indices. This is known as the Hubbard-Kanamori Hamiltonian. Many standard model Hamiltonians can be written in this language including the standard Hubbard model, extended Hubbard with nearest-neighbor \(V\), etc. SAFIRE is agnostic to the details of the compound indices. It simply accepts Hamiltonian components which are interpreted as above. This provides great flexibility in specifying Hamiltonians; however, if Hamiltonians are generated externally, care must be taken to ensure that consistent index conventions are used.
safiretools provides a framework for building lattice model Hamiltonians that can generate broad classes of lattice model Hamiltonians
on a variety of lattices, using consistent conventions for indexing.
The framework consists of a Lattice class which is responsible for geometry (see Defining a Lattice),
and a Hamiltonian Builder which is responsible for generating specific Hamiltonian terms given a specific Lattice instance.
LatticeHamiltonian.from_lattice() takes a lattice and the Hamiltonian parameters as keyword arguments
and runs the corresponding build steps, which covers most use cases.
Trial Wavefunctions#
A trial wavefunction is used in AFQMC which is, in general, some linear combination of Slater determinants,
where \(|\Phi_n\rangle\) are Slater determinants, and \(C_n\) is a coefficient. There is no need for the set of Slater determinants to be mutually orthogonal.
Using a trial wavefunction which accurately captures the ordering and symmetries of the target system is critical for achieving good AFQMC results. Care must always be taken to ensure that the trial wavefunction has the desired properties.
Common methods for computing a trial wavefunction include:
Hartree-Fock
free electron / noninteracting solution
among others.
Software Prerequisites#
The safiretools Python package provides tools for generating a broad range of lattice model Hamiltonians. Additionally, safiretools and the autoHF Hartree-Fock solver allow single-Slater determinant trial wavefunctions to be computed. In these tutorials, we will use these tools exclusively; however, from the tutorials, it should also be clear how to import and use wavefunctions and/or Hamiltonians which are generated externally by the user.
See Lattice Model Hamiltonian for details on the Hamiltonian HDF5 format and Wavefunction Files for the possible trial wavefunction formats.
The Tutorials#
The following tutorials will guide you through AFQMC calculations using SAFIRE in order to teach you the typical workflow, and some of the main features of SAFIRE. Each tutorial builds on the previous one. We recommend going through them in order.
See also
Worked examples for Lattice Models