Heisenberg Chain

Purpose and structure

The anisotropic nearest-neighbor Heisenberg chain supports independent $XX$, $YY$, and $ZZ$ couplings and a uniform longitudinal field. It is useful for spin correlations, symmetry studies, and exact-diagonalization benchmarks.

$$ H=\sum_i(J_xX_iX_{i+1}+J_yY_iY_{i+1}+J_zZ_iZ_{i+1}) +g\sum_iZ_i. $$

The package uses Pauli products directly and a positive sign for field.

Basis and scaling

The full computational basis has dimension $2^N$. Dense and CSR sparse builders are available. When $J_x=J_y$, total Pauli-$Z$ magnetization $M=\sum_i Z_i$ is conserved and the fixed-sector dimension is

$$ \binom{N}{(N-M)/2}. $$

Sector basis states retain their full computational-basis integer indices.

Package use

from quantum_lattice_models import heisenberg_chain, heisenberg_chain_sector

H = heisenberg_chain(n_sites=5, jx=1.0, jy=0.8, jz=1.2, field=0.1)
sector = heisenberg_chain_sector(
    n_sites=6,
    magnetization=0,
    jx=1.0,
    jy=1.0,
    jz=1.2,
)
H_sector = sector.matrix

Parameters

Builder Parameter Type Default Constraint
heisenberg_chain n_sites int 4 >= 1
heisenberg_chain jx float 1.0
heisenberg_chain jy float 1.0
heisenberg_chain jz float 1.0
heisenberg_chain field float 0.0
heisenberg_chain periodic bool False
heisenberg_chain_sparse n_sites int 4 >= 1
heisenberg_chain_sparse jx float 1.0
heisenberg_chain_sparse jy float 1.0
heisenberg_chain_sparse jz float 1.0
heisenberg_chain_sparse field float 0.0
heisenberg_chain_sparse periodic bool False
heisenberg_chain_sector_sparse n_sites int 6 >= 1
heisenberg_chain_sector_sparse magnetization int 0
heisenberg_chain_sector_sparse jx float 1.0
heisenberg_chain_sector_sparse jy float 1.0
heisenberg_chain_sector_sparse jz float 1.0
heisenberg_chain_sector_sparse field float 0.0
heisenberg_chain_sector_sparse periodic bool False

Validation and cautions

Hermiticity and real spectra are tested. The isotropic limit is $J_x=J_y=J_z$. Fixed-magnetization construction rejects $J_x\ne J_y$ because that anisotropy does not conserve total $Z$ magnetization. Reduced matrices are tested against the corresponding full-space blocks.

Related: XXZ chain, Heisenberg ladder.