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.

31Domain Families
571Python Modules
177Rust Bindings
1,021Test Files
100Notebooks
342ibm_kingston circuits
+17.5%Peak DLA asymmetry
1,665×Peak Rust speedup

Hardware Evidence — amended July 2026

Parity-sector and excitation-number correlated leakage asymmetry

On ibm_kingston, a 342-circuit, four-qubit campaign across eight Trotter depths recorded a +17.48% peak contrast at depth 6. Follow-up popcount controls found substantial same-popcount within-sector variation, so the current evidence does not support attributing the contrast to DLA parity alone.

The promoted statement is therefore conservative: the committed raw counts show a backend-sensitive, parity-sector and excitation-number correlated leakage asymmetry. Result packs, job identifiers, analysis scripts, and dated amendments remain public; mechanism claims follow the hardware-status ledger.

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

  • Stable release v1.0.0, active development. Stable public contracts are versioned, while research and hardware claim surfaces continue to evolve through dated amendments. Pin exact artefacts for reproducible results.
  • 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.
  • Backend and state-preparation confounds remain. Follow-up controls narrow the promoted wording to parity-sector and excitation-number correlated leakage; DLA parity alone is not established as the mechanism.
  • Capability inventory. v1.0.0 contains 571 Python source modules, 1,038 public classes, 177 Rust bindings, 1,021 Python test files, and 836 public API exports. These are static counts, not performance evidence.
  • Open source, public repository. Source and evidence are public under AGPL-3.0 with a commercial licensing route for proprietary deployment.

Explore