Kagome Lattice Example¶
Directory
This example demonstrates how to run QS³-ED2 for a two-dimensional kagome-lattice quantum spin system with periodic boundary conditions.
The system contains
spin-1/2 sites arranged on a kagome lattice with a
Bravais lattice (three 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/kagome/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 geometrically frustrated lattice using QS³-ED2.
The kagome lattice has a three-site unit cell and coordination number
The example demonstrates
- Hamiltonian construction on a frustrated lattice
- translational symmetry in two directions
- momentum-sector selection
- Lanczos diagonalization
- evaluation of 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 kagome lattice has three sites per unit cell, therefore
For this example
Each site has four 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 kagome-lattice quantum spin model calculation with QS³-ED2.
Key features illustrated include
- geometrical frustration and a three-site unit cell
- translational symmetry reduction
- momentum-sector diagonalization
- Lanczos ground-state computation
- evaluation of correlation functions.