| Architecture Decision Records | primary nav | This page records the major design decisions behind scpn-quantum-control: for each one, the context that forced a choice, the decision taken, why it was taken, the alternatives weighed, and the trade-offs accepted. It complements Architectu |
| Experiment Roadmap: March-June 2026 | primary nav | > Canonical status note (2026-05-06): active experiment selection > is consolidated in ROADMAP.md under "Canonical work queue". This > document remains the detailed historical experiment ledger and should > not independently authorise Q |
| Export Control Assessment | catalog | Not legal advice. This document is the project's own good-faith analysis of which export-control regimes apply to scpn-quantum-control, performed on 2026-04-17. A consumer planning to redistribute, embed, or combine this code with propr |
| Paper Claims: Quantum Simulation of Kuramoto Phase Dynamics on NISQ Hardware | primary nav | This file is a legacy planning and triage note, not a submission-ready claim source. Use the current manuscripts, hardware ledger, raw-count artefacts, and claim-boundary documents for coauthor review and publication wording. Items below pr |
| Quantum Cryptography Research Branch | primary nav | This branch records experimental work on topology-authenticated cryptography built on the SCPN coupling matrix model. It is a specialist research lane and is separate from the promoted default API and release gates. |
| REPRODUCIBILITY RECORD — SCPN Quantum Control Frontier Campaign 2026 | catalog | Document version: 2.0 Date: 2026-04-26 Author: Miroslav Šotek / SCPN Quantum Control project SPDX: AGPL-3.0-or-later |
| Threat Model | catalog | This document names the things we are trying to protect (assets), the kinds of actors we plan against (adversaries), where they can try to interact (attack surface), and the mitigations currently in the repository. It is a companion to SECU |
| Actions History Dashboard | primary nav | This page documents the read-only workflow-history audit layer used to keep GitHub Actions history interpretable without deleting evidence for unresolved defects. |
| Adaptive Branching Readiness | catalog | This is the S8 no-submit readiness surface for mid-circuit adaptive branching. It records branch policies and backend prerequisites, with no hardware submission and no adaptive-advantage claim. |
| Adaptive FIM next-experiment proposals | primary nav | BL-80 turns leakage and exact-state-retention counts into conservative proposals for a future static lambda_fim batch. It is an offline experimental-design surface, not a realtime controller and not evidence that FIM feedback protects hardw |
| Advantage / no-advantage language protocol (BL-65) | catalog | This page is the operator-facing guide for when “advantage” language is allowed. Default posture is no-advantage / research observation. Decisive protocol modules remain claim-gated evidence paths — never invent-green marketing. |
| Analog Kuramoto Backends | primary nav | The analog Kuramoto backend interface compiles a validated K_nm, omega problem into native programme schemas for three hardware families: |
| Analog Oscillator Mapping Feasibility | catalog | BL-35 provides a fail-closed answer to a deliberately narrow question: |
| Analog-Native Kuramoto Readiness | catalog | This is the S10 no-submit readiness surface for analog-native Kuramoto backends. It records primitive accounting and provider export status without hardware submission or analog-advantage promotion. |
| Architecture | primary nav | This page documents the software architecture in a way that supports technical due diligence and long-lived integration. The design objective is to keep problem-to-experiment flow deterministic while allowing each subsystem to evolve with c |
| Architecture Map — capabilities, IO, backends, wiring | primary nav | This page is the capability/input-output/backend map of scpn-quantum-control, written for sibling repositories (sc-neurocore, scpn-control, scpn-fusion-core, scpn-phase-orchestrator) and for STUDIO design. It complements two existin |
| Artifact Storage Audit | primary nav | This audit covers committed files under results/, data/, and figures/ as of 2026-04-29. It exists to decide whether the current artifact footprint belongs in Git, Git LFS, or a Zenodo/download-only route. |
| Attested result packs (BL-48) | catalog | Strip-resistant content digests bound to claim axes — never a self-asserted “validated” badge. Local unsigned envelopes are first-class; absent keys yield UNGRADED, never silent-validated. |
| Automatic Backend Selection | catalog | scpn_quantum_control.phase.backend_selector |
| Backends & Plugin Registry | catalog | Two modules for runtime backend management: |
| Benchmark: Dynamic Coupling (Quantum Hebbian Learning) | primary nav | Module: scpn_quantum_control.qsnn.dynamic_coupling Class: DynamicCouplingEngine |
| Benchmark: Hardware Topological Optimizer | primary nav | Modules: |
| Benchmark: Structured Ansatz | primary nav | Module: scpn_quantum_control.phase.structured_ansatz Function: build_structured_ansatz |
| Benchmark Harness | catalog | This page provides the reproducible entry point for public benchmark reconstruction. It keeps low-cost datasets, loaders, and tolerance checks aligned so published benchmark rows can be regenerated without submitting jobs. |
| Changelog | primary nav | This file is the release history anchor for API, evidence, and policy changes. Use it to verify when a claim boundary, verification path, or gating rule changed before that version was promoted. |
| Chimera and Multiscale Synchronisation Control | primary nav | BL-60 turns finite synthetic chimera states, nested order parameters, and hierarchical coherence targets into a documented local control workflow. The implementation composes the repository's existing Kuramoto–Sakaguchi force, Shanahan diag |
| Choosing a gradient path | primary nav | This is the front door for the differentiable-programming surface: a fast route from what you are differentiating to which entry point to call. It is a guide, not a promotion — see Claim status before you quote any number. |
| Classical Baselines | primary nav | This page records the supported classical baseline surfaces for Kuramoto-XY workflows. Each baseline returns a ClassicalBaselineRun envelope with the backend name, availability flag, elapsed wall time, time grid, order-parameter trajectory, |
| Classical irreproducibility of the DLA-parity asymmetry | primary nav | The DLA-parity hardware campaign on ibm_kingston measured a non-zero asymmetry between the "even" and "odd" initial-state sectors: peak +17.48 % at depth 6, mean +9.25 % across the eight depths surveyed, with Fisher combined $\chi^{2} = 123 |
| Closed-Loop Control Analysis | primary nav | scpn_quantum_control.control.closed_loop_analysis turns the response of the measurement-feedback synchronisation controller (control.realtime_feedback.RealtimeSyncFeedbackController) into a control-theoretic verdict and gates any non-simula |
| Continuous competitive baseline watch (BL-61 / W1) | catalog | Fail-closed ops watch over differentiable competitive baselines. Composes the committed refresh inventory (differentiable_competitive_baselines) into a queryable catalogue with pin / version / refresh honesty and structured feed probes |
| Control Scope Boundary | primary nav | The scpn_quantum_control.control package is scoped to synchronisation-control workflows that already exist in this repository: |
| Core Package Boundary | primary nav | This page records the intended boundary for a possible future lightweight Kuramoto-XY core package. It is a planning boundary only. All code currently published in this repository remains under AGPL-3.0-or-later, with the commercial licence |
| Count-Integrity Incident, April 2026 | primary nav | Published 2026-07-16. This note makes the April 2026 internal incident record public in one place; the canonical promotion status of every artefact remains the hardware status ledger. |
| Datasets and Data Registry | catalog | scpn-quantum-control ships two classes of data artefact: |
| Differentiable External-Validation Technical Report | primary nav | This report defines the public comparison and reproducibility package for the differentiable-programming lane. It is a technical report, not a promotion claim. Every row remains bounded by the committed claim ledger until external compariso |
| Differentiable Programming | primary nav | scpn-quantum-control treats differentiability as a product surface, not a hidden implementation detail. The goal is to make coupled-oscillator quantum control trainable, testable, and explainable across quantum gradients, classical program |
| Differentiable Reviewer Evidence | primary nav | This page maps the bounded DP-015 reviewer criticisms and the DP-030 evidence package to real repository commands, artefacts, and explicit public gaps. It is an index into executable evidence, not a replacement for the tests or artefacts. |
| Differentiable Roadmap | primary nav | This roadmap defines the staged work needed to turn differentiable programming into a complete public product surface. It complements the private execution tracker without exposing private execution notes. |
| Differentiable Support Matrix | primary nav | This page is generated from executable registry and planner surfaces. It is checked against the committed capability manifest so source modules, public registry exports, focused tests, and this documentation page cannot drift independently. |
| DLA-parity validation pathway | primary nav | The scpn_quantum_control.dla_parity subpackage is the open-data validation surface for the DLA-parity campaign on ibm_kingston. It loads the 342 published circuits, recomputes every published scalar from the raw counts, cross-checks each on |
| DLA-Protected Scar Memory | primary nav | The scar-memory prototype uses the DLA parity theorem and the fixed-parity repetition-code memory sector from qec.dla_protected_subspace. It prepares a logical cat state across two synchronised repetition-code words inside one DLA parity se |
| DLA-Protected Logical Synchronisation | primary nav | The DLA-protected logical synchronisation module builds a finite repetition-code memory sector inside the global parity decomposition of the heterogeneous Kuramoto-XY Hamiltonian. |
| DLA and Topology-Constrained Differentiable Control | primary nav | BL-54 exposes a bounded local derivative surface for two different constrained objects: |
| Complete documentation catalog | primary nav | The primary navigation stays intentionally compact. This catalog keeps every public guide, evidence note, contract, campaign protocol, and reference page discoverable without crowding the main learning path. |
| DynQ: Dynamic Topology-Agnostic Qubit Mapping | catalog | Quality-weighted community detection for intelligent qubit placement on NISQ hardware. Replaces Qiskit's default SABRE-based layout heuristic with a physics-aware global partitioning strategy. |
| E2E contract boundaries | primary nav | This page records the current end-to-end and contract-test boundary coverage used for release-safety review. The audit is intentionally conservative: a boundary is marked covered only when a pytest module name maps to that boundary, and st |
| End-to-End Testing | catalog | tests/test_e2e_new_modules.py |
| ENAQT Optimal-Noise Scan | primary nav | BL-87 provides a bounded local simulator for environment-assisted quantum transport (ENAQT). It scans a finite set of local dephasing rates and maximises the population irreversibly transferred into a target sink by a fixed time. The commit |
| Entangled initial-state coherence study | primary nav | BL-79 is a bounded four-qubit simulation study of how four pure initial-state families evolve under one frozen Kuramoto-XY Hamiltonian. It does not show that entanglement lowers a synchronisation threshold. The model is closed and unita |
| Quantum Random-Number Generation | primary nav | The scpn_quantum_control.entropy package provides a streaming quantum random-number generator with the NIST SP 800-22 Revision 1a statistical test suite and the FIPS 140-2 Annex C power-up tests. Entropy originates from Qiskit Aer measureme |
| Key Equations | primary nav | This page collects every equation implemented in scpn-quantum-control, from the foundational Kuramoto-to-qubit mapping through the 33 research gems that probe the synchronization transition. Each equation is accompanied by the module that i |
| Error Mitigation | catalog | scpn-quantum-control ships three complementary error-mitigation backends. Choose based on whether you have a known symmetry observable, how much shot budget you can spend, and whether you want a generic black-box wrapper. |
| Execution-Surface Policy | catalog | scpn-bench executes fixed repository scripts with local user privileges. Each harness therefore carries an explicit ExecutionSurfacePolicy: |
| Falsification Protocol | catalog | A scientific claim is only meaningful if there is an experiment whose outcome would refute it. This page collects the falsification criteria for every non-trivial claim scpn-quantum-control currently makes, so a reader can locate the break |
| FRC Pulsed-Shot QAOA Scheduling | primary nav | scpn_quantum_control.control.qaoa_pulsed_cost and scpn_quantum_control.control.frc_pulsed_qaoa schedule capacitor-bank firing for a field-reversed-configuration (FRC) pulsed-compression shot by minimising a control-grade physics cost with Q |
| Free Energy Principle (FEP) on Quantum Substrate | catalog | The Free Energy Principle (Friston 2010) defines variational free energy as: |
| Governed multi-ecosystem route matrix (BL-52) | primary nav | This page is the operator-facing guide for the fail-closed multi-ecosystem route matrix productised under BL-52. It answers: which differentiable route IDs exist, what their closure status is, and why alternatives were rejected — with |
| GPU Batch VQE | catalog | scpn_quantum_control.phase.gpu_batch_vqe |
| Reproducible Hardware Result Packs | primary nav | Hardware result packs are the repository's offline trust surface for promoted IBM hardware evidence. A pack binds raw counts, reproduced summaries, IBM job identifiers, byte sizes, SHA-256 digests, reproduction commands, and explicit claim |
| Hardware-safe gradient execution product (BL-47 / Axis 5) | catalog | Fail-closed no-submit default execution policy surface for hardware-adjacent gradient planning. Dry-run plans estimate shot budgets and cost-model status without provider submission; enforce refuses would-submit and over-budget paths. |
| Hardware Status Ledger | primary nav | Result-pack integrity layer: promoted IBM raw-count datasets are now indexed in hardware_result_packs.md, with the canonical manifest at data/hardware_result_packs/manifest.json and an offline verifier at scripts/verify_hardware_result_pack |
| Hybrid Digital-Analog Execution | primary nav | The hybrid compiler splits a validated Kuramoto-XY workload into two coherent execution blocks: |
| Isolated Benchmark Runner | primary nav | Differentiable-benchmark evidence is promoted to isolated_affinity only when it runs on a self-hosted GitHub Actions runner with a reserved CPU, a recorded governor and frequency, and low host load. Without such a runner the differentiable- |
| JAX NQS baseline product | catalog | scpn_quantum_control.jax_nqs_baseline_product is the BL-103 exact-reference evidence layer for the ambient JAX restricted-Boltzmann-machine runner. It is deliberately a small-system research baseline. |
| Josephson K_nm Magnitude Study | primary nav | This QWC-5.2 artifact records the Josephson topology-correlation candidate and the measured-magnitude gates required before any physical K_nm coupling claim. |
| Kuramoto Competitive Benchmark | primary nav | This page documents the external competitive harness that measures our Kuramoto toolkit against real third-party solvers on one deterministic Kuramoto forward problem. It is the cross-package counterpart to the in-repository Kuramoto Tier B |
| Kuramoto competitive evidence — oscillatools vs the Julia SciML tools | primary nav | This note records a measured head-to-head between the oscillatools coupled-phase-oscillator toolkit and the established Julia libraries on two axes — integration throughput and differentiability — so the toolkit's standing is stated |
| Kuramoto Core Facade | primary nav | The scpn_quantum_control.kuramoto_core facade is the stable entry point for users who only need the Kuramoto-XY compiler layer: |
| Kuramoto Handbook | primary nav | This handbook is the reference page for the in-repository Kuramoto toolkit. It is generated from the live scpn_quantum_control.kuramoto facade and the committed multi-tier benchmark artefact, so the public API inventory, model families, and |
| Kuramoto JAX delayed-tier | primary nav | The time-delayed Kuramoto model θ˙j(t)=ωj+∑kKjksin(θk(t−τ)−θj(t)) is integrated by accel.kuramoto_delayed.integrate_delayed_kuramoto, a delay-aware method-of-steps RK4, and its gradient by the |
| Kuramoto JAX tier | primary nav | The networked-Kuramoto production integrators dispatch Rust → Julia → NumPy. This page documents the opt-in JAX tier: fixed-step Euler, RK4, adaptive Dormand-Prince, networked inertial RK4, networked symplectic inertial, and seeded nois |
| Kuramoto JAX differentiable-model MPC tier | primary nav | Model-predictive control (MPC) plans a finite-horizon control from the current measured state, applies the first control, then re-plans from the new measurement. This page documents an MPC for the Kuramoto network whose **predictive model i |
| Sparse Kuramoto CPU Path | primary nav | oscillatools exposes an explicit sparse CPU route for large classical Kuramoto networks: |
| Kuramoto Standalone Package Decision | primary nav | Decision status: APPROVED 2026-07-04 (CEO/IP). This record supersedes the prior deferral (2026-06-26) and satisfies the Promotion Gate by recording all eight required decisions below. Implementation proceeds in phases; the standalone packag |
| Higher-Order, Monitored, and PT-Symmetric Kuramoto Variants | primary nav | scpn_quantum_control.phase.kuramoto_variants formalises three Kuramoto extensions that previously only existed as campaign-level experiments: |
| Kuramoto Visualisation Layer | primary nav | scpn_quantum_control.accel.kuramoto_visualisation (re-exported from the scpn_quantum_control.kuramoto facade under the visualisation capability group) renders the standard diagnostics for coupled-phase-oscillator trajectories directly from |
| Language Policy | catalog | This document codifies which programming language this repository uses for which part of the stack, and under what criteria a module picks a particular language. It exists so that every new module has a defensible, written rationale for its |
| KT-4 — Continuous-Relaxation Layout Search: Research Design (RESEARCH LABEL) | catalog | **Status: RESEARCH — ANSWERED (2026-07-16). The preregistered experiment ran (§6): the null hypothesis stands — the relaxation shows no gain over the KT-3 discrete baseline at matched true-cost budget. The research label stays; the discrete |
| Lindblad Master Equation Solver | catalog | scpn_quantum_control.phase.lindblad |
| Logical DLA Parity Roadmap | catalog | This note is a post-NISQ planning artefact. It estimates resources for logical-level DLA parity work and keeps the survival claim blocked until the theory and simulation prerequisites are closed. |
| Metamorphic AD verification catalogue (BL-46) | catalog | This page is the operator-facing guide for gradient correctness beyond one-off examples: a versioned catalogue of metamorphic laws, fail-closed refuse paths (including invent-green hardware formal proofs), and pure residual band checks. |
| Methodology and Evidence Governance | primary nav | This is the single entry point for the project's evidence-governance material. You do not need to read it to run the examples — start with Onboarding and the Example Gallery. Read this page when you need to understand *what a result in this |
| Methods Benchmark Dashboard | primary nav | This page is the public reproducibility dashboard for the benchmark artefacts supporting the Rust/VQE methods papers and the SCPN/FIM Hamiltonian paper. The rule is artefact-first: tables and manuscript claims should be regenerated from com |
| Post-Quantum Trigger Signer (ML-DSA-65) | primary nav | scpn_quantum_control.crypto.ml_dsa is a from-specification implementation of the FIPS 204 ML-DSA-65 module-lattice digital signature scheme, and scpn_quantum_control.crypto.pqc_trigger builds a capacitor-bank trigger authorisation signe |
| Multi-Platform Circuit Export | catalog | scpn_quantum_control.hardware.circuit_export |
| Multimodal Forecasting Under Partial Observation | primary nav | This page defines the bounded BL-37 multimodal forecasting product. It provides immutable multimodal custody, a deterministic missingness-aware classical baseline, partial-observation scoring, empirical split residual intervals, and explici |
| Multi-Scale Quantum Error Correction (MS-QEC) | catalog | MS-QEC implements hierarchical quantum error correction through concatenated surface codes. Each SCPN domain operates an independent surface code whose logical qubits serve as the physical qubits of the next domain's code. |
| Mutation Testing | catalog | Line-coverage tells you which statements ran. It does not tell you which logic changes your tests would catch. Mutation testing flips operators and constants in the source one at a time, reruns the suite, and measures how many mutants " |
| Native Speedup Benchmark | primary nav | This page documents the reproducible Rust-vs-Qiskit benchmark for dense XY-Hamiltonian construction — the operation the retired "5401× faster than Qiskit" headline referred to. It follows the unified GOTM benchmark standard (agentic-shared/ |
| Kuramoto neural-operator advantage study | primary nav | This page reports whether the DeepONet neural-operator surrogate for Kuramoto network dynamics (the forecasting.kuramoto_neural_operator module) does more than reduce its training loss — whether it forecasts unseen initial conditions accura |
| Neural Quantum States | catalog | Two modules for variational ground state search using neural network wavefunctions: |
| New Module Index | catalog | This page preserves the historical March 2026 module notes and now routes the newer v0.10 public surfaces to their maintained guides. Use the guide pages below for current examples, evidence boundaries, and API contracts before reading the |
| NV-Centre 20 T Magnetometry | primary nav | scpn_quantum_control.sensing.nv_magnetometry_20T is a simulation-only nitrogen-vacancy (NV) magnetometry response model valid into the 20 T regime. The ground-state spin-1 Hamiltonian is diagonalised exactly, so the optically-detected m |
| Open-System Hardware Circuits | catalog | Hardware-executable methods for simulating open quantum systems on NISQ devices. Two complementary approaches: |
| Orchestrator Integration | primary nav | This page defines the interoperability boundary between scpn-quantum-control and scpn-phase-orchestrator. It is the source of truth for how phase and control semantics move from orchestrator specs into executable quantum workflows without d |
| p_h1 Open-Claim Guard | primary nav | The QWC-5.3 guard keeps the p_h1 = 0.72 threshold publicly framed as an open empirical/theoretical parameter. |
| Dynamical Lie Algebra Parity Theorem for XY-Coupled Oscillator Networks | primary nav | Miroslav Šotek — ANULUM / Fortis Studio ORCID: 0009-0009-3560-0851 |
| Synchronisation Witness Operators for Quantum Oscillator Networks | primary nav | Miroslav Šotek — ANULUM / Fortis Studio ORCID: 0009-0009-3560-0851 |
| Physics-First Kuramoto-XY Tutorial | primary nav | This tutorial starts from the physics object: a network of coupled oscillators. It does not require IBM credentials, SCPN layer constants, or a hardware account. The goal is to move from K_nm and omega to a Hamiltonian, a Trotter circuit, a |
| Pipeline Performance Benchmarks | primary nav | Every module in scpn-quantum-control is verified as wired into the pipeline (not decorative) by tests/test_pipeline_wiring_performance.py (155 tests) and per-module pipeline tests embedded in each test file. This page documents the meas |
| Pipeline Runtime Contract | primary nav | Every component that claims to participate in the SCPN stack must expose a runnable pipeline path. Importable modules are not enough: each pipeline needs a command, a typed contract, validation, and an auditable output artifact. |
| Bit-exact polyglot parity certificates (BL-49 / P1) | catalog | Versioned externally checkable certificate product for the Rust Program AD replay moat: family catalogue (scalar → spectral bounds), certificate schema, digest build/verify helpers. Digests prove sample bundle identity — they do not |
| Quantum Simulation of Coupled-Oscillator Synchronisation on a 156-Qubit Superconducting Processor | primary nav | Miroslav Šotek ANULUM / Fortis Studio, Marbach SG, Switzerland protoscience@anulum.li | ORCID: 0009-0009-3560-0851 |
| Pre-registration Protocol for Hardware Campaigns | catalog | Hardware experiments on a shared QPU are expensive and under-specified by nature — the submitter decides post hoc what counts as a "successful" run. Without a protocol frozen before the first circuit is submitted, hypothesis-after-the-resul |
| Rust Program AD fuzz assurance (BL-96 / P1) | catalog | Versioned fuzz trust-moat product over ambient scpn_quantum_engine/fuzz cargo-fuzz bins: target catalogue, time-boxed CI-optional policy, and dry-run probe helpers. Does not execute cargo-fuzz or invent-green continuous multi-hour c |
| Ψ-field Lattice Gauge Simulator | catalog | The Ψ-field is modelled as a compact U(1) gauge theory on the SCPN graph. Link variables Uij=eiAij live on edges, where Aij∈[−π,π) is the gauge potential. |
| QEC Decoder Boundary | primary nav | This page records the shipped quantum-error-correction decoder surfaces and the decoder families that are intentionally not claimed. |
| QPU Compute Unit Architecture | primary nav | The QPU is not only a validation target for isolated tests. In the SCPN stack it should become a scheduled compute unit: a probabilistic accelerator that accepts typed oscillator artifacts, runs selected quantum kernels, and returns auditab |
| QPU Data Artifact Contract | primary nav | The QPU data artifact is the publication gate between source-facing repositories and scpn-quantum-control. It prevents campaign scripts from inventing coupling matrices locally and makes every QPU submission traceable back to a source, repl |
| QPU Provider Readiness Matrix | primary nav | This document prepares the SCPN stack for allocation requests across known accessible QPU families. The goal is not to hard-code one vendor; the goal is to make every provider an instance of the same compute-unit contract: |
| QPU System Capability Dossier | primary nav | This dossier states what data the SCPN quantum-control stack needs, what computations it can route to quantum hardware, how the results are used, and what the system can realistically deliver. It is written for engineering execution and fut |
| Quantum-classical co-design loop (BL-33) | primary nav | scpn_quantum_control.codesign composes the existing phase-objective, gradient-planning, open-system, control-adapter, and observer products into a deterministic local loop. It is a software-in-the-loop research surface. It does not submit p |
| Quantum/Classical Co-Simulation of K_nm Networks | primary nav | scpn_quantum_control.cosimulation simulates a large Kuramoto-XY coupling network by evolving a small, strongly-coupled core as an exact quantum statevector while the weakly-coupled remainder runs as a classical Kuramoto bath. A network of N |
| Quantum Gradients | primary nav | Quantum gradients are the first differentiable-programming surface that most quantum-ML users look for. The current public route starts with parameter-shift gradients and expands toward backend-aware gradient planning, stochastic finite-sho |
| Bounded Quantum Graph Neural Network | primary nav | scpn_quantum_control.phase.qgnn is a local quantum graph neural network that maps a K_nm coupling graph to a registered Phase-QNode circuit output. A classical message-passing stack turns the graph (nodes carry natural frequencies and weigh |
| Quantum Reservoir Computing and Classical Surrogates | primary nav | This page defines the bounded BL-45 quantum reservoir computing (QRC), matched classical baseline, and differentiable classical-surrogate surfaces. |
| Quantum Sensing Readiness | catalog | This is the S11 no-submit readiness surface for DLA-driven quantum sensing via the synchronisation order parameter. It records QFI and classical Fisher proxy rows without hardware submission or sensing advantage promotion. |
| Quantum Thermodynamics Readiness | catalog | This is the S9 no-submit readiness surface for thermodynamic signatures of synchronisation transitions. It records calibrated observables and protocol prerequisites with no hardware submission and no thermodynamic peak claim. |
| Real-Data Synchronisation Forecasting | primary nav | The forecasting benchmark evaluates whether an early observed synchronisation window can calibrate a physical Kuramoto forecast without seeing the held-out samples. It is intentionally small and replayable: the default dataset is the commit |
| Real-Time Feedback | primary nav | The real-time feedback controller closes the Kuramoto-XY loop in software while keeping the circuit shape compatible with dynamic-circuit execution. It is not a hardware latency claim: the shipped path is a deterministic statevector/live-sh |
| Real-Time Runtime | primary nav | scpn_quantum_control.control.realtime_runtime provides software timing contracts for bounded control loops. It has two surfaces: |
| Research Gems: Novel Quantum Probes of Synchronization | primary nav | A legacy curated set of 33 research-gem modules at the intersection of quantum information, condensed matter physics, and the SCPN coupling architecture. |
| Deep-analysis research lanes | primary nav | SCPN Quantum Control contains a substantial collection of analysis and gauge modules. They do not all have the same maturity, evidence, or relationship to differentiable control. The BL-84 registry makes those differences explicit without t |
| Compile & dense resource budget gate (BL-94 / W5) | catalog | Fail-closed resource budgets for sparse Pauli/compile construction and dense Hilbert-space allocations. Product catalogue + probe over the low-level guards in compile_budget and dense_budget (same estimate formulas; no silent diverging |
| Results | primary nav | Kuramoto-XY simulator, compiler, and hardware-evidence ledger for heterogeneous-frequency coupled oscillators. |
| RL research governance | primary nav | BL-102 keeps reinforcement-learning-adjacent code in an explicit, reproducible research lane. It does not turn witness search or pulse optimisation into a production controller. |
| Rust Acceleration Engine | primary nav | scpn_quantum_engine is an optional PyO3 extension module that accelerates hot-path computations. All Python modules transparently fall back to pure Python/NumPy when the Rust engine is not installed. |
| Scorecard acceptance engine (BL-56 / W1) | catalog | Fail-closed promotion surface for the eleven differentiable baseline-scorecard categories. Honest behind_baseline inventory is the default until claim-ledger and external-comparison evidence packages exist. |
| Sparse Hamiltonian Construction | catalog | scpn_quantum_control.bridge.sparse_hamiltonian |
| Stable Core Backend Capability Matrix | primary nav | This generated page records stable backend capability profiles. |
| Stable Core Contract Fixtures | catalog | These no-QPU, no-network fixtures lock stable core contract payloads. |
| Stable Core Preflight Fixtures | primary nav | These no-QPU, no-network fixtures lock stable core preflight branches. |
| HAL Status Normalisation Policy | catalog | This document defines the frozen canonical status contract for hardware HAL adapters. Any alias change is a contract change and must follow the evidence gate below. |
| Strategic Roadmap — Post-v1.0 Differentiation | primary nav | > Canonical status note (2026-05-06): active task selection is > consolidated in ROADMAP.md. This document remains the detailed > deferred/CEO-gated strategic catalogue; items here are not activated > unless copied into the canonical wo |
| Studio Executive Actions | primary nav | The QUANTUM studio is an executive tool, not only a federation publisher. The Studio Federation surface is the informative layer the SCPN-STUDIO hub ingests; the executive spine described here is the layer that actually runs a verb, |
| Studio Federation | primary nav | The QUANTUM Studio federation surface has two layers: |
| Symmetry-Aware Exact Diagonalisation | catalog | Three modules exploit symmetries of the XY Hamiltonian to reduce the Hilbert space dimension for exact diagonalisation (ED): |
| GUESS: Guiding Extrapolations from Symmetry Decays | catalog | Physics-informed zero-noise extrapolation using Hamiltonian symmetry observables to guide the mitigation of target observables on NISQ hardware. |
| Symmetry- and Sector-Aware Mitigation Compiler | primary nav | This page defines the bounded first contract for the mitigation compiler lane. The current implementation is a planner, not a circuit transformer. It decides whether existing primitives are eligible for a Kuramoto/XY experiment descriptor a |
| Symmetry-Sector Mitigation Planner Fixtures | primary nav | These no-QPU fixtures lock the planner contract before execution-path integration. |
| Kuramoto Chain n=8 Synchronisation Benchmark | primary nav | This no-QPU artefact records schema-compatible reference rows for the canonical eight-node Kuramoto chain with decaying coupling. |
| Kuramoto Ring n=4 Synchronisation Benchmark | primary nav | This no-QPU artefact records schema-compatible reference rows for the canonical four-node Kuramoto-XY ring benchmark. |
| Standardised Synchronisation Benchmark Suite | primary nav | This suite defines canonical coupled-oscillator benchmark instances and a stable result schema. It is a contract for future backends, not a new hardware claim. |
| Tensor Network Methods | catalog | Two modules for tensor-network-based simulation of the Kuramoto-XY system: |
| Test Infrastructure | primary nav | scpn-quantum-control has a CI-gated test suite with a 90% aggregate line coverage requirement. CI now collects branch arcs in the same run and requires real branch opportunity data, but the branch percentage remains observational until |
| Theoretical Foundations | primary nav | The Scale-Coupled Phase Network (SCPN) and its quantum simulation. |
| Theory-Hook Promotion Matrix | primary nav | BL-98 distinguishes a useful research routine from an admitted product or control capability. Importability is not promotion. Every reviewed hook has a machine-readable tier, one permitted role, explicit forbidden claims, and a small local |
| Multi-language Kuramoto tier benchmark — CI vs local | primary nav | Per-call P50 latency (microseconds) of every registered Kuramoto compute primitive across the Rust, Julia, and Python tiers, measured by scripts/bench_kuramoto_tiers.py. The canonical column is the fixed CI runner (Rust engine built fro |
| TN/MPS Baseline Design | primary nav | This is the QWC-4.2 design artifact for the N=30-40 tensor-network baseline path. It is planning and preregistration evidence only. |
| TN/MPS Crossover Stage-1 Gate | primary nav | This QWC-5.1 artifact admits the larger-than-16-node N=30-40 tensor-network crossover row format before any owner-gated compute run. |
| Topology-Aware Quantum Kernel | primary nav | BL-88 provides a bounded local product for asking one precise question: does an edge-aligned XY feature map retain the inductive bias of a declared coupling graph strongly enough to reproduce labels generated by that same kernel? |
| Issue Triage Policy | catalog | This document describes how issues and pull requests are routed, prioritised and closed in scpn-quantum-control. It exists so that a first-time contributor knows when to expect a response and what a given label means. |
| Pulse → UltraScale+ HLS Code Generation | primary nav | scpn_quantum_control.codegen.ultrascale_hls converts a quantum control pulse waveform — the output of phase/pulse_shaping.py — into a manifest-bound Vivado/Vitis HLS source artifact for AMD Xilinx Zynq UltraScale+ devices. The artifact is a |
| Unsuitable-scenario + anti-silent-wrong registry (BL-53) | catalog | This page is the operator-facing guide for the negative-space governance product under BL-53: a versioned catalogue of scenarios that must fail closed rather than silently produce wrong gradients. |
| Variational Methods: Parameter-Shift Gradient Rule | primary nav | scpn_quantum_control.phase.param_shift |
| Wirtinger (CR) Calculus | primary nav | scpn_quantum_control.wirtinger_calculus provides the complex-derivative surface that the registered Phase-QNode engine deliberately leaves fail-closed. The Phase-QNode differentiates real rotation angles, so its complex-derivative contr |
| Automated Kuramoto Witness Discovery | primary nav | scpn_quantum_control.analysis.witness_discovery runs a replayable search over Kuramoto control candidates and scores each candidate with synchronisation witnesses. It is intended for small simulator sweeps and QPU pre-screening: find the pa |
| XY-Optimised Circuit Compiler | catalog | scpn_quantum_control.phase.xy_compiler |