Honeycomb Lattice Example¶
Directory
This example demonstrates how to run QS³-ED2 for a two‑dimensional honeycomb‑lattice quantum spin system with periodic boundary conditions.
The system contains
spin‑1/2 sites arranged on a
honeycomb lattice (two sites per unit cell).
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/honeycomb/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 calculations on a bipartite two‑dimensional lattice using QS³‑ED2.
The honeycomb lattice consists of two sublattices and has coordination number
The example demonstrates
- Hamiltonian construction on a bipartite 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
The lattice consists of two sites per unit cell, therefore
For this example
Each site has three nearest neighbors.
Total number of bonds
This matches
5. Symmetry Operations¶
Translational symmetry is defined by
These correspond to lattice translations
Periodic boundary conditions are applied in both directions.
6. Momentum (Wavevector) Sector¶
Wavevector parameters
Allowed wavevectors
with
The calculation selects
which corresponds to
Thus the Lanczos diagonalization 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: 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 defined in
14. Runtime¶
Measured runtime
15. Summary¶
This example demonstrates a honeycomb‑lattice quantum spin model calculation with QS³‑ED2.
Key features illustrated include
- bipartite lattice geometry
- two‑site unit cell structure
- translational symmetry reduction
- momentum‑sector diagonalization
- Lanczos ground‑state computation
- evaluation of correlation functions.