Square Lattice Example¶
Directory
This example demonstrates how to run QS³-ED2 for a two‑dimensional square‑lattice quantum spin system with periodic boundary conditions.
The system contains
spin‑1/2 sites arranged on a
square lattice.
The ground state is computed using the Lanczos method, and the program evaluates
- ground‑state energy
- local magnetization
- two‑point spin correlations.
Note
The numerical values shown in this document are taken from the reference output stored in
examples/ref_dat/square/output.dat.
These files are provided as reference data for documentation and regression testing. The exact numerical values may vary slightly depending on the compilation environment and hardware.
1. Introduction¶
This example illustrates a two‑dimensional lattice calculation with QS³‑ED2.
The example demonstrates
- construction of a Hamiltonian on a 2D lattice
- translational symmetry in two directions
- momentum‑sector selection
- Lanczos diagonalization
- evaluation of physical observables.
2. Model Hamiltonian¶
The Hamiltonian is
with bond interaction
The symmetric anisotropic interaction is
3. Coupling Parameters¶
Magnetic field
Exchange parameters
Dzyaloshinskii–Moriya interaction
\(\Gamma\) interaction
4. Lattice Structure¶
System parameters from output.dat
Thus the system forms a
periodic square lattice.
Each site has four nearest neighbors.
Total number of bonds
5. Symmetry Operations¶
Translational symmetry is defined by
These correspond to lattice translations
with periodic boundary conditions.
6. Momentum (Wavevector) Sector¶
Wavevector parameters
Allowed wavevectors are
with
The input selects
which corresponds to
Thus the calculation is performed in the zero‑momentum sector
7. Local Hilbert Space¶
Each lattice site hosts
so the local Hilbert‑space dimension is
8. NOD Sector Restriction¶
QS³‑ED2 labels basis states using
For spin‑1/2
The global quantity
counts the number of down spins.
Input parameters
restrict
9. Hilbert‑space Dimension¶
From output.dat
THS: total Hilbert‑space dimension before symmetry reductionTHS(k): representative states after symmetry and momentum reduction
10. Lanczos Solver¶
Solver parameters
Total Lanczos iterations
11. Ground‑state Energy¶
The converged ground‑state energy is
12. Eigenvector Accuracy¶
Verification
Residual
This indicates convergence close to machine precision.
13. Observables¶
Enabled in the input
Generated files
| file | description |
|---|---|
local_mag.dat |
local magnetization |
two_body_cf_xyz.dat |
spin correlations |
two_body_cf_z+-.dat |
ladder correlations |
Correlation pairs are specified in
14. Runtime¶
Measured runtime
15. Summary¶
This example demonstrates a two‑dimensional square‑lattice spin model calculation with QS³‑ED2.
Key features illustrated include
- construction of Hamiltonians on 2D lattices
- translational symmetry in two spatial directions
- momentum‑sector diagonalization
- Lanczos ground‑state computation
- evaluation of magnetization and correlation functions.