J1–J2 Chain Example¶
Directory
This example demonstrates how to run QS³-ED2 for a frustrated one‑dimensional spin chain with both nearest‑neighbor (\(J_1\)) and next‑nearest‑neighbor (\(J_2\)) interactions.
The system consists of
spin‑1/2 sites on a periodic chain.
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/j1j2_chain/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 extends the basic chain calculation by introducing next‑nearest‑neighbor interactions, producing a frustrated spin system.
The example demonstrates
- construction of a Hamiltonian with multiple bond ranges
- symmetry reduction using lattice translations
- momentum‑sector selection
- Lanczos diagonalization
- evaluation of physical observables.
2. Model Hamiltonian¶
The Hamiltonian is
where the bond Hamiltonian is
The symmetric anisotropic interaction is
Here
- \(n=1\) denotes nearest‑neighbor (\(J_1\)) interactions
- \(n=2\) denotes next‑nearest‑neighbor (\(J_2\)) interactions.
3. Coupling Parameters¶
Magnetic field
Nearest‑neighbor (\(J_1\)) couplings
Next‑nearest‑neighbor (\(J_2\)) couplings
4. Lattice Structure¶
System parameters from output.dat
Thus the system is a periodic one‑dimensional chain.
Nearest‑neighbor bonds
Next‑nearest‑neighbor bonds
Total number of bonds
5. Symmetry Operations¶
Translational symmetry
Translation operator
This corresponds to the cyclic shift
6. Momentum (Wavevector) Sector¶
Wavevector parameters from the input
The allowed momenta are
The parameter
selects
Thus the calculation is performed in the zero‑momentum sector
7. Local Hilbert Space¶
Each 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 counter
Input parameters
restrict
9. Hilbert‑space Dimension¶
From output.dat
THS: dimension before symmetry reductionTHS(k): dimension 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 correlation tensor |
two_body_cf_z+-.dat |
ladder correlations |
Correlation pairs are defined in
Example
14. Runtime¶
Measured runtime
15. Summary¶
This example demonstrates a frustrated \(J_1\)–\(J_2\) spin chain calculation using QS³‑ED2.
Key features illustrated include
- multi‑range spin interactions
- translational symmetry reduction
- momentum‑sector selection
- Lanczos ground‑state computation
- evaluation of correlation functions.