SCPN-Phase-Orchestrator

Domain-agnostic coherence control compiler built on Kuramoto/UPDE phase dynamics. One mathematical engine — 33 domains. From plasma physics to cardiology, power grids to neuroscience.

PyPI Package 12 Engines 33 Domains
162Python Modules
54Rust Modules
3,945Python Tests
567Rust Tests
99%Test Coverage
12UPDE Engines
33Domainpacks
19Monitors

Install

# Core framework (4 dependencies: numpy, scipy, pyyaml, click)
pip install scpn-phase-orchestrator

# With Rust acceleration + differentiable backend
pip install scpn-phase-orchestrator[rust,nn]

# Everything (quantum, plasma, fusion, JAX, gRPC, FPGA)
pip install scpn-phase-orchestrator[full]

Core Pipeline

Domain Binder
YAML spec
→
P/I/S Extractors
Physical · Informational · Symbolic
→
UPDE Engine
12 variants
→
Supervisor
MPC + Regime FSM
→
Actuation
Control output

4 Universal Control Knobs

K — Coupling Strength
Inter-oscillator coupling magnitude. Controls how strongly oscillators influence each other. Mapped to domain-specific parameters via binding spec.
α — Phase Lag
Sakaguchi-Kuramoto phase frustration parameter. Shifts the preferred phase relationship between coupled oscillators.
ζ — Driver Strength
External forcing amplitude across P/I/S channels. Controls how strongly the system is driven by reference signals.
Ψ — Reference Phase
Target phase for the driver. Sets the desired synchronisation state. The system converges toward this reference.

Key Capabilities

Cross-Domain Universality
33 domainpacks from plasma physics to cardiology, power grids to EEG, financial markets to swarm robotics. Same engine, same 4 knobs, different binding specs.
Closed-Loop Control
Built-in MPC supervisor, regime FSM (NOMINAL/DEGRADED/CRITICAL), Petri net state machine, Hebbian plasticity. Not just simulation — active control.
Differentiable Backend
JAX-based nn/ module. Fully differentiable KuramotoLayer, Stuart-Landau, UDE, inverse coupling inference. JIT + vmap + GPU.
Rust Acceleration
54 Rust modules via PyO3 FFI. 2.4×–96× speedup. Pure Python fallback ensures the package works without native extension.
Production Stack
gRPC server, Docker/Helm, Prometheus metrics, Redis state, SHA256 audit trail, STL runtime monitoring, OpenTelemetry export.
Hardware Targets
FPGA (Zynq-7020, sub-15µs latency), GPU (JAX/CUDA), WebAssembly (browser demo), bare metal deployment.

Explore

12 UPDE Engines →
Kuramoto, Stuart-Landau, Inertial, Swarmalator, Simplicial, Stochastic, Geometric, Delay, Ott-Antonsen, Hypergraph, Variational.
33 Domainpacks →
Plasma, cardiac, EEG, power grid, financial, traffic, laser, satellite, robotics, quantum, and 23 more.
19 Monitors →
Coherence, chimera, Lyapunov, entropy, PAC, transfer entropy, sleep staging, EVS, winding number.
162 Modules →
18 subpackages: upde, monitor, adapters, nn, coupling, ssgf, supervisor, autotune, oscillators.
Benchmarks →
15.9 µs/step (N=16), city-scale N=10,000, Rust vs Python comparison.
17 Notebooks + 28 Examples →
QueueWaves, sleep staging, power grid, chimera detection, autotune pipeline.