SCPN-Quantum-Control

NISQ quantum simulation framework for coupled Kuramoto oscillator networks on IBM superconducting hardware. Maps classical phase synchronisation directly to the XY Hamiltonian on qubits.

PyPI Package Algorithms IBM Hardware Results
165Python Modules
22Rust Functions
2,813Tests (95%+ cov)
47Notebooks
17Subpackages
33/33IBM Jobs Passed
0.05%VQE Error
5,401×Rust Speedup

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]

Core Innovation

Kuramoto-to-Quantum Compiler

Maps any coupling matrix Knm directly to executable Qiskit circuits via the XY Hamiltonian:
H = −∑i<j Kij(XiXj + YiYj) − ∑i ωiZi First quantum hardware demonstration of coupled-oscillator synchronisation with heterogeneous natural frequencies. Validated on IBM Heron r2 (156 qubits).

Key Results

Bell Inequality Violation
CHSH S = 2.165, exceeding classical limit by >8σ. Certifies genuine quantum entanglement in synchronised states.
VQE Ground State
0.05% error on 4-qubit system. Energy −6.2998 vs exact −6.3030. Best-in-class for NISQ demonstrations.
QKD Error Rate
5.5% QBER — below the BB84 security threshold of 11%. Quantum-secure key distribution validated.
State Preparation
94.6% fidelity. 33/33 hardware experiments successful on ibm_fez (Heron r2).
Rust Acceleration
5,401× faster Hamiltonian construction than Qiskit alone. 22 PyO3 functions, Rayon parallelisation.
DLA Parity
Exact closed-form theorem: dim(DLA) = 22N−1 − 2. Novel result for XY Hamiltonian Lie algebras.

Pipeline

Knm Matrix
Coupling topology
→
XY Hamiltonian
Quantum mapping
→
Qiskit Circuits
Trotter / VQE / ADAPT
→
IBM Hardware
Heron r2 / Eagle
→
Analysis
33 research modules

Explore

Benchmarks →
Rust vs Python performance, quantum vs classical scaling, hardware results.
165 Modules →
17 subpackages: analysis, phase, hardware, bridge, applications, control, QEC, QSNN.
Algorithms →
VQE, ADAPT-VQE, Trotter, VarQITE, QSVT, Floquet DTC, Lindblad, MCWF.
Hardware Validation →
33 experiments on IBM Heron r2. Bell tests, QKD, VQE, scaling studies.
Applications →
FMO photosynthesis, power grid, Josephson arrays, EEG, ITER plasma.
47 Notebooks →
Tutorials from beginner Kuramoto dynamics to advanced FIM investigation.