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.

32Subpackages
524Python Modules
171Rust Functions
853Test Files
100Notebooks
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.

Publications — Zenodo Preprints

Seven open-access preprints (25 May 2026) document the hardware campaigns, methods, and software behind this project. Each is archived on Zenodo with a citable DOI and carries the claim boundaries stated in its own abstract. These are preprints under the project's evidence discipline — not peer-reviewed journal articles.

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.10.0). 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. Earlier versions cited a flat test-case count that drifts with optional-dependency availability. The page now reports the stable capability-manifest figures (853 test files, 90 % CI coverage gate). The headline inventory is regenerated against the v0.10.0 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