Skip to content

Introduction

As part of the ALPS project we need to describe quantum lattice models in a common XML format, separately from the lattice they live on. Keeping the model definition independent of the lattice means the same Hamiltonian (e.g. the Heisenberg model) can be simulated on any lattice, and the same simulation application can run any model, without changing any code.

This page covers the following topics:

The default model library file

The model library file defines the Hilbert space and the Hamiltonian of the problem. The default model library is found in $ALPSPATH/lib/xml/models.xml, and it contains many of the commonly used models:

model namelist of available parametersremark
spinJ Jz Jxy J0 Jz0 Jxy0 J1 Jz1 Jxy1 h Gamma D K K0 K1anisotropic (XXZ) exchange, optionally with a field, single-ion anisotropy, and biquadratic terms
boson Hubbardmu t V U t0 t1 V0 V1
hardcore bosonsame as aboveboson Hubbard model with on-site occupation restricted to 0 or 1, equivalent to the U → ∞ limit
fermion Hubbardsame as abovespinful fermions; U couples opposite-spin occupation on the same site
spinless fermionsmu t V t0 t1 V0 V1no U, since two spinless fermions cannot occupy the same site
Kondo latticemu t Jconduction electrons (mu, t) exchange-coupled (J) to localized spins
t-Jmu t J V t0 t1 t2 V0 V1 V2 J0 J1 J2effective low-energy model for the Hubbard model in the large-U limit

The parameters above refer to the following physical quantities:

symbol(s)meaning
muchemical potential
t, t0, t1, t2hopping amplitude (site- or bond-type dependent)
Uon-site interaction
V, V0, V1, V2nearest-neighbor (bond) interaction
J, J0, J1, J2isotropic exchange coupling, or the t-J model’s superexchange
Jz, Jz0, Jz1Ising (Sz·Sz) part of an anisotropic (XXZ) exchange coupling
Jxy, Jxy0, Jxy1XY (transverse) part of an anisotropic exchange coupling
huniform longitudinal field, coupling to Sz
Gammatransverse field, coupling to Sx
Dsingle-ion anisotropy, coupling to (Sz)^2
K, K0, K1biquadratic exchange, coupling to (Si·Sj)^2

These models were introduced in the following original papers: the Heisenberg exchange model by Heisenberg (1928), the Hubbard model by Hubbard (1963), the Bose-Hubbard model by Fisher et al. (1989), the Kondo lattice model by Doniach (1977), and the t-J model by Anderson (1987) and Zhang and Rice (1988).

General structure of a model library file

The typical structure of a model library is the following:

<MODEL>
<SITEBASIS name="..."> ... </SITEBASIS>
<BASIS name="..."> ... </BASIS>
<HAMILTONIAN name="..."> ... </HAMILTONIAN>
</MODEL>

The <SITEBASIS> command defines the Hilbert space (basis) of a single site, the <BASIS> command defines the Hilbert space of the whole lattice, and the <HAMILTONIAN> defines the Hamiltonian.


For an overview of the rest of this section, see ALPS Model Definitions. For how the lattice itself is specified, see Lattice Definitions. For the other ALPS documentation sections, see the General Introduction.