using-quspin

Perform exact diagonalization and quantum dynamics simulations for lattice many-body systems with QuSpin.

60|92|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/QuantumBFS/quantum.harness --skill using-quspin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-quspin
Source: https://github.com/QuantumBFS/quantum.harness/tree/main/skills/using-quspin
Command: npx skills add https://github.com/QuantumBFS/quantum.harness --skill using-quspin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires quspin, numpy, scipy, and includes references (resource) components.

What problem does it solve?

This skill provides a robust, expert-curated workflow for performing exact diagonalization (ED) on quantum many-body systems, preventing common pitfalls like incorrect operator normalization or symmetry sector mismatches.

Core Features & Use Cases

  • Symmetry-Aware ED: Automates the construction of Hilbert spaces using translation, parity, and spin-inversion symmetries to maximize computational efficiency.
  • Operator Construction: Provides a standardized interface for defining complex spin, fermion, and boson interactions with built-in Hermiticity and conservation checks.
  • Use Case: Use this skill to compute the ground state or full spectrum of a 1D spin chain, ensuring that Pauli matrix normalization and boundary conditions are handled correctly according to research standards.

Quick Start

Use the using-quspin skill to set up and solve the ground state for a 16-site Heisenberg spin chain with periodic boundary conditions.

Frequently Asked Questions about using-quspin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform exact diagonalization for a quantum many-body system?

Exact diagonalization for a quantum many-body system is performed by constructing the Hamiltonian matrix and computing its eigenvalues. This skill automates Hilbert space construction using symmetry sectors to ensure physical accuracy and maximize memory efficiency.

How does symmetry sector configuration affect quantum dynamics simulations?

Symmetry sector configuration restricts the Hilbert space dimension in quantum dynamics simulations by exploiting translation, parity, and spin-inversion symmetries. Proper configuration maximizes computational efficiency and prevents symmetry mismatches during operator construction.

Can I compute the ground state of a 1D spin chain with periodic boundary conditions?

Yes, you can compute the ground state of a 1D spin chain with periodic boundary conditions by defining the lattice interactions through a standardized operator interface. Built-in checks ensure Pauli matrix normalization and Hermiticity are handled correctly.

Does QuSpin support building Hamiltonians for spin, fermion, and boson models?

Yes, QuSpin supports building Hamiltonians for spin, fermion, and boson models through a standardized interface for defining complex interactions. It includes built-in conservation checks to maintain Hermiticity and ensure operator normalization according to research standards.

Why does exact diagonalization fail due to operator normalization or symmetry mismatches?

Exact diagonalization fails due to incorrect operator normalization or symmetry sector mismatches when the Hilbert space is constructed without aligning symmetries. This skill provides an expert-curated workflow that automates symmetry-aware construction to prevent these common computational pitfalls.