Notebooks & Examples — SCPN-Control

12Notebooks

6Tutorial Scripts

1Streamlit Dashboard

4CLI Commands

Jupyter Notebooks

#	Notebook	Description	Topics
01	phase_dynamics_intro.ipynb	Kuramoto oscillators, order parameter, synchronisation transition	phase
02	knm_coupling.ipynb	K_nm matrix construction, exponential decay, visualisation	phase K_nm
03	upde_pac_gating.ipynb	UPDE solver with PAC gating, γ parameter sweep	phase UPDE
04	grad_shafranov.ipynb	GS equilibrium solve, flux surface contours, q-profile	physics
05	gk_transport_tiers.ipynb	All 5 GK tiers compared on ITER scenario	physics GK
06	q10_scenario.ipynb	Full Q=10 ITER scenario: equilibrium + transport + controller	physics control
07	snn_compiler.ipynb	SPN → SNN compilation, LIF neuron visualisation, bitstream	SNN
08	hinf_synthesis.ipynb	H∞ controller design, DARE solve, closed-loop Bode plot	control
09	ppo_training.ipynb	PPO agent training, reward curves, comparison with MPC/PID	control RL
10	mhd_stability.ipynb	5 MHD criteria evaluated on ITER equilibrium	physics
11	digital_twin.ipynb	Full digital twin simulation, disruption scenario, SPI mitigation	control physics
12	frontier_physics.ipynb	Nonlinear δf GK, Dimits shift, zonal flow generation	physics GK

Tutorial Scripts

Script	Description	Lines
tutorial_01_basic_pid.py	Minimal PID controller on a simple tokamak model. 5 minutes to first result.	85
tutorial_02_gs_equilibrium.py	Solve GS equilibrium, plot flux surfaces, extract q-profile and pressure.	120
tutorial_03_phase_sync.py	Kuramoto synchronisation with K_nm, animate phase evolution.	95
tutorial_04_mpc_control.py	MPC with 20-step horizon on digital twin. Compare with PID baseline.	140
tutorial_05_rust_speedup.py	Benchmark Python vs Rust backends. Reproduce speedup table.	75
tutorial_06_full_scenario.py	End-to-end: equilibrium → transport → stability → controller → simulation.	200

CLI Commands

# Run interactive demo (opens browser dashboard)
scpn-control demo

# Run Kuramoto + GK benchmark suite
scpn-control benchmark --suite all

# Validate physics solvers against reference data
scpn-control validate --strict

# Start live WebSocket phase streaming
scpn-control live --port 8765 --fps 30