SCPN-Quantum-Control

A quantum simulation framework that uses IBM's superconducting processors to test how networks of coupled oscillators synchronise. Classical Kuramoto theory in, noisy hardware out, and the gap in between is where the physics lives.

19Subpackages
201Python Modules
37Rust Functions
4,771Tests
47Notebooks
342ibm_kingston circuits
+17.5%Peak DLA asymmetry
1,665×Peak Rust speedup

Headline Result — April 2026

First hardware observation of DLA parity asymmetry on IBM Heron r2

On ibm_kingston (Heron r2, 156 qubits), a 342-circuit campaign across 8 Trotter depths shows that the odd parity sector of the XY Hamiltonian's dynamical Lie algebra is systematically more robust to decoherence than the even sector. Peak asymmetry is +17.5 % at depth 6, mean is $(10.8 \pm 1.1)\,\%$ for depths $\ge 4$, Fisher's combined p-value across all eight depths is below numerical precision ($p \ll 10^{-16}$), and the observed magnitude at large depth falls inside the 4.5–9.6 % range predicted in advance by our classical Rust simulator.

This is the first direct empirical confirmation that the $\mathrm{DLA}(H_{XY}) = \mathfrak{su}(2^{n-1}) \oplus \mathfrak{su}(2^{n-1})$ block structure is distinguishable in hardware, and it hands us the exact noise profile needed to calibrate symmetry-guided error mitigation (GUESS) for the Phase 2 scaling campaign.

Install

# Core framework
pip install scpn-quantum-control

# With IBM hardware + Rust acceleration + GPU
pip install scpn-quantum-control[ibm,rust,gpu]

# Everything
pip install scpn-quantum-control[all]

Architecture Pipeline

CLASSICAL SIDE QUANTUM SIDE Knm matrix SCPN layer 12 XY Hamiltonian KnmCompiler Trotter / VQE Qiskit circuits DynQ + ICI pulses qubit placement + control IBM Heron r2 ibm_kingston / ibm_fez Bitstring counts SamplerV2 GUESS mitigation symmetry-guided ZNE DLA parity analysis Welch + Fisher Knm coupling matrix → XY Hamiltonian → Trotter compilation → DynQ placement → Heron r2 → bitstring counts → GUESS mitigation → DLA parity analysis Every box in this diagram is a clickable page.

Known Limitations

What this project is, and what it isn't

  • Active development, pre-1.0 (v0.9.5). Internal APIs may change between releases. Pinning to a specific commit hash is mandatory for reproducible results. See the reproducibility manifest.
  • Coherence wall at depth 250–400 two-qubit gates. Beyond this depth, decoherence dominates on Heron r2 and error mitigation reduces but does not eliminate systematic bias. This is a hard NISQ-era constraint, not specific to our protocol.
  • Hardware access is private. The IBM Quantum Platform account is personal (Open Plan) with a temporary 180-minute promotional allocation currently under arrangement. Reviewers cannot directly re-execute campaigns without separate access.
  • Independent replication pending. The Phase 1 DLA parity asymmetry has only been observed on ibm_kingston. Replication on a second Heron r2 device (ibm_marrakesh) is planned in the Phase 2 campaign to rule out any residual device-specific effect.
  • Documentation drift in progress. A recent audit found some stale numbers (e.g. earlier versions cited “4,828+ tests” — actual is 4,771 collected). Those are being corrected in a rolling documentation refresh. The numbers on this page are freshly verified against the current code tree.
  • GitHub repository is private. The scpn-quantum-control source is accessible to commercial licence holders, academic researchers, contributors under CLA, and peer reviewers. Request access via protoscience@anulum.li. The PyPI package itself is public.

Explore