Complete Python module and API catalog¶
This static catalog makes every ordinary Python module and every public module-level class or function discoverable without importing optional provider, accelerator, or scientific dependencies.
- 697 modules across 39 package families
- 3908 documented public module-level symbols
- 841 root-package exports governed by the stable API surface
The catalog is an inventory, not a stability or product claim. Start with the API selection guide and stable facades. Advanced modules may require optional extras and may be research-only.
How to use this catalog¶
Search for a module, class, function, or domain term. Each module gives its source summary and exact source link. Symbol behavior, parameters, returns, exceptions, and boundaries live in the source docstrings rendered by the curated advanced autodoc reference.
analog_mapping¶
scpn_quantum_control.analog_mapping.calibrate¶
Analytic design-unit coupling-scale objective and drift sensitivity.
Source · Public symbols: 4
Classes: CalibrationEvaluation, CalibrationSensitivity
Functions: coupling_scale_objective(), calibration_sensitivity()
scpn_quantum_control.analog_mapping.compare¶
Bounded mathematical-model comparison against a Lie–Trotter reference.
Source · Public symbols: 2
Classes: AnalogDigitalComparison
Functions: compare_analog_model_to_trotter()
scpn_quantum_control.analog_mapping.contracts¶
Typed contracts for bounded analog oscillator mapping feasibility.
Source · Public symbols: 5
Classes: AnalogPlatformProfile, MappingRequest, FeasibilityDiagnostic, MappingResult, FeasibilityReport
scpn_quantum_control.analog_mapping.evidence¶
Deterministic BL-35 evidence bundle builder, renderer, and writer.
Source · Public symbols: 4
Classes: AnalogMappingEvidenceBundle
Functions: build_analog_mapping_evidence(), write_analog_mapping_evidence(), analog_mapping_markdown()
scpn_quantum_control.analog_mapping.feasibility¶
Fail-closed analog topology, control, range, and measurement diagnostics.
Source · Public symbols: 3
Functions: assess_mapping_feasibility(), classify_topology(), reconstruct_compiled_couplings()
scpn_quantum_control.analog_mapping.platforms¶
Load and validate the packaged static analog platform catalogue.
Source · Public symbols: 2
Functions: load_platform_profiles(), platform_profile()
analysis¶
scpn_quantum_control.analysis.adaptive_fim_evidence¶
Digest-bound calibration controls and offline FIM custody replay.
Source · Public symbols: 8
Functions: canonical_adaptive_fim_json(), historical_replay_witnesses(), synthetic_calibration_witnesses(), adaptive_fim_evidence_payload(), validate_adaptive_fim_evidence(), render_adaptive_fim_evidence_markdown(), write_adaptive_fim_evidence(), main()
scpn_quantum_control.analysis.adaptive_fim_feedback¶
Uncertainty-aware, policy-bounded adaptive FIM batch proposals.
Source · Public symbols: 13
Classes: AdaptiveFIMConfig, FIMWitness, BinomialInterval, AdaptiveFIMStep, AdaptiveFIMObserverRecord, AdaptiveFIMPlan
Functions: wilson_score_interval(), propose_next_lambda(), propose_count_aware_lambda(), adaptive_lambda_schedule(), adaptive_count_aware_schedule(), plan_adaptive_fim_schedule(), observer_record_from_step()
scpn_quantum_control.analysis.berry_phase¶
Finite-size Berry diagnostics for exact Kuramoto-XY ground-state scans.
Source · Public symbols: 2
Classes: BerryPhaseResult
Functions: berry_phase_scan()
scpn_quantum_control.analysis.bkt_analysis¶
BKT phase transition analysis for Kuramoto-XY systems.
Source · Public symbols: 6
Classes: BKTResult
Functions: coupling_laplacian(), fiedler_eigenvalue(), estimate_t_bkt(), bkt_analysis(), scan_synchronization_transition()
scpn_quantum_control.analysis.bkt_universals¶
BKT universal amplitude-ratio audit: p_h1 = 0.72 remains an open question.
Source · Public symbols: 3
Classes: UniversalCheckResult, BKTUniversalsSummary
Functions: check_all_candidates()
scpn_quantum_control.analysis.critical_concordance¶
Finite-size critical-probe concordance for exact Kuramoto-XY scans.
Source · Public symbols: 2
Classes: ConcordanceResult
Functions: critical_concordance()
scpn_quantum_control.analysis.dla_parity_exact_baseline¶
Exact, noiseless statevector reference for the DLA-parity XY-Trotter circuits.
Source · Public symbols: 6
Classes: ExactBaselineRow
Functions: coupling_matrix(), initial_parity(), build_statevector_circuit(), exact_parity_leakage(), exact_baseline_grid()
scpn_quantum_control.analysis.dla_parity_theorem¶
DLA parity theorem for the heterogeneous XY Hamiltonian.
Source · Public symbols: 9
Classes: DLAParityTheoremResult
Functions: predicted_dla_dimension(), parity_sector_dimensions(), su_dimension(), verify_theorem(), verify_all_known(), parity_operator(), project_to_parity_sector(), decompose_state_by_parity()
scpn_quantum_control.analysis.dla_parity_witness¶
DLA parity witness observable for bitstring-count analyses.
Source · Public symbols: 1
Classes: DLAParityWitness
scpn_quantum_control.analysis.dla_truncated_tn¶
Fail-fast interface for future DLA-truncated tensor-network simulations.
Source · Public symbols: 1
Functions: dla_truncated_tn()
scpn_quantum_control.analysis.dynamical_lie_algebra¶
Dynamical Lie algebra (DLA) computation for Hamiltonian simulability analysis.
Source · Public symbols: 8
Classes: DLAResult
Functions: compute_dla(), compute_dla_rust(), build_xy_generators(), build_ssgf_generators(), build_pgbo_generators(), build_tcbo_generators(), build_full_scpn_generators()
scpn_quantum_control.analysis.enaqt¶
Bounded environment-assisted quantum transport (ENAQT) simulation.
Source · Public symbols: 2
Classes: ENAQTResult
Functions: enaqt_scan()
scpn_quantum_control.analysis.enaqt_evidence¶
Deterministic, digest-bound evidence for the bounded BL-87 ENAQT scan.
Source · Public symbols: 8
Classes: ENAQTScenario
Functions: frozen_enaqt_scenarios(), canonical_enaqt_json(), enaqt_evidence_payload(), validate_enaqt_evidence(), render_enaqt_evidence_markdown(), write_enaqt_evidence(), main()
scpn_quantum_control.analysis.entanglement_enhanced_sync¶
Compare initial-state coherence under bounded Kuramoto-XY evolution.
Source · Public symbols: 11
Classes: InitialState, SyncTrajectory, InitialStateControlComparison
Functions: prepare_initial_state(), local_phase_observables(), transverse_exchange_coherence(), mean_single_qubit_linear_entropy(), simulate_sync_trajectory(), compare_all_initial_states(), compare_initial_states_with_dephased_controls(), entanglement_advantage()
scpn_quantum_control.analysis.entanglement_entropy¶
Entanglement entropy and Schmidt gap at the synchronization transition.
Source · Public symbols: 4
Classes: EntanglementResult, EntanglementScanResult
Functions: entanglement_at_coupling(), entanglement_vs_coupling()
scpn_quantum_control.analysis.entanglement_percolation¶
Finite-size entanglement percolation diagnostics vs synchronisation proxies.
Source · Public symbols: 4
Classes: PercolationScanResult
Functions: concurrence_map_exact(), fiedler_eigenvalue(), percolation_scan()
scpn_quantum_control.analysis.entanglement_spectrum¶
Entanglement spectrum analysis at the synchronization transition.
Source · Public symbols: 7
Classes: EntanglementResult
Functions: entanglement_entropy_half_chain(), entanglement_spectrum_half_chain(), entropy_vs_subsystem_size(), fit_cft_central_charge(), entanglement_analysis(), entropy_vs_coupling_scan()
scpn_quantum_control.analysis.entanglement_sync_evidence¶
Generate deterministic, digest-bound BL-79 initial-state evidence.
Source · Public symbols: 7
Functions: frozen_entanglement_sync_scenario(), canonical_entanglement_sync_json(), entanglement_sync_evidence_payload(), validate_entanglement_sync_evidence(), render_entanglement_sync_evidence_markdown(), write_entanglement_sync_evidence(), main()
scpn_quantum_control.analysis.fim_hamiltonian¶
Offline diagnostics for the FIM-augmented Kuramoto-XY Hamiltonian.
Source · Public symbols: 12
Classes: SpectrumSummary
Functions: computational_magnetisations(), fim_diagonal(), add_fim_feedback(), magnetisation_sector_indices(), summarise_spectrum(), sector_spectrum_rows(), adjacent_gap_ratio(), bipartite_entropy_from_statevector(), magnetisation_operator_diagonal(), commutator_frobenius_norm_with_diagonal(), sector_coupling_rows()
scpn_quantum_control.analysis.finite_size_scaling¶
Finite-size scaling for K_c extraction from small exact quantum systems.
Source · Public symbols: 3
Classes: FSSFitDiagnostics, FSSResult
Functions: finite_size_scaling()
scpn_quantum_control.analysis.graph_topology_scan¶
Graph topology → p_h1 systematic scan.
Source · Public symbols: 2
Classes: GraphP_H1_Result
Functions: scan_graph_topologies()
scpn_quantum_control.analysis.h1_persistence¶
Evaluate H1 persistence: p_h1 = 0.72 remains an open question.
Source · Public symbols: 2
Classes: H1PersistenceResult
Functions: scan_h1_persistence()
scpn_quantum_control.analysis.hamiltonian_learning¶
Bounded inverse fitting of K_nm from exact ground-state correlators.
Source · Public symbols: 3
Classes: HamiltonianLearningResult
Functions: measure_correlators(), learn_hamiltonian()
scpn_quantum_control.analysis.hamiltonian_self_consistency¶
Hamiltonian self-consistency loop: quantum measurement → K_nm recovery.
Source · Public symbols: 6
Classes: SelfConsistencyResult
Functions: correlators_from_counts(), correlator_shot_noise(), self_consistency_from_exact(), self_consistency_from_counts(), self_consistency_from_noisy_sim()
scpn_quantum_control.analysis.integrated_information_phi¶
Fail-closed interface for integrated-information requests.
Source · Public symbols: 1
Classes: IntegratedInformationPhi
scpn_quantum_control.analysis.koopman¶
Finite local Koopman-style closure for the Kuramoto model.
Source · Public symbols: 6
Classes: KoopmanResult
Functions: build_koopman_generator(), build_koopman_generator_rust(), koopman_analysis(), koopman_dimension(), koopman_to_hamiltonian()
scpn_quantum_control.analysis.krylov_complexity¶
Krylov complexity at the synchronization transition.
Source · Public symbols: 4
Classes: KrylovResult
Functions: lanczos_coefficients(), krylov_complexity(), krylov_vs_coupling()
scpn_quantum_control.analysis.lindblad_ness¶
Non-equilibrium steady state (NESS) of driven-dissipative Kuramoto-XY.
Source · Public symbols: 4
Classes: NESSResult, NESSScanResult
Functions: compute_ness(), ness_vs_coupling()
scpn_quantum_control.analysis.logical_sync_witness¶
Logical synchronisation witness backed by the DLA-protected QEC sector.
Source · Public symbols: 1
Classes: LogicalSyncWitness
scpn_quantum_control.analysis.loschmidt_echo¶
Loschmidt echo and dynamical quantum phase transitions.
Source · Public symbols: 3
Classes: LoschmidtResult
Functions: loschmidt_quench(), quench_scan()
scpn_quantum_control.analysis.magic_nonstabilizerness¶
Exact small-system stabilizer Rényi-2 diagnostics.
Source · Public symbols: 4
Classes: MagicResult, MagicScanResult
Functions: magic_at_coupling(), magic_vs_coupling()
scpn_quantum_control.analysis.magnetisation_sectors¶
U(1) symmetry exploitation for the XY Hamiltonian.
Source · Public symbols: 8
Functions: basis_by_magnetisation(), sector_dimensions(), largest_sector_dim(), project_to_sector(), build_sector_hamiltonian(), eigh_by_magnetisation(), level_spacing_by_magnetisation(), memory_estimate()
scpn_quantum_control.analysis.monte_carlo_xy¶
Monte Carlo simulation of the XY model on the K_nm graph.
Source · Public symbols: 6
Classes: MCResult, AHPResult, FiniteSizeResult
Functions: mc_simulate(), extract_a_hp(), finite_size_scaling()
scpn_quantum_control.analysis.otoc¶
Out-of-time-order correlator (OTOC) for quantum chaos detection.
Source · Public symbols: 3
Classes: OTOC, OTOCResult
Functions: compute_otoc()
scpn_quantum_control.analysis.otoc_sync_probe¶
OTOC as a synchronization transition probe.
Source · Public symbols: 3
Classes: OTOCSyncScanResult
Functions: otoc_sync_scan(), compare_otoc_vs_R()
scpn_quantum_control.analysis.p_h1_derivation¶
Negative-control audit: p_h1 = 0.72 remains an open question.
Source · Public symbols: 2
Classes: P_H1_Derivation
Functions: derive_p_h1()
scpn_quantum_control.analysis.p_h1_open_guard¶
Public-claim guard: p_h1 = 0.72 remains an open question.
Source · Public symbols: 5
Classes: P_H1OpenGuardViolation, P_H1OpenGuardReport
Functions: public_markdown_paths(), validate_p_h1_open_claim_text(), run_p_h1_open_guard()
scpn_quantum_control.analysis.pairing_correlator¶
Richardson-Gaudin pairing correlators in the synchronised state.
Source · Public symbols: 3
Classes: PairingResult
Functions: pairing_map(), pairing_vs_anisotropy()
scpn_quantum_control.analysis.persistent_homology¶
Persistent homology of oscillator phase configurations.
Source · Public symbols: 4
Classes: PersistenceResult
Functions: phase_distance_matrix(), compute_persistence(), p_h1_vs_temperature()
scpn_quantum_control.analysis.phase_diagram¶
Quantum Kuramoto phase diagram: K_c vs effective temperature.
Source · Public symbols: 8
Classes: PhaseBoundary, PhaseDiagramResult
Functions: critical_coupling_finite_graph(), critical_coupling_mean_field(), decoherence_temperature(), effective_temperature(), order_parameter_steady_state(), compute_phase_diagram()
scpn_quantum_control.analysis.qfi¶
Quantum Fisher Information for coupling parameter estimation.
Source · Public symbols: 3
Classes: QFIResult
Functions: compute_qfi(), qfi_gap_tradeoff()
scpn_quantum_control.analysis.qfi_criticality¶
QFI divergence at the synchronization critical point.
Source · Public symbols: 3
Classes: QFICriticalityResult
Functions: qfi_single_coupling(), qfi_vs_coupling()
scpn_quantum_control.analysis.qfi_geometric_crosscheck¶
Cross-validate the spectral QFI against the quantum-geometric-tensor route.
Source · Public symbols: 2
Classes: QFIGeometricCrosscheck
Functions: crosscheck_qfi_geometric()
scpn_quantum_control.analysis.qrc_phase_detector¶
Exact finite-size feature extraction for a QRC-style phase detector.
Source · Public symbols: 5
Classes: QRCPhaseResult
Functions: generate_training_data(), train_linear_readout(), classify(), qrc_phase_detection()
scpn_quantum_control.analysis.quantum_fisher_information¶
Quantum Fisher Information observable wrappers.
Source · Public symbols: 1
Classes: QuantumFisherInformation
scpn_quantum_control.analysis.quantum_mpemba¶
Quantum Mpemba effect in synchronization dynamics.
Source · Public symbols: 2
Classes: MpembaResult
Functions: mpemba_experiment()
scpn_quantum_control.analysis.quantum_persistent_homology¶
Persistent homology on quantum measurement data.
Source · Public symbols: 6
Classes: QuantumPHResult
Functions: correlation_matrix_from_counts(), correlation_to_distance(), quantum_persistent_homology(), compare_quantum_classical_ph(), ph_sync_scan()
scpn_quantum_control.analysis.quantum_phi¶
Minimum bipartite quantum mutual information from a density matrix.
Source · Public symbols: 6
Classes: PhiResult
Functions: von_neumann_entropy(), partial_trace(), mutual_information(), compute_quantum_phi(), phi_vs_coupling_scan()
scpn_quantum_control.analysis.quantum_speed_limit¶
Quantum speed limits for a bounded local-phase-order threshold.
Source · Public symbols: 3
Classes: QSLResult
Functions: compute_qsl(), qsl_vs_coupling()
scpn_quantum_control.analysis.research_lane_registry¶
Governed catalogue of the package's analysis and gauge research lanes.
Source · Public symbols: 13
Classes: ResearchLaneMaturity, ResearchLaneDiffHook, ResearchLaneClaimStatus, ResearchLaneRecord, ResearchLaneInventoryReport, ResearchLaneRegistryReport
Functions: list_research_lanes(), get_research_lane(), discover_research_lane_modules(), validate_research_lane_inventory(), assert_research_lane_inventory(), build_research_lane_registry_report(), render_research_lane_registry_markdown()
scpn_quantum_control.analysis.rl_discovery_agent¶
Compatibility wrapper for governed Kuramoto witness discovery.
Source · Public symbols: 1
Classes: RLDiscoveryAgent
scpn_quantum_control.analysis.rl_pulse_optimizer¶
Fail-fast, research-disabled interface for future RL pulse optimisation.
Source · Public symbols: 1
Classes: RLPulseOptimizer
scpn_quantum_control.analysis.rl_research_governance¶
Fail-closed governance for witness-search and pulse-optimisation research.
Source · Public symbols: 13
Classes: RLResearchLane, RLResearchGovernanceError, RLResearchPolicy, RLResearchDecision, RLSeedEvaluation, RLSeedSuiteReport
Functions: estimate_witness_evaluation_budget(), assess_rl_research(), assert_rl_research_allowed(), build_witness_seed_suite(), run_governed_witness_seed_suite(), build_rl_research_evidence_report(), render_rl_research_evidence_markdown()
scpn_quantum_control.analysis.sensing¶
No-submit S11 sync-order quantum-sensing readiness model.
Source · Public symbols: 9
Classes: QuantumSensingReadinessConfig, SensingGainRow, SensingGainScan, CriticalitySensingTail
Functions: metrological_gain_vs_k(), optimal_sensing_k(), qfi_criticality_sensing_tail(), quantum_sensing_payload(), quantum_sensing_markdown()
scpn_quantum_control.analysis.shadow_tomography¶
Classical shadow tomography for efficient state characterisation.
Source · Public symbols: 3
Classes: ShadowResult
Functions: estimate_pauli_expectation(), classical_shadow_estimation()
scpn_quantum_control.analysis.spectral_form_factor¶
Finite-size spectral form-factor and adjacent-gap diagnostics.
Source · Public symbols: 4
Classes: SFFResult, SFFScanResult
Functions: compute_sff(), sff_vs_coupling()
scpn_quantum_control.analysis.symmetry_sectors¶
Symmetry-aware exact diagonalisation for the XY Hamiltonian.
Source · Public symbols: 6
Functions: basis_indices_by_parity(), project_hamiltonian(), build_sector_hamiltonian(), eigh_by_sector(), level_spacing_by_sector(), memory_estimate_mb()
scpn_quantum_control.analysis.sync_entanglement_witness¶
The order parameter R as an entanglement witness.
Source · Public symbols: 6
Classes: EntanglementWitnessResult
Functions: R_separable_bound(), R_separable_bound_at_energy(), R_from_statevector(), detect_entanglement_from_R(), R_entanglement_scan()
scpn_quantum_control.analysis.sync_order_parameter¶
Z-basis synchronisation proxy observable for measurement counts.
Source · Public symbols: 1
Classes: SyncOrderParameter
scpn_quantum_control.analysis.sync_uncertainty¶
Shot-noise uncertainty quantification for synchronisation metrics.
Source · Public symbols: 5
Classes: UncertaintyInterval
Functions: order_parameter_estimate(), order_parameter_shot_noise(), order_parameter_bootstrap(), metric_bootstrap()
scpn_quantum_control.analysis.sync_witness¶
Quantum synchronization witness operators.
Source · Public symbols: 8
Classes: WitnessResult
Functions: correlation_witness_from_counts(), fiedler_witness_from_correlator(), fiedler_witness_from_counts(), topological_witness_from_correlator(), evaluate_all_witnesses(), calibrate_thresholds(), build_correlation_witness_operator()
scpn_quantum_control.analysis.tcbo_weighted_complex¶
Coupling-weighted simplicial complex for TCBO p_h1 reconstruction.
Source · Public symbols: 7
Classes: TCBOWeightedComplexResult, TCBOWeightedThresholdScan, TCBOWeightedReplayUncertainty
Functions: coupling_weighted_edge_matrix(), tcbo_weighted_complex(), tcbo_weighted_threshold_scan(), tcbo_weighted_uncertainty_replay()
scpn_quantum_control.analysis.theory_hook_promotion¶
Evidence-gated promotion records for experimental theory hooks.
Source · Public symbols: 11
Classes: TheoryHookTier, TheoryHookRole, TheoryHookStatus, TheoryHookPromotionRecord, TheoryHookEvidenceRecord, TheoryHookPromotionReport
Functions: list_theory_hook_promotions(), get_theory_hook_promotion(), run_theory_hook_evidence(), build_theory_hook_promotion_report(), render_theory_hook_promotion_markdown()
scpn_quantum_control.analysis.thermodynamic_witness¶
Thermodynamic witness observable for calibrated work samples.
Source · Public symbols: 1
Classes: ThermodynamicWitness
scpn_quantum_control.analysis.translation_symmetry¶
Translation symmetry exploitation for homogeneous Kuramoto-XY chains.
Source · Public symbols: 4
Functions: is_translation_invariant(), momentum_sectors(), momentum_sector_dimensions(), eigh_with_translation()
scpn_quantum_control.analysis.two_colour_schedule¶
Genuine width-2 hand scheduling of the 1-D XY-Trotter chain (audit AUD-7).
Source · Public symbols: 6
Functions: two_colour_edges(), build_two_colour_circuit(), build_sequential_circuit(), two_colour_parity_leakage(), two_qubit_depth(), depth_comparison()
scpn_quantum_control.analysis.vortex_binding¶
Vortex binding energy and Kosterlitz renormalization group.
Source · Public symbols: 6
Classes: VortexBindingResult
Functions: vortex_pair_energy(), vortex_pair_entropy(), vortex_free_energy(), kosterlitz_rg_step(), compute_vortex_binding()
scpn_quantum_control.analysis.witness_discovery¶
Automated Kuramoto witness discovery with Bayesian and bandit search.
Source · Public symbols: 7
Classes: WitnessSearchMode, WitnessCandidate, WitnessDiscoverySpec, WitnessDiscoveryEvaluation, WitnessDiscoveryResult
Functions: discover_kuramoto_witnesses(), score_witness_candidates()
scpn_quantum_control.analysis.xxz_phase_diagram¶
Finite-size XXZ anisotropy diagnostics for the XY-to-Heisenberg crossover.
Source · Public symbols: 4
Classes: AnisotropyScanResult, PhaseDiagramResult
Functions: scan_coupling_at_delta(), anisotropy_phase_diagram()
applications¶
scpn_quantum_control.applications.app_plugins¶
Application-specific plugin registry for benchmark datasets and workflows.
Source · Public symbols: 17
Classes: ApplicationPluginBenchmark, ApplicationPlugin, ApplicationPluginRegistry, EEGApplicationPlugin, PlasmaApplicationPlugin, PowerGridApplicationPlugin, FEPApplicationPlugin
Functions: eeg_application_plugin_factory(), plasma_application_plugin_factory(), power_grid_application_plugin_factory(), fep_application_plugin_factory(), get_application_plugin_registry(), discover_application_plugins(), get_application_plugin(), run_application_benchmark_suite(), load_application_dataset(), compile_application_problem()
scpn_quantum_control.applications.cross_domain¶
Cross-domain structural comparison for SCPN K_nm and domain matrices.
Source · Public symbols: 2
Classes: CrossDomainResult
Functions: run_cross_domain_validation()
scpn_quantum_control.applications.dataset_catalog¶
Packaged application benchmark datasets exposed as QPU data artifacts.
Source · Public symbols: 6
Classes: ApplicationBenchmarkDescriptor, ApplicationBenchmarkPrivacyAudit
Functions: list_application_benchmark_descriptors(), get_application_benchmark_descriptor(), load_application_benchmark_artifact(), audit_application_benchmark_privacy()
scpn_quantum_control.applications.disruption_classifier¶
Quantum disruption classifier for tokamak plasma.
Source · Public symbols: 5
Classes: DisruptionClassifierResult
Functions: generate_synthetic_disruption_data(), train_disruption_classifier(), predict_disruption(), run_disruption_benchmark()
scpn_quantum_control.applications.eeg_benchmark¶
EEG neural oscillator coupling benchmark.
Source · Public symbols: 3
Classes: EEGBenchmarkResult
Functions: eeg_coupling_matrix(), eeg_benchmark()
scpn_quantum_control.applications.eeg_classification¶
EEG state classification via structured VQE and quantum kernels.
Source · Public symbols: 3
Classes: EEGVQEResult
Functions: eeg_plv_to_vqe(), eeg_quantum_kernel()
scpn_quantum_control.applications.fmo_benchmark¶
FMO photosynthetic complex benchmark against SCPN coupling.
Source · Public symbols: 3
Classes: FMOBenchmarkResult
Functions: fmo_coupling_matrix(), fmo_benchmark()
scpn_quantum_control.applications.honesty_kits¶
Fail-closed claim and data boundaries for domain-facing applications.
Source · Public symbols: 9
Classes: ApplicationSupportStatus, ApplicationDataOrigin, DomainApplicationHonestyKit, ApplicationHonestyAuditReport
Functions: list_domain_application_honesty_kits(), get_domain_application_honesty_kit(), get_domain_application_honesty_kit_for_dataset(), build_application_honesty_audit_report(), render_application_honesty_audit_markdown()
scpn_quantum_control.applications.iter_benchmark¶
ITER synthetic data benchmark: tokamak MHD mode coupling.
Source · Public symbols: 3
Classes: ITERBenchmarkResult
Functions: iter_coupling_matrix(), iter_benchmark()
scpn_quantum_control.applications.josephson_array¶
Josephson junction array mapping for the self-simulation narrative.
Source · Public symbols: 4
Classes: JosephsonArrayParameters, JosephsonBenchmarkResult
Functions: jja_coupling_matrix(), josephson_benchmark()
scpn_quantum_control.applications.josephson_magnitude_study¶
Josephson-array K_nm magnitude-study preregistration.
Source · Public symbols: 5
Classes: JosephsonKnmCandidate, JosephsonMagnitudeGate, JosephsonMagnitudeStudyDesign
Functions: build_josephson_knm_magnitude_study_design(), render_josephson_knm_magnitude_study_markdown()
scpn_quantum_control.applications.power_grid¶
Power grid synchronisation benchmark using IEEE test cases.
Source · Public symbols: 5
Classes: PowerGridBenchmarkResult
Functions: ieee_14bus_susceptance_matrix(), ieee_14bus_admittance_coupling_matrix(), ieee_5bus_coupling_matrix(), power_grid_benchmark()
scpn_quantum_control.applications.qrc_baseline¶
QRC comparison helpers with a deterministic classical ESN baseline.
Source · Public symbols: 7
Classes: ClassicalESNReadoutResult, QRCBaselineComparison, QRCHoldoutComparison
Functions: classical_esn_feature_matrix(), classical_esn_ridge_regression(), compare_quantum_reservoir_to_esn(), compare_quantum_reservoir_to_esn_holdout()
scpn_quantum_control.applications.quantum_evs¶
Quantum-enhanced EVS (Emergent Value Signature) for CCW.
Source · Public symbols: 2
Classes: QuantumEVSResult
Functions: quantum_evs_enhance()
scpn_quantum_control.applications.quantum_kernel¶
Finite simulator fidelity kernels informed by oscillator coupling.
Source · Public symbols: 5
Classes: QuantumKernelResult
Functions: canonical_edge_pairs(), encode_topology_edge_features(), quantum_kernel_entry(), compute_kernel_matrix()
scpn_quantum_control.applications.quantum_reservoir¶
Quantum reservoir computing for exponential state space expansion.
Source · Public symbols: 4
Classes: ReservoirResult
Functions: reservoir_features(), reservoir_feature_matrix(), reservoir_ridge_regression()
scpn_quantum_control.applications.quantum_reservoir_product¶
Held-out synthetic QRC certificates and exact reservoir objectives.
Source · Public symbols: 6
Classes: ReservoirTaskKind, SyntheticReservoirDataset, ReservoirTrainingCertificate, ReservoirLinearObjective
Functions: generate_synthetic_reservoir_task(), certify_reservoir_training()
benchmark_harness¶
scpn_quantum_control.benchmark_harness.registry¶
Registry of public benchmark-harness families and readiness status.
Source · Public symbols: 3
Classes: BenchmarkFamily
Functions: list_benchmark_families(), benchmark_registry_payload()
scpn_quantum_control.benchmark_harness.synchronisation¶
Canonical synchronisation benchmark registry and schema.
Source · Public symbols: 3
Classes: SynchronisationBenchmarkInstance
Functions: list_synchronisation_benchmarks(), synchronisation_benchmark_registry_payload()
scpn_quantum_control.benchmark_harness.synchronisation_compare¶
Tolerance comparator for synchronisation benchmark result artefacts.
Source · Public symbols: 7
Classes: ObservableComparison
Functions: load_payload(), validate_payload_shape(), observable_index(), compare_payloads(), compare_files(), compare_default_artifacts()
scpn_quantum_control.benchmark_harness.synchronisation_runner¶
No-QPU runners for canonical synchronisation benchmark instances.
Source · Public symbols: 12
Classes: ObservableRow, BenchmarkResultRow
Functions: ring_coupling_matrix(), decaying_chain_coupling_matrix(), natural_frequencies(), kuramoto_order_parameter(), run_classical_reference(), xy_hamiltonian(), run_exact_reference(), dependency_lock(), run_kuramoto_ring_n4_linear_omega(), run_kuramoto_chain_n8_decay_omega()
benchmarks¶
scpn_quantum_control.benchmarks.advantage_protocol¶
Claim-bounded protocol for S2 scaling and advantage benchmarks.
Source · Public symbols: 5
Classes: ScalingBaseline, ScalingProtocol, ScalingRowValidation
Functions: validate_scaling_rows(), default_s2_scaling_protocol()
scpn_quantum_control.benchmarks.appqsim_protocol¶
AppQSim benchmarking protocol: standardised metrics for publication.
Source · Public symbols: 2
Classes: AppQSimMetrics
Functions: appqsim_benchmark()
scpn_quantum_control.benchmarks.classical_baselines¶
Documented classical baselines for Kuramoto-XY workflows.
Source · Public symbols: 6
Classes: ClassicalBaselineRun
Functions: available_baselines(), scipy_ode_baseline(), qutip_lindblad_baseline(), mps_tebd_baseline(), run_documented_classical_baselines()
scpn_quantum_control.benchmarks.closed_loop_publication_run¶
Reproducible software-in-the-loop closed-loop publication artifact.
Source · Public symbols: 7
Classes: FeedbackControllerLike, LatencyMeasurer, ControllerFactory, ClosedLoopRunConfig, ClosedLoopPublicationArtifact
Functions: dynamic_circuit_templates(), run_closed_loop_publication()
scpn_quantum_control.benchmarks.compiler_isolated_benchmark_evidence¶
Attachment-grade isolated benchmark evidence for compiler promotion gates.
Source · Public symbols: 5
Classes: CompilerIsolatedBenchmarkEvidenceFiles, CompilerIsolatedBenchmarkEvidence
Functions: build_compiler_isolated_benchmark_evidence(), render_compiler_isolated_benchmark_evidence_markdown(), write_compiler_isolated_benchmark_evidence()
scpn_quantum_control.benchmarks.coupling_recovery_evidence¶
Benchmark artefacts for bounded coupling time-series recovery.
Source · Public symbols: 4
Classes: CouplingRecoveryEvidenceArtifact
Functions: coupling_recovery_evidence_payload(), render_coupling_recovery_evidence_markdown(), write_coupling_recovery_evidence_artifact()
scpn_quantum_control.benchmarks.decisive_advantage_protocol¶
Single-decision benchmark protocol for the Kuramoto-XY advantage question.
Source · Public symbols: 6
Classes: DecisionCriterion, SubmissionGate, DecisionOutcome, DecisiveAdvantageProtocol
Functions: evaluate_decision(), default_decisive_advantage_protocol()
scpn_quantum_control.benchmarks.decisive_run_harness¶
Measured classical-baseline harness feeding the decisive-advantage gate.
Source · Public symbols: 9
Classes: DecisiveRunConfig, DecisiveRunArtifact
Functions: git_commit(), command_line(), dependency_versions(), dense_reference_row(), ode_row(), mps_row(), run_decisive_benchmark()
scpn_quantum_control.benchmarks.differentiable_catalyst_comparison¶
Catalyst compiler-workflow evidence boundaries for differentiable comparisons.
Source · Public symbols: 2
Classes: CatalystCompilerWorkflowComparison
Functions: catalyst_compiler_workflow_comparison()
scpn_quantum_control.benchmarks.differentiable_evidence¶
CI-only benchmark evidence metadata and artefact writers.
Source · Public symbols: 9
Classes: AcceleratorEvidenceMetadata, BenchmarkIsolationMetadata, DifferentiableBenchmarkEvidenceBundle
Functions: write_differentiable_benchmark_evidence_bundle(), capture_host_load(), read_cpu_governor(), read_cpu_frequency_mhz(), capture_accelerator_metadata(), infer_heavy_jobs_running()
scpn_quantum_control.benchmarks.differentiable_external_comparison¶
External framework comparison harness for bounded Phase-QNode claims.
Source · Public symbols: 5
Functions: run_differentiable_external_comparison_suite(), write_differentiable_external_comparison(), run_identical_circuit_gradient_comparison_suite(), write_identical_circuit_gradient_comparison(), external_comparison_failure_mode_rows()
scpn_quantum_control.benchmarks.differentiable_external_contracts¶
Immutable records and field vocabulary for external differentiable comparisons.
Source · Public symbols: 4
Classes: ExternalComparisonRow, ExternalComparisonArtifact, IdenticalCircuitGradientComparisonRow, IdenticalCircuitGradientComparisonArtifact
scpn_quantum_control.benchmarks.differentiable_hardening_gate¶
Per-slice differentiable-programming hardening gate.
Source · Public symbols: 4
Classes: DifferentiableHardeningGateCheck, DifferentiableBenchmarkClassificationCase, DifferentiableHardeningSliceGateResult
Functions: run_differentiable_hardening_slice_gate()
scpn_quantum_control.benchmarks.differentiable_isolated_benchmark_plan¶
Isolated benchmark batch plan for differentiable promotion evidence.
Source · Public symbols: 6
Classes: DifferentiableIsolatedBenchmarkPlanRow, DifferentiableIsolatedBenchmarkPlan, DifferentiableIsolatedBenchmarkPlanValidation
Functions: run_differentiable_isolated_benchmark_plan(), validate_differentiable_isolated_benchmark_plan(), render_differentiable_isolated_benchmark_plan_markdown()
scpn_quantum_control.benchmarks.differentiable_optimizer_convergence¶
Benchmark artefacts for ground-state optimizer convergence rows.
Source · Public symbols: 4
Classes: GroundStateOptimizerConvergenceArtifact
Functions: ground_state_optimizer_convergence_payload(), render_ground_state_optimizer_convergence_markdown(), write_ground_state_optimizer_convergence_artifact()
scpn_quantum_control.benchmarks.differentiable_programming¶
Deterministic differentiable-programming conformance benchmark cases.
Source · Public symbols: 3
Functions: run_differentiable_programming_benchmark_suite(), run_quantum_gradient_benchmark_suite(), run_differentiable_programming_external_reference_suite()
scpn_quantum_control.benchmarks.differentiable_programming_contracts¶
Dependency-light result contracts shared by differentiable benchmark suites.
Source · Public symbols: 3
Classes: DifferentiableProgrammingBenchmarkResult, DifferentiableProgrammingExternalReferenceResult, QuantumGradientBenchmarkResult
scpn_quantum_control.benchmarks.differentiable_programming_quantum¶
Quantum-gradient case builders for the differentiable conformance benchmark suite.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.benchmarks.gpu_baseline¶
GPU baseline comparison for quantum simulation.
Source · Public symbols: 8
Classes: GPUBaselineResult
Functions: statevector_memory_gb(), statevector_flops(), estimate_gpu_time(), estimate_qpu_time(), gate_count_xy_trotter(), gpu_baseline_comparison(), scaling_comparison()
scpn_quantum_control.benchmarks.hls_cosimulation_evidence¶
Hash-bound software co-simulation evidence for the pulse→HLS lane.
Source · Public symbols: 7
Classes: CosimulationRunner, CosimulationEvidence, HLSCosimulationConfig, HLSCosimulationHandoff
Functions: host_compiler_identity(), run_hls_cosimulation(), run_hls_cosimulation_handoff()
scpn_quantum_control.benchmarks.iqm_layout_transfer_benchmark¶
Benchmark harness for the IQM Garnet layout-transfer preregistration.
Source · Public symbols: 16
Classes: DepthParityResult, ArmPlan, SizeBlockPlan, LayoutTransferPlan
Functions: initial_bitstring(), exact_order_parameter(), coupling_map_from_calibration(), chain_swap_depth_provider(), naive_chain_layout(), optimised_initial_layout(), measured_physical_qubits(), per_qubit_one_probabilities(), per_qubit_readout_errors(), corrected_order_parameter(), depth_parity_gate(), build_layout_transfer_plan()
scpn_quantum_control.benchmarks.iqm_layout_transfer_per_size¶
Frozen FU-3 circuit matrix and decision-rule implementation.
Source · Public symbols: 4
Classes: PerSizeLayoutTransferPlan
Functions: build_per_size_layout_transfer_plan(), holm_adjusted_p_values(), analyse_per_size_counts()
scpn_quantum_control.benchmarks.isolated_host_readiness¶
Decide whether a host can produce isolated_affinity benchmark evidence.
Source · Public symbols: 3
Classes: HostReadiness
Functions: assess_host_readiness(), capture_host_readiness()
scpn_quantum_control.benchmarks.kuramoto_competitive_benchmark¶
Measured head-to-head comparison of our Kuramoto toolkit against external solvers.
Source · Public symbols: 2
Classes: KuramotoCompetitiveComparison
Functions: run_kuramoto_competitive_comparison()
scpn_quantum_control.benchmarks.kuramoto_competitive_types¶
Problem and row types shared by the competitive harness and its adapters.
Source · Public symbols: 3
Classes: KuramotoProblem, CompetitorRow
Functions: build_default_problem()
scpn_quantum_control.benchmarks.kuramoto_external_competitors¶
Real third-party solver adapters for the Kuramoto competitive comparison.
Source · Public symbols: 11
Functions: default_julia_runner(), default_dynamicalsystems_runner(), default_networkdynamics_runner(), default_scimlsensitivity_runner(), default_jitcdde_runner(), scipy_row(), julia_diffeq_row(), dynamicalsystems_row(), networkdynamics_row(), scimlsensitivity_row(), jitcdde_row()
scpn_quantum_control.benchmarks.kyma.dynamics¶
Differentiable Kuramoto RK4 integrator and order-parameter readout.
Source · Public symbols: 3
Functions: kuramoto_rhs(), integrate_kuramoto(), cluster_order_parameter()
scpn_quantum_control.benchmarks.kyma.models¶
The motif substrate, the parameter-matched MLP baseline, and the chance floor.
Source · Public symbols: 10
Functions: substrate_param_count(), substrate_init(), substrate_readout(), train_substrate(), mlp_hidden_for_match(), mlp_param_count(), mlp_init(), mlp_forward(), train_mlp(), chance_floor_accuracy()
scpn_quantum_control.benchmarks.kyma.probe¶
Train, evaluate, and aggregate the KYMA composition probe over seeds.
Source · Public symbols: 3
Classes: SeedResult
Functions: run_seed(), run_probe()
scpn_quantum_control.benchmarks.kyma.task¶
Cluster-pair relations, input encoding, and the compositional split.
Source · Public symbols: 7
Classes: ProbeConfig, TrialBatch
Functions: pair_members(), disjoint_conjunctions(), encode(), build_trials(), success_mask()
scpn_quantum_control.benchmarks.kyma_v2.ablations¶
Ablation models that each remove ONE of the two v2 fixes (KYMA v2.1 #1).
Source · Public symbols: 5
Functions: shared_param_count(), shared_init(), shared_final_phases(), train_shared(), shared_predict()
scpn_quantum_control.benchmarks.kyma_v2.baselines¶
Stronger non-oscillator baselines for the v2 task (KYMA v2.1 #2).
Source · Public symbols: 10
Functions: deep_mlp_param_count(), deep_mlp_init(), deep_mlp_logits(), train_deep_mlp(), deep_mlp_predict(), gnn_param_count(), gnn_init(), gnn_logits(), train_gnn(), gnn_predict()
scpn_quantum_control.benchmarks.kyma_v2.coupling¶
Assemble the per-trial gated coupling K_eff(code) (KYMA v2 fix 1).
Source · Public symbols: 6
Functions: ambient_matrix(), partners_for(), readout_bridge_matrix(), base_coupling_matrix(), assemble_coupling(), symmetrise()
scpn_quantum_control.benchmarks.kyma_v2.design¶
Fix the v2 design constants from teacher dynamics only — never a model's held-out accuracy (pre-registration §5).
Source · Public symbols: 4
Functions: single_relation_realisability(), non_separability_rate(), class_histogram(), select_config()
scpn_quantum_control.benchmarks.kyma_v2.dynamics¶
Differentiable Kuramoto RK4 integrator with a per-trial coupling matrix.
Source · Public symbols: 4
Functions: kuramoto_rhs_batched(), integrate_kuramoto_batched(), order_parameter(), phase_label()
scpn_quantum_control.benchmarks.kyma_v2.models¶
The trainable gated student substrate, a parameter-matched MLP baseline, and the chance floor.
Source · Public symbols: 12
Functions: substrate_param_count(), student_init(), student_final_phases(), train_student(), student_predict(), mlp_hidden_for_match(), mlp_param_count(), mlp_init(), mlp_logits(), train_mlp(), mlp_predict(), chance_floor_accuracy()
scpn_quantum_control.benchmarks.kyma_v2.probe¶
Train, evaluate, and aggregate the KYMA v2 composition probe over seeds.
Source · Public symbols: 3
Classes: SeedResultV2
Functions: run_seed(), run_probe()
scpn_quantum_control.benchmarks.kyma_v2.rigor¶
Orchestrate the four v2.1 supplementary analyses (ablations, stronger baselines, MLP convergence, leave-one-out) against the frozen v2 task.
Source · Public symbols: 4
Functions: run_ablations(), run_stronger_baselines(), mlp_convergence(), run_leave_one_out()
scpn_quantum_control.benchmarks.kyma_v2.task¶
Cluster-pair relations, gated-coupling masks, and the compositional split.
Source · Public symbols: 8
Classes: ProbeConfigV2, TrialBatchV2
Functions: pair_members(), in_phase_mask(), anti_phase_masks(), disjoint_conjunctions(), encode(), build_trials()
scpn_quantum_control.benchmarks.kyma_v2.teacher¶
The fixed gated-oscillator teacher that defines every trial's label.
Source · Public symbols: 4
Functions: teacher_gates(), teacher_final_phases(), teacher_labels(), label_batch()
scpn_quantum_control.benchmarks.layout_method_comparison¶
Honest comparison of layout methods for the Kuramoto XY-Trotter circuit.
Source · Public symbols: 10
Classes: RProvider, MetricsProvider, RoutedLayoutMetrics, MethodRow, LayoutComparisonConfig, LayoutComparisonArtifact
Functions: coupling_map_from_gate_errors(), ideal_xy_order_parameter(), routed_layout_metrics(), run_layout_method_comparison()
scpn_quantum_control.benchmarks.layout_relaxation_experiment¶
RESEARCH: the KT-4 preregistered seed-sweep experiment.
Source · Public symbols: 5
Classes: RelaxationExperimentInstance, InstanceOutcome, RelaxationExperimentArtifact
Functions: preregistered_instances(), run_layout_relaxation_experiment()
scpn_quantum_control.benchmarks.mps_baseline¶
MPS tensor network baseline for quantum advantage comparison.
Source · Public symbols: 6
Classes: MPSBaselineResult
Functions: required_bond_dimension(), mps_memory(), exact_memory(), quantum_advantage_n(), mps_baseline_comparison()
scpn_quantum_control.benchmarks.open_system_objective_evidence¶
Benchmark artefacts for bounded Lindblad and MCWF objectives.
Source · Public symbols: 4
Classes: OpenSystemObjectiveEvidenceArtifact
Functions: open_system_objective_evidence_payload(), render_open_system_objective_evidence_markdown(), write_open_system_objective_evidence_artifact()
scpn_quantum_control.benchmarks.quantum_advantage¶
Quantum vs classical scaling benchmark for Kuramoto Hamiltonian simulation.
Source · Public symbols: 5
Classes: AdvantageResult
Functions: classical_benchmark(), quantum_benchmark(), estimate_crossover(), run_scaling_benchmark()
scpn_quantum_control.benchmarks.reproducible_comparison¶
Deterministic head-to-head comparison of classical and quantum Kuramoto routes.
Source · Public symbols: 3
Classes: ComparisonMethodRow, ReproducibleKuramotoComparison
Functions: run_reproducible_kuramoto_comparison()
scpn_quantum_control.benchmarks.s3_design_protocol¶
Claim-bounded S3 pulse and ansatz design scoring protocol.
Source · Public symbols: 8
Classes: S3DesignCandidate, S3DesignRow, S3DesignProtocol
Functions: default_s3_design_protocol(), score_s3_candidates(), validate_s3_design_rows(), generate_s3_candidate_grid(), grid_s3_design_protocol()
scpn_quantum_control.benchmarks.sync_witness_evidence¶
Benchmark artefacts for bounded synchronisation-witness runs.
Source · Public symbols: 4
Classes: SyncWitnessEvidenceArtifact
Functions: sync_witness_evidence_payload(), render_sync_witness_evidence_markdown(), write_sync_witness_evidence_artifact()
scpn_quantum_control.benchmarks.tn_mps_baseline_design¶
CPU-first TN/MPS baseline design for S2 scaling follow-up.
Source · Public symbols: 5
Classes: TNBaselineAdapter, TNBaselineSizePlan, TNBaselineDesign
Functions: build_tn_mps_baseline_design(), render_tn_mps_baseline_design_markdown()
scpn_quantum_control.benchmarks.tn_mps_crossover_stage1¶
QWC-5.1 stage-1 gate for larger-than-16 TN/MPS crossover rows.
Source · Public symbols: 7
Classes: TNMPSCrossoverRowSchema, TNMPSCrossoverGate, TNMPSCrossoverStage1Report, TNMPSCrossoverRowValidation
Functions: build_tn_mps_crossover_stage1(), validate_tn_mps_crossover_rows(), render_tn_mps_crossover_stage1_markdown()
bridge¶
scpn_quantum_control.bridge.control_plasma_knm¶
Compatibility bridge for plasma-native Knm builders from scpn-control.
Source · Public symbols: 4
Functions: build_knm_plasma(), build_knm_plasma_spec(), build_knm_plasma_from_config(), plasma_omega()
scpn_quantum_control.bridge.fusion_core_frc¶
Calibrate the quantum FRC scheduler surrogate from a SCPN-FUSION-CORE run.
Source · Public symbols: 4
Classes: FRCEquilibriumLike, FusionCoreFRCCalibration
Functions: calibrate_frc_surrogate_from_equilibrium(), calibrate_frc_surrogate_from_inputs()
scpn_quantum_control.bridge.knm_hamiltonian¶
Knm coupling matrix -> Pauli Hamiltonian compiler.
Source · Public symbols: 8
Functions: omega_for_oscillators(), build_knm_paper27(), build_kuramoto_ring(), knm_to_xxz_hamiltonian(), knm_to_hamiltonian(), knm_to_sparse_matrix(), knm_to_dense_matrix(), knm_to_ansatz()
scpn_quantum_control.bridge.orchestrator_adapter¶
Adapters between scpn-phase-orchestrator state and quantum bridge artifacts.
Source · Public symbols: 1
Classes: PhaseOrchestratorAdapter
scpn_quantum_control.bridge.orchestrator_feedback¶
Orchestrator bidirectional feedback loop.
Source · Public symbols: 2
Classes: OrchestratorFeedback
Functions: compute_orchestrator_feedback()
scpn_quantum_control.bridge.phase_artifact¶
Shared phase-state artifact schema for SCPN classical/quantum interoperability.
Source · Public symbols: 3
Classes: LockSignatureArtifact, LayerStateArtifact, UPDEPhaseArtifact
scpn_quantum_control.bridge.qpu_data_artifact¶
QPU-ready oscillator artifact with provenance gates.
Source · Public symbols: 6
Classes: QPUDataArtifact
Functions: read_qpu_data_artifact(), write_qpu_data_artifact(), validate_qpu_data_artifact(), artifact_to_kuramoto_problem(), artifact_from_arrays()
scpn_quantum_control.bridge.sc_to_quantum¶
Bitstream probability <-> quantum rotation angle converters.
Source · Public symbols: 4
Functions: probability_to_angle(), angle_to_probability(), bitstream_to_statevector(), measurement_to_bitstream()
scpn_quantum_control.bridge.scpn_upde_edge¶
Bounded knm.scpn-upde edge payloads for SPO federation.
Source · Public symbols: 5
Classes: SCPNUPDEEdge
Functions: edge_content_digest(), build_scpn_upde_edge(), build_paper27_scpn_upde_edge(), validate_scpn_upde_edge_payload()
scpn_quantum_control.bridge.snn_adapter¶
SNN <> quantum bridge: spike trains to rotation angles, measurements to currents.
Source · Public symbols: 4
Classes: SNNQuantumBridge, ArcaneNeuronBridge
Functions: spike_train_to_rotations(), quantum_measurement_to_current()
scpn_quantum_control.bridge.snn_backward¶
SNN backward pass: Ry parameter-shift gradient through the quantum layer.
Source · Public symbols: 2
Classes: BackwardResult
Functions: parameter_shift_gradient()
scpn_quantum_control.bridge.sparse_hamiltonian¶
Sparse CSC/CSR Hamiltonian for large-N Kuramoto-XY systems.
Source · Public symbols: 4
Functions: build_sparse_hamiltonian(), build_sparse_sector_hamiltonian(), sparse_eigsh(), sparsity_stats()
scpn_quantum_control.bridge.spn_to_qcircuit¶
SPN topology -> quantum circuit compiler.
Source · Public symbols: 2
Functions: spn_to_circuit(), inhibitor_anti_control()
scpn_quantum_control.bridge.ssgf_adapter¶
SSGF <> quantum bridge: geometry matrices to Hamiltonians, states to circuits.
Source · Public symbols: 4
Classes: SSGFQuantumLoop
Functions: ssgf_w_to_hamiltonian(), ssgf_state_to_quantum(), quantum_to_ssgf_state()
scpn_quantum_control.bridge.ssgf_w_adapter¶
SSGF geometry W adaptation from quantum R_global.
Source · Public symbols: 2
Classes: WAdaptResult
Functions: adapt_w_from_quantum()
chimera_control¶
scpn_quantum_control.chimera_control.evidence¶
Deterministic BL-60 evidence construction, rendering, and byte custody.
Source · Public symbols: 6
Classes: ChimeraSupportRow, SyntheticRegimeEvidence, ChimeraMultiscaleEvidence
Functions: build_chimera_multiscale_evidence(), render_chimera_multiscale_markdown(), write_chimera_multiscale_evidence()
scpn_quantum_control.chimera_control.objectives¶
Differentiable hierarchy targets composed from existing analytic terms.
Source · Public symbols: 3
Classes: PhaseControlProposal
Functions: build_chimera_control_objective(), propose_phase_control_step()
scpn_quantum_control.chimera_control.observables¶
Hierarchy-aware order parameters composed from oscillatools diagnostics.
Source · Public symbols: 3
Classes: LevelOrderParameterSummary, MultiscaleOrderParameterReport
Functions: measure_multiscale_order_parameters()
scpn_quantum_control.chimera_control.schema¶
Immutable hierarchy and target contracts for synthetic chimera control.
Source · Public symbols: 6
Classes: SyntheticRegime, HierarchyLevel, MultiscaleHierarchy, HierarchyTarget, ChimeraControlSpecification
Functions: two_population_hierarchy()
scpn_quantum_control.chimera_control.synthetic¶
Exact finite-N two-population Kuramoto-Sakaguchi trajectory generation.
Source · Public symbols: 4
Classes: SyntheticChimeraConfig, SyntheticChimeraRun
Functions: build_two_population_coupling(), generate_two_population_chimera()
scpn_quantum_control.chimera_control.topology¶
Hierarchy summaries around the existing topology-constraint ledger.
Source · Public symbols: 3
Classes: HierarchyCouplingSummary, TopologyProjectionReport
Functions: project_chimera_coupling()
codegen¶
scpn_quantum_control.codegen.ultrascale_hls¶
Convert a quantum control pulse waveform into a Vivado/Vitis HLS bundle.
Source · Public symbols: 9
Classes: HLSBundle, HLSArtifactFile, HLSArtifactManifest, HLSArtifactVerification
Functions: quantise_q_format(), pulse_to_vivado_hls(), emit_versioned_hls_artifact(), verify_hls_artifact_manifest(), write_bundle()
codesign¶
scpn_quantum_control.codesign.adapters¶
BL-33 adapters over BL-67 control ports and BL-68/69/70 observers.
Source · Public symbols: 6
Classes: ControlAdapterEvidence
Functions: observer_inputs_from_products(), adaptive_fim_proposal_port(), consume_realtime_feedback_port(), consume_qaoa_mpc_port(), consume_cosimulation_port()
scpn_quantum_control.codesign.components¶
Deterministic estimator, evaluator, and controller components for BL-33.
Source · Public symbols: 5
Classes: ExponentialOrderEstimator, OpenSystemObjectiveConfig, PhaseObjectiveSimulator, GradientFeedbackController
Functions: component_claim_boundary()
scpn_quantum_control.codesign.contracts¶
Immutable contracts for the simulator-first BL-33 co-design loop.
Source · Public symbols: 18
Classes: CoDesignMode, SafetyAction, StaleGradientAction, BackendCapabilities, LoopStepInput, StateEstimate, GradientPlanRecord, QuantumEvaluation, ControllerProposal, LatencyDecision, SafetyDecision, ObserverInputs, LoopStepOutput, PlasmaObjectiveTemplate, StateEstimatorPort, QuantumEvaluationPort, ControllerPort
Functions: plasma_objective_templates()
scpn_quantum_control.codesign.evidence¶
Functional non-isolated evidence writer for the bounded BL-33 workflow.
Source · Public symbols: 7
Classes: FunctionalEvidence
Functions: build_demo_loop(), demo_inputs(), run_functional_evidence(), write_functional_evidence(), validate_functional_evidence(), main()
scpn_quantum_control.codesign.loop¶
Thin deterministic orchestration over BL-33 estimator and policy ports.
Source · Public symbols: 1
Classes: CoDesignLoop
scpn_quantum_control.codesign.policies¶
Fail-closed latency and controller-envelope policies for BL-33.
Source · Public symbols: 2
Classes: LatencyPolicy, SafetyEnvelope
scpn_quantum_control.codesign.replay¶
Versioned trace recording and bit-stable replay verification for BL-33.
Source · Public symbols: 3
Classes: ReplayTrace
Functions: record_replay_trace(), verify_replay_trace()
compiler¶
scpn_quantum_control.compiler.alias_activity_evidence¶
Compiler alias-activity evidence assembled from Program AD lattice reports.
Source · Public symbols: 4
Classes: CompilerAliasActivityCase, CompilerAliasActivityEvidence
Functions: build_compiler_alias_activity_evidence(), render_compiler_alias_activity_evidence_markdown()
scpn_quantum_control.compiler.mlir¶
Stable MLIR compiler facade over focused implementation leaves.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.compiler.mlir_enzyme_audit¶
Enzyme/MLIR toolchain probing and bounded maturity aggregation.
Source · Public symbols: 1
Functions: run_enzyme_mlir_maturity_audit()
scpn_quantum_control.compiler.mlir_enzyme_evidence¶
Evidence records and builders for the Enzyme/MLIR compiler-AD maturity surface.
Source · Public symbols: 15
Classes: EnzymeMLIRCompilerADBreadthArtifactFiles, EnzymeMLIRToolchainStatus, EnzymeNativeExecutionEvidence, MLIRLLVMCorrectnessEvidence, EnzymeMLIRBenchmarkAttachment, EnzymeMLIRCompilerADBreadthCaseEvidence, EnzymeMLIRCompilerADBreadthArtifact, EnzymeMLIRCompilerADBreadthEvidence, EnzymeMLIRMaturityAuditResult
Functions: build_enzyme_mlir_benchmark_attachment(), build_enzyme_mlir_compiler_ad_breadth_artifact(), build_enzyme_mlir_compiler_ad_breadth_gap_artifact(), build_enzyme_mlir_compiler_ad_breadth_evidence(), render_enzyme_mlir_compiler_ad_breadth_artifact_markdown(), write_enzyme_mlir_compiler_ad_breadth_artifact()
scpn_quantum_control.compiler.mlir_enzyme_execution_runner¶
Capture real Enzyme/LLVM reverse-mode AD execution evidence beyond scalar replay.
Source · Public symbols: 4
Classes: EnzymeToolchainADCase, EnzymeToolchainADExecutionEvidence
Functions: resolve_enzyme_toolchain(), run_enzyme_toolchain_execution_evidence()
scpn_quantum_control.compiler.mlir_executable_kernel¶
Executable compiler-AD kernel: batching, verification and custom-derivative lowering.
Source · Public symbols: 3
Classes: ExecutableCompilerADKernel
Functions: make_executable_ad_kernel_batching_rule(), compile_custom_derivative_rule_to_mlir()
scpn_quantum_control.compiler.mlir_llvm_jit_claim_gate¶
Promotion gate for native LLVM/JIT differentiable-programming claims.
Source · Public symbols: 4
Classes: LLVMJITClaimGate
Functions: build_llvm_jit_claim_gate(), llvm_jit_claim_gate_from_dict(), render_llvm_jit_claim_gate_markdown()
scpn_quantum_control.compiler.mlir_matrix_2x2_native_compilation¶
Native LLVM/JIT autodiff compilation for closed-form 2x2 dense linear algebra.
Source · Public symbols: 15
Functions: compile_matrix_2x2_determinant_ad_to_native_llvm_jit(), make_matrix_2x2_determinant_native_llvm_jit_lowering_rule(), make_matrix_2x2_determinant_native_llvm_jit_primitive_transform(), compile_matrix_2x2_inverse_ad_to_native_llvm_jit(), make_matrix_2x2_inverse_native_llvm_jit_lowering_rule(), make_matrix_2x2_inverse_native_llvm_jit_primitive_transform(), compile_matrix_2x2_solve_ad_to_native_llvm_jit(), make_matrix_2x2_solve_native_llvm_jit_lowering_rule(), make_matrix_2x2_solve_native_llvm_jit_primitive_transform(), compile_matrix_2x2_eigenvalues_ad_to_native_llvm_jit(), make_matrix_2x2_eigenvalues_native_llvm_jit_lowering_rule(), make_matrix_2x2_eigenvalues_native_llvm_jit_primitive_transform(), compile_matrix_2x2_eigensystem_ad_to_native_llvm_jit(), make_matrix_2x2_eigensystem_native_llvm_jit_lowering_rule(), make_matrix_2x2_eigensystem_native_llvm_jit_primitive_transform()
scpn_quantum_control.compiler.mlir_matrix_native_compilation¶
Native LLVM/JIT autodiff compilation for matrix primitives.
Source · Public symbols: 15
Functions: compile_matrix_vector_product_ad_to_native_llvm_jit(), make_matrix_vector_product_native_llvm_jit_lowering_rule(), make_matrix_vector_product_native_llvm_jit_primitive_transform(), compile_matrix_matrix_product_ad_to_native_llvm_jit(), make_matrix_matrix_product_native_llvm_jit_lowering_rule(), make_matrix_matrix_product_native_llvm_jit_primitive_transform(), compile_matrix_trace_ad_to_native_llvm_jit(), make_matrix_trace_native_llvm_jit_lowering_rule(), make_matrix_trace_native_llvm_jit_primitive_transform(), compile_matrix_frobenius_norm_squared_ad_to_native_llvm_jit(), make_matrix_frobenius_norm_squared_native_llvm_jit_lowering_rule(), make_matrix_frobenius_norm_squared_native_llvm_jit_primitive_transform(), compile_matrix_quadratic_form_ad_to_native_llvm_jit(), make_matrix_quadratic_form_native_llvm_jit_lowering_rule(), make_matrix_quadratic_form_native_llvm_jit_primitive_transform()
scpn_quantum_control.compiler.mlir_native_execution_evidence¶
Evidence records for executed native LLVM/JIT whole-program autodiff.
Source · Public symbols: 4
Classes: NativeWholeProgramADExecutionCase, NativeWholeProgramADExecutionEvidence
Functions: build_native_whole_program_ad_execution_evidence(), run_native_whole_program_ad_execution_evidence()
scpn_quantum_control.compiler.mlir_native_primitives¶
Low-level primitives shared by the matrix-JIT and whole-program native lowering paths.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.compiler.mlir_phase_qnode_runtime¶
Registered Phase-QNode MLIR lowering and verified runtime execution.
Source · Public symbols: 3
Classes: PhaseQNodeMLIRRuntimeExecutable
Functions: lower_phase_qnode_circuit_to_mlir(), compile_phase_qnode_circuit_to_mlir_runtime()
scpn_quantum_control.compiler.mlir_records¶
Value records for the MLIR compilation and compiler-AD lowering surface.
Source · Public symbols: 7
Classes: MLIRCompileConfig, MLIRModule, PrimitiveLoweringStatus, CompilerADTransformPlan, DifferentiableMLIRCompileConfig, CompilerADExecutableConfig, CompilerADKernelVerification
scpn_quantum_control.compiler.mlir_scalar_native_compilation¶
Native LLVM/JIT autodiff compilation for scalar primitives.
Source · Public symbols: 6
Functions: compile_scalar_quadratic_ad_to_native_llvm_jit(), make_scalar_quadratic_native_llvm_jit_lowering_rule(), compile_scalar_unary_elementwise_ad_to_native_llvm_jit(), make_scalar_unary_elementwise_native_llvm_jit_lowering_rule(), compile_scalar_binary_elementwise_ad_to_native_llvm_jit(), make_scalar_binary_elementwise_native_llvm_jit_lowering_rule()
scpn_quantum_control.compiler.mlir_symmetric_native_compilation¶
Native LLVM/JIT autodiff compilation for symmetric 2x2 primitives.
Source · Public symbols: 6
Functions: compile_symmetric_2x2_cholesky_ad_to_native_llvm_jit(), make_symmetric_2x2_cholesky_native_llvm_jit_lowering_rule(), make_symmetric_2x2_cholesky_native_llvm_jit_primitive_transform(), compile_symmetric_2x2_eigenvalues_ad_to_native_llvm_jit(), make_symmetric_2x2_eigenvalues_native_llvm_jit_lowering_rule(), make_symmetric_2x2_eigenvalues_native_llvm_jit_primitive_transform()
scpn_quantum_control.compiler.mlir_transform_plan_assembly¶
Compiler-AD transform-plan assembly and deterministic MLIR interchange.
Source · Public symbols: 2
Functions: build_compiler_ad_transform_plan(), compile_compiler_ad_transform_plan_to_mlir()
scpn_quantum_control.compiler.mlir_vector_native_compilation¶
Native LLVM/JIT autodiff compilation for vector primitives.
Source · Public symbols: 6
Functions: compile_vector_dot_ad_to_native_llvm_jit(), make_vector_dot_native_llvm_jit_lowering_rule(), make_vector_dot_native_llvm_jit_primitive_transform(), compile_vector_squared_norm_ad_to_native_llvm_jit(), make_vector_squared_norm_native_llvm_jit_lowering_rule(), make_vector_squared_norm_native_llvm_jit_primitive_transform()
scpn_quantum_control.compiler.mlir_whole_program_emitter¶
LLVM IR emitter engine for whole-program autodiff native lowering.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.compiler.mlir_whole_program_native¶
Native and MLIR lowering of whole-program autodiff traces.
Source · Public symbols: 11
Classes: ExecutableWholeProgramADBatchResult, WholeProgramADNativeLoweringReport, NativeWholeProgramADKernel, ExecutableWholeProgramADKernel
Functions: compile_whole_program_ad_trace_to_mlir(), compile_whole_program_ad_trace_to_executable(), compile_whole_program_ad_trace_to_native_llvm_jit(), native_whole_program_ad_linalg_support(), analyse_whole_program_ad_native_lowering(), native_whole_program_ad_compile_cache_stats(), clear_native_whole_program_ad_compile_cache()
scpn_quantum_control.compiler.mlir_workload_compilation¶
Kuramoto and custom-rule executable MLIR compilation.
Source · Public symbols: 5
Functions: compile_kuramoto_to_mlir(), compile_custom_derivative_rule_to_executable(), compile_registered_primitive_to_executable(), make_program_ad_linalg_matrix_power_executable_lowering_rule(), make_program_ad_linalg_multi_dot_executable_lowering_rule()
scpn_quantum_control.compiler.promotion_batch¶
Non-promotional compiler evidence batch assembly.
Source · Public symbols: 4
Classes: CompilerPromotionBatchEvidenceFile, CompilerPromotionBatch
Functions: build_compiler_promotion_batch(), render_compiler_promotion_batch_markdown()
control¶
scpn_quantum_control.control.adaptive_branching¶
S8 mid-circuit adaptive branching readiness model.
Source · Public symbols: 9
Classes: AdaptiveBranchingConfig, AdaptiveBranchDecision, AdaptiveBranchingReadiness
Functions: classify_branch_state(), build_adaptive_branch_table(), required_s8_dynamic_features(), estimate_branching_readiness(), s8_adaptive_branching_payload(), s8_adaptive_branching_markdown()
scpn_quantum_control.control.closed_loop_analysis¶
Control-theoretic analysis of the measurement-feedback synchronisation loop.
Source · Public symbols: 14
Classes: ResponseClass, ExecutionMode, ControlPerformance, ClosedLoopExecutionPolicy, ClosedLoopExecutionDecision, ClosedLoopControlEvidence, ClosedLoopLatencyBudget, ClosedLoopLatencyReport, ClosedLoopPublicationPackage
Functions: evaluate_closed_loop_policy(), analyse_closed_loop_response(), run_closed_loop_control(), measure_closed_loop_latency_budget(), build_closed_loop_publication_package()
scpn_quantum_control.control.frc_pulsed_qaoa¶
QAOA and classical optimisation of the FRC pulsed-shot scheduling cost.
Source · Public symbols: 5
Classes: FRCScheduleResult
Functions: enumerate_costs(), optimal_schedule(), classical_sqp_schedule(), solve_frc_pulsed_qaoa()
scpn_quantum_control.control.hardware_topological_optimizer¶
Hardware-in-the-Loop Topological Feedback.
Source · Public symbols: 1
Classes: HardwareTopologicalOptimizer
scpn_quantum_control.control.q_disruption¶
Quantum disruption classifier.
Source · Public symbols: 1
Classes: QuantumDisruptionClassifier
scpn_quantum_control.control.q_disruption_iter¶
ITER-specific disruption classifier with 11 physics-based features.
Source · Public symbols: 7
Classes: ITERFeatureSpec, DisruptionBenchmark
Functions: normalize_iter_features(), scpn_control_bridge_dependency_contract(), validate_scpn_control_bridge_dependency_contract(), generate_synthetic_iter_data(), from_fusion_core_shot()
scpn_quantum_control.control.qaoa_mpc¶
QAOA for MPC trajectory optimization.
Source · Public symbols: 1
Classes: QAOA_MPC
scpn_quantum_control.control.qaoa_pulsed_cost¶
Control-grade FRC pulsed-shot scheduling cost for QAOA-MPC.
Source · Public symbols: 4
Classes: FRCQAOAObjective, FRCPlasmaSurrogate
Functions: decode_schedule_to_field(), frc_pulsed_shot_cost()
scpn_quantum_control.control.qpetri¶
Quantum Petri nets with superposition-token dynamics for control systems.
Source · Public symbols: 3
Classes: QuantumPetriStepReport, QuantumPetriCampaignReport, QuantumPetriNet
scpn_quantum_control.control.realtime_feedback¶
Closed-loop Kuramoto-XY synchronisation feedback.
Source · Public symbols: 6
Classes: RealtimeFeedbackConfig, FeedbackStep, RealtimeSyncFeedbackController
Functions: build_monitored_feedback_circuit(), build_open_loop_feedback_control_circuit(), feedback_policy_numpy()
scpn_quantum_control.control.realtime_runtime¶
Deadline-aware realtime control runtime.
Source · Public symbols: 15
Classes: RealtimeClock, MonotonicRealtimeClock, VirtualRealtimeClock, RealtimeRuntimeConfig, RealtimeTickRecord, RealtimeRunResult, RealtimeSLAConfig, RealtimeSLAReport, CycleSample, SubMicrosecondReport, SubMicrosecondTracker
Functions: run_realtime_control_loop(), evaluate_realtime_sla(), enforce_realtime_sla(), summarise_cycle_samples()
scpn_quantum_control.control.structured_ansatz¶
Structured Kuramoto-XY ansatz construction helpers.
Source · Public symbols: 1
Classes: StructuredAnsatz
scpn_quantum_control.control.topological_optimizer¶
Topological Quantum Reinforcement Learning / Optimizer.
Source · Public symbols: 1
Classes: TopologicalCouplingOptimizer
scpn_quantum_control.control.vqls_gs¶
Residual-certified VQLS surface for a bounded Grad-Shafranov proxy.
Source · Public symbols: 2
Classes: VQLSGradShafranovResult, VQLS_GradShafranov
cosimulation¶
scpn_quantum_control.cosimulation.knm_partition¶
Split a K_nm coupling network into a quantum-strong core and classical bath.
Source · Public symbols: 3
Classes: ConservationReport, KnmPartition
Functions: partition_knm()
scpn_quantum_control.cosimulation.quantum_classical¶
Mean-field co-simulation of a quantum-strong core inside a classical bath.
Source · Public symbols: 2
Classes: CoSimulationResult
Functions: cosimulate()
crypto¶
scpn_quantum_control.crypto.entanglement_qkd¶
SCPN-QKD: Topology-authenticated quantum key distribution.
Source · Public symbols: 3
Functions: scpn_qkd_protocol(), correlator_matrix(), bell_inequality_test()
scpn_quantum_control.crypto.hierarchical_keys¶
SCPN layer hierarchy to key derivation tree.
Source · Public symbols: 9
Functions: derive_master_key(), derive_layer_key(), key_hierarchy(), verify_key_chain(), evolve_key_phases(), rotating_key_schedule(), group_key(), hmac_verify_key(), hmac_sign()
scpn_quantum_control.crypto.knm_key¶
K_nm coupling matrix to key material pipeline.
Source · Public symbols: 4
Functions: prepare_key_state(), extract_raw_key(), estimate_qber(), privacy_amplification()
scpn_quantum_control.crypto.ml_dsa¶
ML-DSA-65 module-lattice digital signatures, implemented from FIPS 204.
Source · Public symbols: 6
Classes: MLDSAKeyPair
Functions: ntt(), intt(), key_gen(), sign(), verify()
scpn_quantum_control.crypto.ml_dsa_seal¶
Post-quantum signing back-end for the studio honesty seal (WS-1).
Source · Public symbols: 2
Classes: MLDSAVerifier, MLDSASigner
scpn_quantum_control.crypto.noise_analysis¶
Security analysis under noise and eavesdropping.
Source · Public symbols: 6
Functions: depolarizing_channel(), amplitude_damping_single(), noisy_concurrence(), intercept_resend_qber(), devetak_winter_rate(), security_analysis()
scpn_quantum_control.crypto.percolation¶
Entanglement percolation analysis on K_nm coupling graph.
Source · Public symbols: 7
Functions: concurrence_map(), percolation_threshold(), active_channel_graph(), key_rate_per_channel(), robustness_random_removal(), robustness_targeted_removal(), best_entanglement_path()
scpn_quantum_control.crypto.pqc_trigger¶
Post-quantum (FIPS 204 ML-DSA-65) signer for high-voltage trigger commands.
Source · Public symbols: 4
Classes: PublicKey, PrivateKey, Signature, PqcTriggerSigner
scpn_quantum_control.crypto.topology_auth¶
Spectral fingerprint authentication for K_nm topology.
Source · Public symbols: 11
Functions: spectral_fingerprint(), normalized_laplacian_fingerprint(), verify_fingerprint(), topology_distance(), topology_commitment(), verify_commitment(), challenge_response_prove(), challenge_response_verify(), fingerprint_noise_tolerance(), row_hash_fingerprint(), verify_row_hash()
deployment¶
scpn_quantum_control.deployment.cloud_native¶
Deterministic cloud-native manifest generation.
Source · Public symbols: 4
Classes: ContainerResources, CloudDeploymentSpec, CloudManifestBundle
Functions: generate_cloud_manifests()
dla_parity¶
scpn_quantum_control.dla_parity.baselines¶
Classical (noiseless) leakage reference for the DLA-parity protocol.
Source · Public symbols: 4
Classes: ClassicalLeakagePoint, ClassicalLeakageReference
Functions: available_baselines(), compute_classical_leakage_reference()
scpn_quantum_control.dla_parity.dataset¶
DLA-parity dataset loader.
Source · Public symbols: 2
Classes: DatasetIntegrityError
Functions: load_dla_parity_dataset()
scpn_quantum_control.dla_parity.reproduce¶
Statistical re-computation of the DLA-parity published numbers.
Source · Public symbols: 6
Classes: ReproductionTolerance, FisherResult, ReproductionResult
Functions: recompute_parity_leakage(), compute_depth_summaries(), reproduce_statistics()
scpn_quantum_control.dla_parity.schema¶
Typed dataclasses for the DLA-parity dataset.
Source · Public symbols: 5
Classes: DlaParityCircuitMeta, DlaParityCircuit, DlaParityRun, DlaParityDataset, StatisticalSummary
dla_topology_control¶
scpn_quantum_control.dla_topology_control.evidence¶
Deterministic evidence custody for DLA/topology constrained control.
Source · Public symbols: 4
Classes: DlaTopologyControlEvidence
Functions: build_dla_topology_control_evidence(), render_dla_topology_control_markdown(), write_dla_topology_control_evidence()
scpn_quantum_control.dla_topology_control.objectives¶
Analytic synthetic objective inside a fixed DLA-parity sector.
Source · Public symbols: 2
Classes: ParityProtectedObjectiveEvaluation, ParityProtectedQuadraticObjective
scpn_quantum_control.dla_topology_control.optimizer¶
Deterministic projected-gradient loop for a synthetic parity-sector task.
Source · Public symbols: 4
Classes: ProjectedGradientConfig, ProjectedGradientStep, ParityProjectedOptimisationTrace
Functions: optimise_parity_protected_state()
scpn_quantum_control.dla_topology_control.parity¶
Linear parity-sector projection with exact JVP, VJP, and leakage gradient.
Source · Public symbols: 2
Classes: ParityLeakageEvaluation, ParitySectorProjector
scpn_quantum_control.dla_topology_control.projection¶
Fail-closed JVP/VJP contracts around the existing topology ledger.
Source · Public symbols: 4
Classes: TopologyProjectionDifferential
Functions: topology_projection_support(), topology_projection_jvp(), topology_projection_vjp()
scpn_quantum_control.dla_topology_control.schema¶
Immutable support contracts for DLA/topology-constrained control.
Source · Public symbols: 5
Classes: DifferentiabilityKind, ParitySector, UnsupportedDifferentiableConstraintError, ConstraintSupportRow, DifferentiabilityReport
entropy¶
scpn_quantum_control.entropy.fips_140_2¶
FIPS 140-2 Annex C power-up randomness tests on a 20 000-bit sample.
Source · Public symbols: 3
Classes: FipsHealthReport
Functions: fips_140_2_tests(), enforce_fips_140_2()
scpn_quantum_control.entropy.nist_sp800_22¶
NIST SP 800-22 Revision 1a statistical tests for (pseudo)random bit streams.
Source · Public symbols: 18
Classes: NistTestResult
Functions: as_bits(), frequency_test(), block_frequency_test(), runs_test(), longest_run_of_ones_test(), dft_spectral_test(), serial_test(), approximate_entropy_test(), cumulative_sums_test(), binary_matrix_rank_test(), non_overlapping_template_test(), overlapping_template_test(), maurers_universal_test(), berlekamp_massey(), linear_complexity_test(), random_excursions_test(), random_excursions_variant_test()
scpn_quantum_control.entropy.qrng_stream¶
Production streaming quantum random-number generator.
Source · Public symbols: 2
Classes: EntropyHealthReport, QRNGStream
scpn_quantum_control.entropy.quantum_source¶
Quantum measurement entropy sources for the QRNG streaming harness.
Source · Public symbols: 3
Classes: EntropyBackend, AerQuantumEntropySource
Functions: von_neumann_debias()
fep¶
scpn_quantum_control.fep.predictive_coding¶
Predictive coding across SCPN layers.
Source · Public symbols: 3
Classes: PredictiveCodingResult
Functions: hierarchical_prediction_error(), predictive_coding_step()
scpn_quantum_control.fep.variational_free_energy¶
Variational free energy computation for the SCPN.
Source · Public symbols: 5
Classes: FreeEnergyResult
Functions: kl_divergence_gaussian(), variational_free_energy(), evidence_lower_bound(), free_energy_gradient()
forecasting¶
scpn_quantum_control.forecasting.kuramoto_neural_operator¶
Backward-compatible re-export shim for the relocated Kuramoto neural operator.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.forecasting.multimodal_bridge¶
Bounded BL-37 composition into BL-68 sensing and BL-33 proposals.
Source · Public symbols: 4
Classes: ForecastActiveSensingBridge, ForecastControllerInitialisation
Functions: plan_forecast_active_sensing(), forecast_to_controller_initialisation()
scpn_quantum_control.forecasting.multimodal_forecaster¶
Classical reference forecasting over immutable BL-37 multimodal batches.
Source · Public symbols: 6
Classes: MultimodalPointForecast, DomainForecastAccuracy, ForecastAccuracyCertificate, MultimodalRidgeForecaster
Functions: fit_multimodal_ridge_forecaster(), evaluate_point_forecast()
scpn_quantum_control.forecasting.multimodal_report¶
Deterministic JSON and Markdown evidence for the bounded BL-37 product.
Source · Public symbols: 4
Classes: MultimodalSupportRow, MultimodalForecastingEvidence
Functions: render_multimodal_forecasting_markdown(), write_multimodal_forecasting_evidence()
scpn_quantum_control.forecasting.multimodal_schema¶
Immutable multimodal observation custody for bounded synthetic forecasts.
Source · Public symbols: 3
Classes: SyntheticDomainTag, MultimodalObservationBatch
Functions: assert_disjoint_batches()
scpn_quantum_control.forecasting.neural_operator_advantage¶
Evaluate whether the Kuramoto neural-operator surrogate beats direct simulation.
Source · Public symbols: 3
Classes: HeldOutFidelity, NeuralOperatorAdvantage
Functions: evaluate_neural_operator_advantage()
scpn_quantum_control.forecasting.neural_operator_cost_model¶
Host-independent operation-count model for the Kuramoto neural-operator surrogate.
Source · Public symbols: 9
Classes: SurrogateCostModel
Functions: rk4_right_hand_side_evaluations(), networked_force_flops(), rk4_step_flops(), direct_simulation_flops(), deeponet_forward_flops(), training_flops(), amortised_break_even_queries(), build_cost_model()
scpn_quantum_control.forecasting.partial_observation¶
Observed-phase and exact Kuramoto-residual scoring for BL-37 forecasts.
Source · Public symbols: 5
Classes: PartialObservationWeights, PartialObservationScore, PartialObservationBatchCertificate
Functions: evaluate_partial_observation_objective(), evaluate_partial_observation_batch()
scpn_quantum_control.forecasting.real_data_sync¶
Held-out synchronisation forecasting on observed or source-backed traces.
Source · Public symbols: 7
Classes: SynchronisationForecastDataset, ForecastModelRun, SynchronisationForecastBenchmarkResult
Functions: load_hardware_kuramoto_4osc_trace(), load_ieee5bus_sync_forecast_case(), run_real_data_sync_forecast_benchmark(), run_real_data_sync_forecast_suite()
scpn_quantum_control.forecasting.synthetic_multimodal¶
Deterministic simulation-only datasets for BL-37 forecast certificates.
Source · Public symbols: 3
Classes: SyntheticMultimodalConfig, SyntheticMultimodalDataset
Functions: generate_synthetic_multimodal_dataset()
scpn_quantum_control.forecasting.uncertainty¶
Split sample-level residual intervals for independent BL-37 trajectories.
Source · Public symbols: 7
Classes: ResidualIntervalCalibrator, MultimodalIntervalForecast, DomainIntervalCoverage, IntervalCoverageCertificate
Functions: fit_residual_interval_calibrator(), apply_residual_interval(), certify_interval_coverage()
gauge¶
scpn_quantum_control.gauge.cft_analysis¶
CFT central charge extraction at the XY critical point.
Source · Public symbols: 4
Classes: CFTResult
Functions: find_critical_coupling(), extract_central_charge(), cft_analysis()
scpn_quantum_control.gauge.confinement¶
Confinement-deconfinement transition in the U(1) Kuramoto gauge theory.
Source · Public symbols: 4
Classes: ConfinementResult
Functions: extract_string_tension(), confinement_analysis(), confinement_vs_coupling()
scpn_quantum_control.gauge.lattice_crosscheck¶
Joint confinement report: quantum Wilson loops vs classical U(1) lattice MC.
Source · Public symbols: 2
Classes: GaugeLatticeCrosscheck
Functions: crosscheck_confinement_on_lattice()
scpn_quantum_control.gauge.universality¶
BKT/noisy-Kuramoto universality class analysis.
Source · Public symbols: 5
Classes: UniversalityResult
Functions: correlation_vs_distance(), fit_correlation_exponent(), check_nelson_kosterlitz(), universality_analysis()
scpn_quantum_control.gauge.vortex_detector¶
Vortex density measurement for the Kuramoto-XY quantum model.
Source · Public symbols: 4
Classes: VortexResult
Functions: plaquette_vorticity(), measure_vortex_density(), vortex_density_vs_coupling()
scpn_quantum_control.gauge.wilson_loop¶
U(1) Wilson loop measurement on the Kuramoto-XY coupling graph.
Source · Public symbols: 3
Classes: WilsonLoopResult
Functions: wilson_loop_expectation(), compute_wilson_loops()
hardware¶
scpn_quantum_control.hardware._count_integrity¶
Shared strict count coercion utilities for hardware adapters.
Source · Public symbols: 6
Functions: strict_non_negative_count(), strict_integer_value(), strict_binary_bitstring_key(), strict_fixed_width_bitstring_key(), strict_provider_job_id(), strict_shot_conservation()
scpn_quantum_control.hardware._experiment_helpers¶
Shared helper functions used by experiment sub-modules.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.hardware.aggregators¶
First-class aggregator/provider route matrix for the hardware HAL.
Source · Public symbols: 5
Classes: AggregatorProviderRoute, ResolvedAggregatorProviderRoute
Functions: built_in_aggregator_provider_routes(), aggregator_provider_routes_for(), resolve_aggregator_provider_route()
scpn_quantum_control.hardware.analog_kuramoto¶
Native analog Kuramoto backend interface.
Source · Public symbols: 15
Classes: AnalogKuramotoPlatform, AnalogProviderTarget, AnalogCouplingTerm, AnalogDriveTerm, AnalogFeedbackTerm, AnalogKuramotoProgram, ProviderAnalogPayload, ProviderAnalogExecutionPlan, AnalogBackendCapabilities, AnalogKuramotoBackendProtocol, AnalogKuramotoBackend
Functions: compile_analog_kuramoto(), analog_kuramoto_factory(), export_provider_payload(), prepare_provider_execution_plan()
scpn_quantum_control.hardware.analog_native_readiness¶
No-submit S10 analog-native Kuramoto readiness model.
Source · Public symbols: 7
Classes: AnalogNativeReadinessConfig, AnalogNativePrimitiveComparison, AnalogProviderReadinessRow
Functions: compare_native_to_digital_primitives(), provider_readiness_rows(), analog_native_payload(), analog_native_markdown()
scpn_quantum_control.hardware.async_runner¶
Concurrent IBM job submission via asyncio.
Source · Public symbols: 2
Classes: AsyncJobHandle, AsyncHardwareRunner
scpn_quantum_control.hardware.backends¶
Plugin / backend extension API.
Source · Public symbols: 22
Classes: BackendProtocol, QuantumBackendDescriptor, BackendRegistrationError, BackendRegistry
Functions: get_registry(), register_backend(), unregister_backend(), get_backend(), describe_backend(), discover_backends(), list_backends(), list_quantum_backends(), describe_hal_backend_profile(), list_hal_backend_descriptors(), qiskit_ibm_factory(), qiskit_aer_factory(), cirq_factory(), braket_factory(), pennylane_factory(), iqm_factory(), analog_kuramoto_factory(), hybrid_digital_analog_factory()
scpn_quantum_control.hardware.circuit_cutting¶
Circuit cutting for scaling to 32-64 oscillators.
Source · Public symbols: 5
Classes: CircuitCuttingPlan
Functions: count_inter_partition_couplings(), optimal_partition(), circuit_cutting_plan(), scaling_analysis()
scpn_quantum_control.hardware.circuit_export¶
Export Kuramoto-XY Trotter circuits to multiple quantum platforms.
Source · Public symbols: 5
Functions: build_trotter_circuit(), to_qasm3(), to_cirq(), to_quil(), export_all()
scpn_quantum_control.hardware.cirq_adapter¶
Google Cirq backend adapter.
Source · Public symbols: 3
Classes: CirqResult, CirqRunner
Functions: is_cirq_available()
scpn_quantum_control.hardware.classical¶
Classical reference computations for hardware experiment comparison.
Source · Public symbols: 5
Functions: classical_kuramoto_reference(), classical_exact_diag(), classical_exact_evolution(), bloch_vectors_from_json(), classical_brute_mpc()
scpn_quantum_control.hardware.cutting_runner¶
Circuit cutting runner: execute partitioned simulations for N > 16.
Source · Public symbols: 2
Classes: CuttingRunResult
Functions: run_cutting_simulation()
scpn_quantum_control.hardware.dynq_layout_pass¶
Qiskit AnalysisPass adapter for the DynQ qubit mapper.
Source · Public symbols: 2
Classes: DynQLayoutPass
Functions: calibration_from_target()
scpn_quantum_control.hardware.error_aware_chain¶
Error-aware selection of 1-D nearest-neighbour qubit chains.
Source · Public symbols: 3
Classes: ChainSelection
Functions: select_error_aware_chain(), longest_error_aware_chain()
scpn_quantum_control.hardware.experiment_control¶
QAOA-MPC, UPDE snapshot, Bell test, correlator, and QKD experiments.
Source · Public symbols: 5
Functions: qaoa_mpc_4_experiment(), upde_16_snapshot_experiment(), bell_test_4q_experiment(), correlator_4q_experiment(), qkd_qber_4q_experiment()
scpn_quantum_control.hardware.experiment_dynamics¶
Kuramoto evolution experiments on quantum hardware.
Source · Public symbols: 4
Functions: kuramoto_4osc_experiment(), kuramoto_8osc_experiment(), kuramoto_4osc_trotter2_experiment(), sync_threshold_experiment()
scpn_quantum_control.hardware.experiment_mitigation¶
ZNE, dynamical decoupling, and noise characterisation experiments.
Source · Public symbols: 6
Functions: kuramoto_4osc_zne_experiment(), noise_baseline_experiment(), kuramoto_8osc_zne_experiment(), upde_16_dd_experiment(), zne_higher_order_experiment(), decoherence_scaling_experiment()
scpn_quantum_control.hardware.experiment_vqe¶
VQE and ansatz experiments on quantum hardware.
Source · Public symbols: 5
Functions: vqe_4q_experiment(), vqe_8q_experiment(), vqe_8q_hardware_experiment(), ansatz_comparison_hw_experiment(), vqe_landscape_experiment()
scpn_quantum_control.hardware.experiments¶
Concrete hardware experiments for IBM Quantum.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.hardware.fast_classical¶
High-performance sparse statevector engine.
Source · Public symbols: 1
Functions: fast_sparse_evolution()
scpn_quantum_control.hardware.feedback_capability_probe¶
No-submit capability probes for S1 feedback target selection.
Source · Public symbols: 5
Classes: BackendCapabilitySnapshot, FeedbackCapabilityDecision
Functions: required_s1_dynamic_features(), assess_feedback_backend_capability(), assess_feedback_backend_fleet()
scpn_quantum_control.hardware.feedback_dryrun¶
No-submit provider dry-run payloads for S1 feedback jobs.
Source · Public symbols: 5
Classes: FeedbackDryRunPayload
Functions: build_ibm_runtime_dry_run(), build_openqasm3_gate_dry_run(), build_analog_native_review_payload(), build_s1_feedback_dry_run_bundle()
scpn_quantum_control.hardware.feedback_hardware_scheduler¶
Approval-gated hardware scheduler boundary for S1 feedback jobs.
Source · Public symbols: 4
Classes: HardwareApprovalRecord, HardwareSubmissionRecord, ApprovalGatedFeedbackHardwareScheduler
Functions: hash_package_manifest()
scpn_quantum_control.hardware.feedback_loop¶
Cross-shot hybrid classical-quantum feedback orchestration.
Source · Public symbols: 10
Classes: FeedbackLoopConfig, FeedbackLoopLatencySLA, FeedbackCommand, FeedbackResult, FeedbackStepRecord, FeedbackScheduler, FeedbackObserver, FeedbackRunner, RealtimeControllerScheduler, ProportionalMetricObserver
scpn_quantum_control.hardware.feedback_provider_metadata¶
Provider metadata adapters for S1 no-submit capability probes.
Source · Public symbols: 2
Functions: snapshot_from_generic_metadata(), snapshot_from_qiskit_backend()
scpn_quantum_control.hardware.feedback_submission¶
Provider-neutral S1 feedback submission-readiness packaging.
Source · Public symbols: 9
Classes: FeedbackPlatformCapability, FeedbackBudgetEstimate, FeedbackCircuitSummary, PlatformReadiness, FeedbackSubmissionPackage
Functions: default_s1_platforms(), build_s1_feedback_submission_package(), summarise_feedback_circuit(), assess_platform_readiness()
scpn_quantum_control.hardware.gpu_accel¶
GPU acceleration via cupy for matrix-heavy quantum operations.
Source · Public symbols: 7
Functions: is_gpu_available(), gpu_device_name(), eigvalsh(), eigh(), expm(), matmul(), gpu_memory_free_mb()
scpn_quantum_control.hardware.hal¶
Provider-neutral hardware abstraction layer.
Source · Public symbols: 9
Classes: BackendCapabilities, BackendProfile, QuantumWorkload, QuantumJobRef, QuantumJobResult, QuantumBackend, LocalDeterministicSimulator, HardwareAbstractionLayer
Functions: built_in_backend_profiles()
scpn_quantum_control.hardware.hal_azure¶
Azure Quantum adapter for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 2
Classes: AzureQuantumHALAdapter
Functions: azure_openqasm3_to_workload()
scpn_quantum_control.hardware.hal_braket¶
Amazon Braket adapters for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 3
Classes: BraketLocalHALAdapter, BraketAwsHALAdapter
Functions: braket_circuit_to_workload()
scpn_quantum_control.hardware.hal_cirq¶
Local Cirq simulator adapter for the provider-neutral HAL.
Source · Public symbols: 2
Classes: CirqLocalHALAdapter
Functions: cirq_circuit_workload()
scpn_quantum_control.hardware.hal_dwave¶
Direct D-Wave Leap BQM adapter for the provider-neutral HAL.
Source · Public symbols: 2
Classes: DWaveLeapHALAdapter
Functions: dwave_bqm_workload()
scpn_quantum_control.hardware.hal_ionq¶
Direct IonQ Cloud adapter for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 2
Classes: IonQCloudHALAdapter
Functions: ionq_qis_workload()
scpn_quantum_control.hardware.hal_iqm¶
IQM Qiskit adapter for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 2
Classes: IQMHALAdapter
Functions: iqm_qiskit_workload()
scpn_quantum_control.hardware.hal_oqc¶
Direct OQC QCAAS adapter for the provider-neutral HAL.
Source · Public symbols: 2
Classes: OQCHALAdapter
Functions: oqc_openqasm3_workload()
scpn_quantum_control.hardware.hal_pasqal¶
Pasqal/Pulser adapter for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 2
Classes: PasqalPulserHALAdapter
Functions: pulser_sequence_workload()
scpn_quantum_control.hardware.hal_pennylane¶
PennyLane-backed adapter for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 2
Classes: PennyLaneDeviceHALAdapter
Functions: pennylane_gate_workload()
scpn_quantum_control.hardware.hal_qbraid¶
qBraid runtime adapter for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 2
Classes: QbraidRuntimeHALAdapter
Functions: qbraid_program_to_workload()
scpn_quantum_control.hardware.hal_qiskit¶
Qiskit-backed adapters for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 4
Classes: QiskitAerHALAdapter, QiskitRuntimeHALAdapter
Functions: qiskit_circuit_to_workload(), qiskit_circuit_to_qasm3_workload()
scpn_quantum_control.hardware.hal_quandela¶
Direct Quandela/Perceval adapter for the provider-neutral HAL.
Source · Public symbols: 2
Classes: QuandelaPercevalHALAdapter
Functions: quandela_perceval_workload()
scpn_quantum_control.hardware.hal_quantinuum¶
Quantinuum pytket adapter for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 2
Classes: QuantinuumCloudHALAdapter
Functions: quantinuum_tket_workload()
scpn_quantum_control.hardware.hal_quera_bloqade¶
QuEra Bloqade adapter for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 2
Classes: QuEraBloqadeHALAdapter
Functions: bloqade_ahs_workload()
scpn_quantum_control.hardware.hal_rigetti¶
Rigetti pyQuil adapter for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 2
Classes: RigettiQCSHALAdapter
Functions: rigetti_quil_workload()
scpn_quantum_control.hardware.hal_strangeworks¶
Strangeworks Compute adapter for :mod:scpn_quantum_control.hardware.hal.
Source · Public symbols: 2
Classes: StrangeworksComputeHALAdapter
Functions: strangeworks_program_to_workload()
scpn_quantum_control.hardware.hybrid_digital_analog¶
Hybrid digital-analog execution plans for Kuramoto-XY workloads.
Source · Public symbols: 9
Classes: HybridRoute, HybridCouplingAssignment, HybridCouplingPartition, HybridDigitalAnalogProgram, HybridDigitalAnalogBackendProtocol, HybridDigitalAnalogBackend
Functions: compile_hybrid_digital_analog(), hybrid_digital_analog_factory(), partition_kuramoto_couplings()
scpn_quantum_control.hardware.ibm_latency_probe¶
Helpers for IBM Runtime latency telemetry extraction and normalisation.
Source · Public symbols: 4
Functions: iso_utc_now(), parse_timestamp(), extract_job_telemetry(), derive_timing_windows()
scpn_quantum_control.hardware.iqm_backend¶
IQM backend adapter for Qiskit-compatible circuit execution.
Source · Public symbols: 5
Classes: IQMBackendConfig, IQMRunResult, IQMQuantumBackend
Functions: is_iqm_available(), iqm_factory()
scpn_quantum_control.hardware.iqm_lattice_calibration¶
IQM square-lattice calibration → Kuramoto layout-cost inputs.
Source · Public symbols: 5
Classes: LatticeCalibration, ChainRegion
Functions: lattice_calibration_from_backend(), enumerate_chain_regions(), best_chain_region()
scpn_quantum_control.hardware.jax_accel¶
JAX-accelerated exact dense quantum analysis.
Source · Public symbols: 5
Functions: is_jax_available(), is_jax_gpu_available(), jax_device_name(), eigensolve_batch_jax(), entanglement_scan_jax()
scpn_quantum_control.hardware.job_dossier¶
Standard documentation schema for submission-ready hardware jobs.
Source · Public symbols: 2
Classes: HardwareJobDossier
Functions: build_s1_feedback_job_dossier()
scpn_quantum_control.hardware.kuramoto_layout_cost¶
Kuramoto-XY-aware discrete cost model for qubit-layout selection.
Source · Public symbols: 6
Classes: DepthProvider, CostWeights, LayoutCost
Functions: dynq_mean_gate_fidelity(), routed_layout_depth(), kuramoto_layout_cost()
scpn_quantum_control.hardware.kuramoto_layout_optimiser¶
Discrete layout optimiser over the Kuramoto-XY-aware cost model.
Source · Public symbols: 3
Classes: LayoutSearchConfig, LayoutSearchResult
Functions: optimise_kuramoto_layout()
scpn_quantum_control.hardware.kuramoto_layout_relaxation¶
RESEARCH: Sinkhorn continuous relaxation of the Kuramoto layout search.
Source · Public symbols: 6
Classes: SinkhornRelaxationConfig, RelaxationSearchResult
Functions: sinkhorn_normalise(), coupling_graph_distances(), swap_distance_surrogate(), relax_kuramoto_layout()
scpn_quantum_control.hardware.noise_model¶
Heron r2 noise model for realistic local simulation.
Source · Public symbols: 1
Functions: heron_r2_noise_model()
scpn_quantum_control.hardware.openpulse_control¶
OpenPulse schedule construction and calibration workflow primitives.
Source · Public symbols: 10
Classes: OpenPulseWaveform, OpenPulseInstruction, OpenPulseSchedule, RabiCalibrationPoint, OpenPulseCalibrationWorkflow, RabiPiCalibrationEstimate
Functions: compile_hypergeometric_openpulse_schedule(), build_rabi_amplitude_calibration_workflow(), estimate_rabi_pi_amplitude(), schedule_to_qiskit_pulse()
scpn_quantum_control.hardware.pennylane_adapter¶
PennyLane backend adapter for cross-platform quantum execution.
Source · Public symbols: 3
Classes: PennyLaneResult, PennyLaneRunner
Functions: is_pennylane_available()
scpn_quantum_control.hardware.plugin_registry¶
Extensible plugin architecture for quantum backends.
Source · Public symbols: 1
Classes: PluginRegistry
scpn_quantum_control.hardware.provenance¶
Run-time provenance capture for hardware and simulator results.
Source · Public symbols: 1
Functions: capture_provenance()
scpn_quantum_control.hardware.provider_capability_cloud_adapters¶
No-submit metadata adapters for cloud and broker quantum provider routes.
Source · Public symbols: 6
Functions: snapshot_from_azure_target(), snapshot_from_braket_device(), snapshot_from_qiskit_runtime_backend(), snapshot_from_qbraid_device(), snapshot_from_strangeworks_backend(), normalize_calibration_timestamp()
scpn_quantum_control.hardware.provider_capability_core¶
Provider-neutral no-submit capability contracts and readiness decisions.
Source · Public symbols: 6
Classes: ProviderCapabilitySnapshot, ProviderCapabilityDecision, OpenPulseControlReadiness
Functions: build_openpulse_control_readiness(), probe_aggregator_provider_capability(), assess_provider_capability_snapshot()
scpn_quantum_control.hardware.provider_capability_discovery¶
No-submit provider metadata adapters and compatibility facade.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.hardware.provider_capability_gate_adapters¶
No-submit metadata adapters for direct gate-model provider routes.
Source · Public symbols: 5
Functions: snapshot_from_ionq_backend(), snapshot_from_iqm_backend(), snapshot_from_oqc_target(), snapshot_from_quantinuum_backend(), snapshot_from_rigetti_qcs()
scpn_quantum_control.hardware.provider_capability_normalization¶
Provider-independent metadata access and normalization primitives.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.hardware.provider_capability_specialized_adapters¶
No-submit metadata adapters for specialized quantum provider routes.
Source · Public symbols: 4
Functions: snapshot_from_dwave_solver(), snapshot_from_quera_bloqade(), snapshot_from_pasqal_target(), snapshot_from_quandela_processor()
scpn_quantum_control.hardware.provider_smoke¶
Metadata-only optional dependency smoke checks for HAL provider routes.
Source · Public symbols: 7
Classes: ProviderOptionalDependencyRow, AggregatorProviderOptionalDependencyRow, IsolatedProviderSmokeLane
Functions: provider_optional_dependency_matrix(), aggregator_provider_optional_dependency_matrix(), isolated_provider_smoke_lanes(), main()
scpn_quantum_control.hardware.pulse_feasibility¶
No-submit provider feasibility probes for S3 pulse schedules.
Source · Public symbols: 7
Classes: PulseProviderSnapshot, PulseScheduleSummary, PulseFeasibilityDecision
Functions: summarise_pulse_schedule(), assess_pulse_provider_feasibility(), assess_pulse_provider_fleet(), pulse_snapshot_from_metadata()
scpn_quantum_control.hardware.qasm_export¶
OpenQASM 3 circuit export for cross-platform portability.
Source · Public symbols: 4
Classes: QASMExportResult
Functions: export_trotter_qasm(), export_ansatz_qasm(), export_measurement_qasm()
scpn_quantum_control.hardware.qcvv¶
QCVV: Quantum Characterisation, Verification, and Validation.
Source · Public symbols: 6
Classes: QCVVResult
Functions: state_fidelity(), mirror_circuit_fidelity(), cross_entropy_score(), simulate_xeb(), qcvv_certify()
scpn_quantum_control.hardware.qiskit_compat¶
Qiskit version compatibility layer.
Source · Public symbols: 7
Functions: qiskit_version(), qiskit_major(), get_pauli_evolution_gate(), get_lie_trotter(), get_statevector(), get_sparse_pauli_op(), check_qiskit_compatibility()
scpn_quantum_control.hardware.qpu_result_pack_bridge¶
Emit a studio.qpu-result-pack.v1 unit from a live provider-neutral result.
Source · Public symbols: 3
Functions: raw_results_digest(), job_result_provenance(), qpu_result_pack_from_job()
scpn_quantum_control.hardware.qubit_mapper¶
DynQ-inspired qubit placement via quality-weighted community detection.
Source · Public symbols: 6
Classes: ExecutionRegion, QubitMappingResult
Functions: build_calibration_graph(), detect_execution_regions(), select_best_region(), dynq_initial_layout()
scpn_quantum_control.hardware.realtime_latency_scenarios¶
Dedicated realtime-control latency scenarios independent from S1 scientific batches.
Source · Public symbols: 4
Classes: RealtimeLatencyScenario
Functions: build_dynamic_feedback_circuit(), build_open_loop_reference_circuit(), default_realtime_latency_scenarios()
scpn_quantum_control.hardware.runner¶
IBM Quantum hardware runner.
Source · Public symbols: 2
Classes: JobResult, HardwareRunner
scpn_quantum_control.hardware.s1_feedback_ibm¶
S1 IBM paired-arm submission and raw-count conversion contracts.
Source · Public symbols: 9
Classes: S1FeedbackArmCircuit
Functions: build_s1_feedback_arm_circuits(), build_s1_xy_observable_arm_circuits(), binary_phase_synchrony_from_counts(), pauli_expectation_from_counts(), raw_count_package_from_feedback_results(), raw_count_package_from_xy_observable_results(), build_s1_arm_command(), run_ibm_sampler_arm()
scpn_quantum_control.hardware.trapped_ion¶
Representative trapped-ion noise model for cross-platform benchmarking.
Source · Public symbols: 2
Functions: trapped_ion_noise_model(), transpile_for_trapped_ion()
identity¶
scpn_quantum_control.identity.binding_spec¶
Arcane Sapience identity binding spec: 6-layer, 18-oscillator Kuramoto topology.
Source · Public symbols: 4
Functions: build_identity_attractor(), solve_identity(), quantum_to_orchestrator_phases(), orchestrator_to_quantum_phases()
scpn_quantum_control.identity.coherence_budget¶
Coherence budget calculator for identity quantum circuits.
Source · Public symbols: 2
Functions: fidelity_at_depth(), coherence_budget()
scpn_quantum_control.identity.entanglement_witness¶
Entanglement witness for disposition pairs via CHSH inequality.
Source · Public symbols: 2
Functions: chsh_from_statevector(), disposition_entanglement_map()
scpn_quantum_control.identity.ground_state¶
Identity attractor basin via VQE ground state analysis.
Source · Public symbols: 1
Classes: IdentityAttractor
scpn_quantum_control.identity.identity_key¶
Quantum identity fingerprint from coupling topology.
Source · Public symbols: 4
Functions: identity_fingerprint(), identity_fingerprint_from_binding_spec(), verify_identity(), prove_identity()
scpn_quantum_control.identity.robustness¶
Adiabatic robustness certificate for identity binding.
Source · Public symbols: 4
Classes: RobustnessCertificate
Functions: compute_robustness_certificate(), perturbation_fidelity(), gap_vs_perturbation_scan()
l16¶
scpn_quantum_control.l16.director_contracts¶
Immutable contracts for bounded L16 indicator evidence.
Source · Public symbols: 4
Classes: L16ScenarioSpec, L16IndicatorCertificate, L16RouteEvidence, L16DirectorEvidence
scpn_quantum_control.l16.director_evidence¶
Digest-bound JSON and Markdown evidence for the bounded L16 director.
Source · Public symbols: 6
Functions: canonical_l16_json(), l16_evidence_payload(), render_l16_evidence_markdown(), validate_l16_evidence(), write_l16_evidence(), main()
scpn_quantum_control.l16.director_product¶
Policy-gated L16 indicators and conservative co-design safety routing.
Source · Public symbols: 7
Classes: L16DirectorPolicyError
Functions: frozen_l16_scenarios(), observer_inputs_from_l16(), run_l16_indicator_scenario(), run_l16_director_suite(), informative_l16_indicators(), l16_promotion_blockers()
scpn_quantum_control.l16.quantum_director¶
Quantum L16 indicator bundle for heuristic cybernetic routing.
Source · Public symbols: 5
Classes: L16Result
Functions: loschmidt_echo(), energy_variance(), fidelity_susceptibility(), compute_l16_lyapunov()
mitigation¶
scpn_quantum_control.mitigation.compound_mitigation¶
Compound Error Mitigation: CPDR + Z2 Symmetry Verification.
Source · Public symbols: 2
Classes: CompoundMitigationResult
Functions: compound_mitigate_pipeline()
scpn_quantum_control.mitigation.cpdr¶
Clifford Perturbation Data Regression (CPDR) error mitigation.
Source · Public symbols: 7
Classes: CPDRResult
Functions: generate_training_circuits(), compute_ideal_values(), compute_noisy_values_from_counts(), fit_regression(), cpdr_mitigate(), cpdr_full_pipeline()
scpn_quantum_control.mitigation.dd¶
Dynamical decoupling sequences for idle-qubit decoherence suppression.
Source · Public symbols: 2
Classes: DDSequence
Functions: insert_dd_sequence()
scpn_quantum_control.mitigation.mitiq_integration¶
Mitiq integration for production-quality error mitigation.
Source · Public symbols: 3
Functions: is_mitiq_available(), zne_mitigated_expectation(), ddd_mitigated_expectation()
scpn_quantum_control.mitigation.pec¶
Probabilistic Error Cancellation for local depolarizing channels.
Source · Public symbols: 3
Classes: PECResult
Functions: pauli_twirl_decompose(), pec_sample()
scpn_quantum_control.mitigation.readout_matrix¶
Full-basis readout confusion-matrix mitigation utilities.
Source · Public symbols: 11
Classes: ReadoutConfusionMatrix
Functions: computational_basis_labels(), bitstring_index(), counts_to_probabilities(), build_readout_confusion_matrix(), mitigate_probabilities(), mitigate_counts(), probability_state_retention(), probability_parity_leakage(), probability_magnetisation_leakage(), probability_mean_magnetisation()
scpn_quantum_control.mitigation.symmetry_decay¶
GUESS: Guiding Extrapolations from Symmetry Decays.
Source · Public symbols: 5
Classes: SymmetryDecayModel, GUESSResult
Functions: learn_symmetry_decay(), guess_extrapolate(), xy_magnetisation_ideal()
scpn_quantum_control.mitigation.symmetry_sector_compiler¶
Planning contract for symmetry- and sector-aware error mitigation.
Source · Public symbols: 3
Classes: SymmetrySectorProblem, SymmetrySectorPlan
Functions: plan_symmetry_sector_mitigation()
scpn_quantum_control.mitigation.symmetry_sector_fixtures¶
Deterministic fixtures for the symmetry-sector mitigation planner.
Source · Public symbols: 7
Functions: fixture_problems(), fixture_payload(), replay_fixture_rows(), normalised_json(), write_json(), fixture_markdown(), write_text()
scpn_quantum_control.mitigation.symmetry_sector_replay¶
Offline raw-count replay for symmetry-sector mitigation plans.
Source · Public symbols: 2
Classes: SymmetrySectorReplayResult
Functions: replay_symmetry_sector_counts()
scpn_quantum_control.mitigation.symmetry_verification¶
Z₂ parity symmetry verification for XY Hamiltonian error mitigation.
Source · Public symbols: 7
Classes: SymmetryVerificationResult
Functions: bitstring_parity(), initial_state_parity(), parity_postselect(), symmetry_expand(), parity_verified_expectation(), parity_verified_R()
scpn_quantum_control.mitigation.zne¶
Zero-Noise Extrapolation via global unitary folding.
Source · Public symbols: 3
Classes: ZNEResult
Functions: gate_fold_circuit(), zne_extrapolate()
scpn_quantum_control.mitigation.zne_uncertainty¶
Uncertainty propagation for zero-noise extrapolation (ZNE).
Source · Public symbols: 2
Classes: ZNEUncertaintyResult
Functions: zne_extrapolate_with_uncertainty()
ml_examples¶
scpn_quantum_control.ml_examples.contracts¶
Immutable contracts for bounded QNN/QGNN/QSNN convergence examples.
Source · Public symbols: 6
Classes: ModelFamily, FrameworkStatus, ConvergenceExampleSpec, ConvergenceCertificate, FrameworkEvidenceRow, ConvergenceSuiteEvidence
scpn_quantum_control.ml_examples.evidence¶
Digest-bound JSON and Markdown evidence for the BL-42 convergence suite.
Source · Public symbols: 6
Functions: canonical_json(), evidence_payload(), render_evidence_markdown(), write_ml_convergence_evidence(), validate_ml_convergence_evidence(), main()
scpn_quantum_control.ml_examples.qgnn_convergence¶
Frozen graph-regression convergence task over the existing bounded QGNN.
Source · Public symbols: 3
Functions: qgnn_example_spec(), run_qgnn_convergence_example(), qgnn_framework_rows()
scpn_quantum_control.ml_examples.qnn_convergence¶
Frozen phase-QNN convergence task and real framework agreement rows.
Source · Public symbols: 3
Functions: qnn_example_spec(), run_qnn_convergence_example(), run_qnn_framework_rows()
scpn_quantum_control.ml_examples.qsnn_convergence¶
Frozen synapse-angle task over the existing QSNN parameter-shift trainer.
Source · Public symbols: 3
Functions: qsnn_example_spec(), run_qsnn_convergence_example(), qsnn_framework_rows()
scpn_quantum_control.ml_examples.suite¶
Compose the three existing ML training surfaces into one evidence suite.
Source · Public symbols: 1
Functions: run_ml_convergence_suite()
pgbo¶
scpn_quantum_control.pgbo.quantum_bridge¶
Quantum PGBO: phase-geometry bridge operator.
Source · Public symbols: 2
Classes: PGBOResult
Functions: compute_pgbo_tensor()
phase¶
scpn_quantum_control.phase.adapt_vqe¶
Adaptive layered VQE for the Kuramoto-XY ground state.
Source · Public symbols: 2
Classes: ADAPTResult
Functions: adapt_vqe()
scpn_quantum_control.phase.adiabatic_preparation¶
Adiabatic state preparation for the synchronization ground state.
Source · Public symbols: 3
Classes: AdiabaticResult
Functions: adiabatic_ramp(), adiabatic_time_scaling()
scpn_quantum_control.phase.ancilla_lindblad¶
Simulate open-system Kuramoto-XY dynamics with one ancilla qubit.
Source · Public symbols: 3
Classes: AncillaCircuitStats
Functions: build_ancilla_lindblad_circuit(), ancilla_circuit_stats()
scpn_quantum_control.phase.ansatz_bench¶
Compare K_nm-informed and generic variational ansatz families.
Source · Public symbols: 3
Classes: AnsatzBenchmarkRow
Functions: benchmark_ansatz(), run_ansatz_benchmark()
scpn_quantum_control.phase.ansatz_methodology¶
Coupling-topology-informed ansatz: formal benchmark methodology.
Source · Public symbols: 4
Classes: AnsatzBenchmarkResult
Functions: benchmark_single_ansatz(), run_full_benchmark(), summarize_benchmark()
scpn_quantum_control.phase.avqds¶
McLachlan variational quantum real-time dynamics with a fixed ansatz.
Source · Public symbols: 2
Classes: AVQDSResult
Functions: avqds_simulate()
scpn_quantum_control.phase.backend_selector¶
Auto-select simulation backend based on system size and available resources.
Source · Public symbols: 4
Classes: BackendRecommendation, AutoSolveResult
Functions: recommend_backend(), auto_solve()
scpn_quantum_control.phase.contraction_optimiser¶
Optimal tensor contraction paths for MPS operations.
Source · Public symbols: 6
Classes: ContractionPathInfo, ContractionBenchmarkResult
Functions: is_cotengra_available(), optimal_contraction_path(), contract(), benchmark_contraction()
scpn_quantum_control.phase.coupling_learning¶
Parameter-shift coupling learning for oscillator observation models.
Source · Public symbols: 5
Classes: CouplingLearningResult, CouplingGradientVerificationResult
Functions: coupling_matrix_from_edge_vector(), learn_couplings_from_observations(), verify_coupling_parameter_shift_gradient()
scpn_quantum_control.phase.coupling_time_series_recovery¶
Recover bounded Kuramoto/XY coupling matrices from synthetic time series.
Source · Public symbols: 12
Classes: CouplingRecoveryCase, CouplingRecoveryRecord, CouplingRecoveryBoundaryRow, CouplingRecoverySuiteResult
Functions: simulate_kuramoto_phase_time_series(), simulate_xy_pair_energy_time_series(), inject_time_series_noise_and_missing(), recover_kuramoto_couplings_from_time_series(), recover_xy_couplings_from_pair_energy_series(), coupling_recovery_boundary_rows(), default_coupling_recovery_cases(), run_coupling_recovery_suite()
scpn_quantum_control.phase.cross_domain_transfer¶
Cross-domain VQE transfer learning.
Source · Public symbols: 7
Classes: TransferSummary, TransferResult, PhysicalSystem
Functions: build_systems(), transfer_experiment(), run_transfer_matrix(), summarize_transfer()
scpn_quantum_control.phase.differentiable_audit¶
Reviewer-facing differentiable quantum gradient audit reports.
Source · Public symbols: 7
Functions: verify_parameter_shift_analytic_gradient(), run_ml_framework_gradient_audit(), run_parameter_shift_audit_suite(), run_known_phase_gradient_audit(), run_finite_shot_gradient_uncertainty_audit(), run_differentiable_workflow_audit_suite(), run_phase_gradient_benchmark_suite()
scpn_quantum_control.phase.differentiable_audit_contracts¶
Immutable reports and serializers for differentiable gradient audits.
Source · Public symbols: 7
Classes: ParameterShiftAnalyticAgreement, DifferentiableQuantumAuditReport, PhaseGradientBenchmarkSuiteResult, DifferentiableWorkflowAuditSuiteResult, FiniteShotGradientAuditResult, MLFrameworkGradientAuditRecord, MLFrameworkGradientAuditSuiteResult
scpn_quantum_control.phase.differentiable_readiness¶
Unified readiness ledger for differentiable-programming evidence.
Source · Public symbols: 5
Classes: DifferentiableReadinessSurface, DifferentiableReadinessAuditRecord, DifferentiableReadinessAuditResult
Functions: default_differentiable_readiness_surfaces(), run_differentiable_readiness_audit()
scpn_quantum_control.phase.domain_benchmark_datasets¶
Exact-answer differentiable benchmark datasets for bounded phase models.
Source · Public symbols: 13
Classes: DifferentiableQNNExactAnswerCase, DifferentiableKuramotoExactAnswerCase, DifferentiableDomainBenchmarkDatasetSuite, DifferentiableDomainBenchmarkValidationResult, DifferentiableDomainBenchmarkValidationSuite, DifferentiablePublishedDomainBenchmarkCase, DifferentiablePublishedDomainBenchmarkSuite, DifferentiablePublishedDomainBenchmarkValidationResult, DifferentiablePublishedDomainBenchmarkValidationSuite
Functions: load_differentiable_domain_benchmark_datasets(), run_differentiable_domain_benchmark_dataset_validation(), load_differentiable_published_domain_benchmark_cases(), run_differentiable_published_domain_benchmark_validation()
scpn_quantum_control.phase.floquet_kuramoto¶
Floquet-Kuramoto: periodically driven XY synchronization.
Source · Public symbols: 3
Classes: FloquetResult
Functions: floquet_evolve(), scan_drive_amplitude()
scpn_quantum_control.phase.general_unitary¶
U3 and arbitrary single-qubit unitary support via a registered ZYZ decomposition.
Source · Public symbols: 2
Functions: su2_zyz_angles(), build_u3_operations()
scpn_quantum_control.phase.generalised_parameter_shift¶
Generalised parameter-shift plans for finite generator spectra.
Source · Public symbols: 8
Classes: GeneralisedParameterShiftTerm, GeneralisedParameterShiftPlan, GeneralisedParameterShiftResult, GeneralisedStochasticParameterShiftResult
Functions: plan_generalised_parameter_shift(), value_and_generalised_parameter_shift_grad(), generalised_parameter_shift_gradient(), estimate_generalised_parameter_shift_shot_noise()
scpn_quantum_control.phase.gpu_batch_vqe¶
Parallel VQE evaluation on GPU using PyTorch or JAX.
Source · Public symbols: 3
Functions: batch_energy_numpy(), batch_energy_torch(), batch_vqe_scan()
scpn_quantum_control.phase.gradient_backend¶
Backend-aware quantum-gradient planning for phase objectives.
Source · Public symbols: 8
Classes: QuantumGradientBackendCapability, QuantumGradientPlan, QuantumGradientRejectedMethod, QuantumGradientShotPolicy, QuantumGradientMethodExplanation
Functions: quantum_gradient_backend_capability(), plan_quantum_gradient_backend(), explain_quantum_gradient_method()
scpn_quantum_control.phase.gradient_descent¶
Auditable parameter-shift gradient-descent training for phase objectives.
Source · Public symbols: 5
Classes: ParameterShiftTrainingStep, ParameterShiftTrainingResult, ParameterShiftTrainingCertificate
Functions: parameter_shift_gradient_descent(), validate_parameter_shift_training()
scpn_quantum_control.phase.gradient_support_matrix¶
Executable support matrix for quantum-gradient combinations.
Source · Public symbols: 8
Classes: GradientSupportCapability, GradientSupportPlan, GradientSupportMatrixAuditResult
Functions: list_gradient_support_capabilities(), gradient_support_capability(), plan_gradient_support(), assert_gradient_support(), run_gradient_support_matrix_audit()
scpn_quantum_control.phase.gradient_tape¶
Context-managed quantum-gradient tape for phase objectives.
Source · Public symbols: 6
Classes: TapeGradientRecord, GradientTapeContractCheck, GradientTapeContractAuditResult, QuantumGradientTape
Functions: run_gradient_tape_contract_audit(), gradient_tape()
scpn_quantum_control.phase.hardware_gradient_campaign¶
No-submit hardware-gradient campaign specifications for XY Hamiltonians.
Source · Public symbols: 7
Classes: HardwareGradientReplaySchema, HardwareGradientCampaignSpec, HardwareGradientCampaignPlan, HardwareGradientCampaignSuite
Functions: default_hardware_gradient_campaign_specs(), plan_hardware_gradient_campaign(), run_hardware_gradient_campaign_readiness_suite()
scpn_quantum_control.phase.hardware_gradient_policy¶
Fail-closed policy checks for hardware quantum-gradient preparation.
Source · Public symbols: 7
Classes: HardwareGradientRequest, HardwareGradientPolicy, HardwareGradientPolicyDecision, HardwareGradientReadinessSuiteResult
Functions: evaluate_hardware_gradient_policy(), assert_hardware_gradient_policy_approved(), run_hardware_gradient_policy_readiness_suite()
scpn_quantum_control.phase.hardware_gradient_publication¶
Publication package scaffold for no-submit XY hardware-gradient campaigns.
Source · Public symbols: 7
Classes: HardwareGradientPreregistration, HardwareGradientMethodSection, HardwareGradientArtifactMapEntry, HardwareGradientClaimLedgerRow, HardwareGradientBenchmarkPlaceholder, HardwareGradientPublicationPackage
Functions: build_hardware_gradient_publication_package()
scpn_quantum_control.phase.jax_bridge¶
Optional JAX execution and compatibility facade for phase gradients.
Source · Public symbols: 18
Functions: is_phase_jax_available(), jax_parameter_shift_value_and_grad(), check_jax_parameter_shift_agreement(), jax_native_qnn_value_and_grad(), jax_custom_vjp_qnn_value_and_grad(), jax_phase_qnode_value_and_grad(), jax_phase_qnode_native_transform_audit(), jax_phase_qnode_pytree_transform_audit(), jax_phase_qnode_sharding_transform_audit(), jax_phase_qnode_aot_export_audit(), run_jax_jit_compatibility_audit(), run_jax_vmap_compatibility_audit(), run_jax_sharding_compatibility_audit(), run_jax_pytree_compatibility_audit(), run_jax_nested_transform_algebra_audit(), run_jax_phase_qnode_lowering_matrix(), plan_jax_cloud_validation_batch(), run_jax_maturity_audit()
scpn_quantum_control.phase.jax_bridge_contracts¶
Immutable result contracts for the optional phase JAX bridge.
Source · Public symbols: 19
Classes: PhaseJAXParameterShiftResult, PhaseJAXGradientAgreementResult, PhaseJAXNativeQNNGradientResult, PhaseJAXCustomVJPQNNGradientResult, PhaseJAXPhaseQNodeStatevectorResult, PhaseJAXPhaseQNodeNativeTransformResult, PhaseJAXPhaseQNodePyTreeTransformResult, PhaseJAXPhaseQNodeShardingTransformResult, PhaseJAXPhaseQNodeAOTExportResult, PhaseJAXJITCompatibilityResult, PhaseJAXVMAPCompatibilityResult, PhaseJAXShardingCompatibilityResult, PhaseJAXPyTreeCompatibilityResult, PhaseJAXMaturityAuditResult, PhaseJAXNestedTransformRoute, PhaseJAXNestedTransformAlgebraResult, PhaseJAXCloudValidationRunSpec, PhaseJAXPhaseQNodeLoweringRoute, PhaseJAXPhaseQNodeLoweringMatrixResult
scpn_quantum_control.phase.jax_compatibility¶
Bounded phase-QNN JAX compatibility and nested-transform audits.
Source · Public symbols: 5
Functions: run_jax_jit_compatibility_audit(), run_jax_vmap_compatibility_audit(), run_jax_sharding_compatibility_audit(), run_jax_pytree_compatibility_audit(), run_jax_nested_transform_algebra_audit()
scpn_quantum_control.phase.jax_gradients¶
Bounded parameter-shift and QNN gradient execution for the JAX bridge.
Source · Public symbols: 4
Functions: jax_parameter_shift_value_and_grad(), check_jax_parameter_shift_agreement(), jax_native_qnn_value_and_grad(), jax_custom_vjp_qnn_value_and_grad()
scpn_quantum_control.phase.jax_maturity¶
JAX lowering declarations, cloud planning, and maturity aggregation.
Source · Public symbols: 3
Functions: run_jax_phase_qnode_lowering_matrix(), plan_jax_cloud_validation_batch(), run_jax_maturity_audit()
scpn_quantum_control.phase.jax_nqs¶
JAX-based exact-enumeration RBM wavefunction with automatic differentiation.
Source · Public symbols: 3
Functions: is_jax_available(), jax_rbm_energy(), jax_vmc_ground_state()
scpn_quantum_control.phase.jax_qnode_transforms¶
Native JAX execution and transforms for registered local Phase-QNodes.
Source · Public symbols: 5
Functions: jax_phase_qnode_value_and_grad(), jax_phase_qnode_native_transform_audit(), jax_phase_qnode_pytree_transform_audit(), jax_phase_qnode_sharding_transform_audit(), jax_phase_qnode_aot_export_audit()
scpn_quantum_control.phase.kuramoto_variants¶
Higher-order, monitored, and PT-symmetric Kuramoto trajectories.
Source · Public symbols: 10
Classes: KuramotoVariant, KuramotoVariantResult, HigherOrderKuramotoSpec, MonitoredKuramotoSpec, PTSymmetricKuramotoSpec
Functions: build_triadic_ring_terms(), simulate_higher_order_kuramoto(), simulate_monitored_kuramoto(), simulate_pt_symmetric_kuramoto(), validate_variant_kuramoto_inputs()
scpn_quantum_control.phase.lindblad¶
Lindblad master equation solver for open Kuramoto-XY systems.
Source · Public symbols: 1
Classes: LindbladKuramotoSolver
scpn_quantum_control.phase.lindblad_engine¶
Lindblad Master Equation and Quantum Trajectory Solver.
Source · Public symbols: 1
Classes: LindbladSyncEngine
scpn_quantum_control.phase.model_training_evidence¶
Registered medium-scale local differentiable-model training evidence.
Source · Public symbols: 6
Classes: DifferentiableModelTrainingRecord, DifferentiableModelTrainingEvidenceSuite, RegisteredDifferentiableTrainingSuiteRecord, RegisteredDifferentiableTrainingSuiteAuditResult
Functions: run_differentiable_model_training_evidence_suite(), run_registered_differentiable_training_suite_audit()
scpn_quantum_control.phase.mps_evolution¶
Matrix Product State backend for large-N Kuramoto-XY.
Source · Public symbols: 3
Functions: is_quimb_available(), dmrg_ground_state(), tebd_evolution()
scpn_quantum_control.phase.natural_gradient¶
Metric-aware parameter-shift optimisation for supported phase objectives.
Source · Public symbols: 8
Classes: NaturalGradientRegularizationPolicy, NaturalGradientDirection, ParameterShiftNaturalGradientStep, ParameterShiftNaturalGradientResult, ParameterShiftNaturalGradientCertificate
Functions: solve_natural_gradient_direction(), parameter_shift_natural_gradient_descent(), validate_natural_gradient_training()
scpn_quantum_control.phase.nqs_ansatz¶
Restricted Boltzmann Machine (RBM) ansatz for Kuramoto-XY ground state.
Source · Public symbols: 2
Classes: RBMWavefunction
Functions: vmc_ground_state()
scpn_quantum_control.phase.objective_audit¶
Reviewer-facing correctness evidence for composed phase objectives.
Source · Public symbols: 4
Classes: ComposedObjectiveGradientAgreement, ComposedObjectiveAuditSuiteResult
Functions: verify_composed_objective_gradient(), run_composed_objective_audit_suite()
scpn_quantum_control.phase.objective_planner¶
Fail-closed execution planning for composed phase objectives.
Source · Public symbols: 5
Classes: ComposedObjectiveExecutionPlan, ComposedObjectivePlannerAuditResult
Functions: plan_composed_objective_execution(), assert_composed_objective_execution_supported(), run_composed_objective_planner_audit()
scpn_quantum_control.phase.objectives¶
Composable differentiable objectives for phase-control training.
Source · Public symbols: 15
Classes: ObjectiveTermValue, ObjectiveGradientEvaluation, ObjectiveTerm, ComposedPhaseObjective, ComposedObjectiveTrainingStep, ComposedObjectiveTrainingResult, ComposedObjectiveTrainingCertificate
Functions: phase_energy_term(), phase_fidelity_target_term(), periodic_regularization_term(), phase_symmetry_penalty_term(), smooth_box_safety_penalty_term(), build_phase_control_objective(), train_composed_phase_objective(), validate_composed_objective_training()
scpn_quantum_control.phase.open_system_objectives¶
Bounded Lindblad and MCWF objective certificates.
Source · Public symbols: 13
Classes: BoundedOpenSystemObjectiveCase, DensityMatrixInvariantCertificate, MCWFReproducibilityCertificate, OpenSystemObjectiveRecord, OpenSystemObjectiveBoundaryRow, OpenSystemObjectiveSuiteResult
Functions: default_open_system_objective_cases(), evaluate_lindblad_objective(), evaluate_mcwf_objective(), certify_density_matrix_invariants(), certify_mcwf_reproducibility(), open_system_objective_boundary_rows(), run_open_system_objective_suite()
scpn_quantum_control.phase.optimizer_audit¶
Multi-start convergence evidence for parameter-shift phase optimizers.
Source · Public symbols: 3
Classes: OptimizerConvergenceRecord, OptimizerComparisonSuiteResult
Functions: run_parameter_shift_optimizer_comparison()
scpn_quantum_control.phase.optimizer_convergence_suite¶
Convergence certificates for small phase ground-state objectives.
Source · Public symbols: 7
Classes: KnownGroundStateObjective, GroundStateConvergenceCertificate, GroundStateOptimizerRunRecord, GroundStateOptimizerBoundaryRow, GroundStateOptimizerConvergenceSuiteResult
Functions: default_ground_state_optimizer_objectives(), run_ground_state_optimizer_convergence_suite()
scpn_quantum_control.phase.param_shift¶
Parameter-shift gradients for phase and Kuramoto-XY VQE objectives.
Source · Public symbols: 17
Classes: ParamShiftConvergenceDiagnostics, ParamShiftVQEResult, GenericParameterShiftEvaluationPlan, GradientVerificationResult, HessianVerificationResult
Functions: parameter_shift_gradient(), plan_generic_parameter_shift_evaluations(), parameter_shift_hessian(), verify_parameter_shift_gradient(), verify_parameter_shift_hessian(), verify_vqe_parameter_shift_gradient(), verify_vqe_parameter_shift_hessian(), parameter_shift_gradient_with_uncertainty(), plan_parameter_shift_shots(), validate_param_shift_convergence(), value_and_vqe_grad(), vqe_with_param_shift()
scpn_quantum_control.phase.pennylane_bridge¶
Optional PennyLane agreement checks for phase parameter-shift gradients.
Source · Public symbols: 10
Classes: PennyLaneGradientAgreementResult, PennyLaneRoundTripResult, PennyLaneQNodeConversionResult, PennyLaneMaturityAuditResult
Functions: is_phase_pennylane_available(), check_pennylane_parameter_shift_agreement(), check_pennylane_qnode_round_trip(), build_pennylane_qnode_from_phase_qnode(), check_pennylane_phase_qnode_round_trip(), run_pennylane_maturity_audit()
scpn_quantum_control.phase.pennylane_import¶
Convert a PennyLane quantum tape into a registered Phase-QNode circuit.
Source · Public symbols: 5
Classes: PennyLaneImportResult, PennyLaneImportRoundTripResult
Functions: is_pennylane_import_available(), import_phase_qnode_from_pennylane(), check_pennylane_phase_qnode_import_round_trip()
scpn_quantum_control.phase.pennylane_provider_plugin¶
PennyLane provider-plugin gradient artefacts and fail-closed route matrix.
Source · Public symbols: 7
Classes: PennyLanePluginMatrixRoute, PennyLaneProviderPluginExecutionArtifact, PennyLaneProviderGradientParityArtifact, PennyLaneHardwarePluginExecutionArtifact, PennyLaneProviderEvidenceBundle, PennyLanePluginMatrixResult
Functions: run_pennylane_plugin_matrix()
scpn_quantum_control.phase.phase_vqe¶
VQE for Kuramoto/XY Hamiltonian ground state.
Source · Public symbols: 1
Classes: PhaseVQE
scpn_quantum_control.phase.provider_gradient¶
Provider-safe parameter-shift gradient execution contracts.
Source · Public symbols: 6
Classes: ProviderExpectationSample, ProviderParameterShiftRecord, ProviderGradientExecutionResult, ProviderHardwareGradientPreparationResult
Functions: prepare_provider_hardware_parameter_shift_gradient(), execute_provider_parameter_shift_gradient()
scpn_quantum_control.phase.provider_gradient_audit¶
Executable readiness audit for provider-safe quantum gradients.
Source · Public symbols: 5
Classes: ProviderGradientReadinessScenario, ProviderGradientReadinessRecord, ProviderGradientReadinessAuditResult
Functions: default_provider_gradient_readiness_scenarios(), run_provider_gradient_readiness_audit()
scpn_quantum_control.phase.provider_hardware_gradient_audit¶
Executable audit for provider hardware-gradient preparation readiness.
Source · Public symbols: 5
Classes: ProviderHardwareGradientPreparationScenario, ProviderHardwareGradientPreparationRecord, ProviderHardwareGradientPreparationAuditResult
Functions: default_provider_hardware_gradient_preparation_scenarios(), run_provider_hardware_gradient_preparation_audit()
scpn_quantum_control.phase.provider_hardware_safety_audit¶
Aggregate safety gate for differentiable provider and hardware-gradient paths.
Source · Public symbols: 3
Classes: DifferentiableProviderHardwareSafetySurface, DifferentiableProviderHardwareSafetyAuditResult
Functions: run_differentiable_provider_hardware_safety_audit()
scpn_quantum_control.phase.pulse_shaping¶
PMP-optimal ICI pulse sequences and (α,β)-hypergeometric pulse shaping.
Source · Public symbols: 10
Classes: ICIPulse, HypergeometricPulse, PulseSchedule
Functions: ici_mixing_angle(), build_ici_pulse(), ici_three_level_evolution(), hypergeometric_envelope(), build_hypergeometric_pulse(), infidelity_bound(), build_trotter_pulse_schedule()
scpn_quantum_control.phase.qgnn¶
A local quantum graph neural network that maps K_nm graphs to circuit outputs.
Source · Public symbols: 10
Classes: KnmGraph, QGNNConfig, QGNNTrainingResult
Functions: validate_graph(), parameter_count(), initialise_parameters(), predict(), predict_and_gradient(), synthetic_kuramoto_target(), train()
scpn_quantum_control.phase.qiskit_bridge¶
Compatibility facade for Qiskit gradient and Runtime evidence routes.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.phase.qiskit_bridge_contracts¶
Qiskit gradient, Runtime, and provider-evidence record contracts.
Source · Public symbols: 9
Classes: QiskitParameterShiftRecord, QiskitParameterShiftGradientResult, QiskitRuntimePrimitiveExecutionArtifact, QiskitRuntimeQPUExecutionArtifact, QiskitRawCountReplayArtifact, QiskitCalibrationStatevectorComparisonArtifact, QiskitProviderGradientWorkflowArtifact, QiskitRuntimeQPUProviderEvidenceBundle, QiskitMaturityAuditResult
scpn_quantum_control.phase.qiskit_gradients¶
Qiskit shifted-circuit generation and local gradient execution.
Source · Public symbols: 3
Functions: generate_qiskit_parameter_shift_circuits(), execute_qiskit_statevector_parameter_shift(), execute_qiskit_finite_shot_parameter_shift()
scpn_quantum_control.phase.qiskit_runtime¶
Qiskit Runtime evidence capture and maturity orchestration.
Source · Public symbols: 4
Functions: build_qiskit_runtime_qpu_execution_artifact(), build_qiskit_provider_gradient_workflow_artifact(), build_qiskit_runtime_qpu_provider_evidence_bundle(), run_qiskit_maturity_audit()
scpn_quantum_control.phase.qnn_conformance¶
Conformance evidence for bounded phase-QNN differentiable workflows.
Source · Public symbols: 5
Classes: ParameterShiftQNNUnsupportedScenario, ParameterShiftQNNConformanceCaseResult, ParameterShiftQNNConformanceSuiteResult
Functions: summarize_parameter_shift_qnn_unsuitable_scenarios(), run_parameter_shift_qnn_conformance_suite()
scpn_quantum_control.phase.qnn_convergence¶
Deterministic convergence evidence for bounded phase-QNN training.
Source · Public symbols: 9
Classes: ParameterShiftQNNConvergenceUnsuitableScenario, ParameterShiftQNNConvergenceCaseResult, ParameterShiftQNNConvergenceSuiteResult, ParameterShiftQNNMultiSeedConvergenceRunResult, ParameterShiftQNNMultiSeedConvergenceCaseResult, ParameterShiftQNNMultiSeedConvergenceSuiteResult
Functions: summarize_parameter_shift_qnn_convergence_unsuitable_scenarios(), run_parameter_shift_qnn_convergence_suite(), run_parameter_shift_qnn_multi_seed_convergence_suite()
scpn_quantum_control.phase.qnn_finite_shot¶
Seeded finite-shot evidence for bounded phase-QNN gradients and training.
Source · Public symbols: 8
Classes: ParameterShiftQNNFiniteShotProbeRecord, ParameterShiftQNNFiniteShotGradientResult, ParameterShiftQNNFiniteShotConvergenceCaseResult, ParameterShiftQNNFiniteShotUnsupportedScenario, ParameterShiftQNNFiniteShotConvergenceSuiteResult
Functions: estimate_parameter_shift_qnn_finite_shot_gradient(), summarize_parameter_shift_qnn_finite_shot_unsuitable_scenarios(), run_parameter_shift_qnn_finite_shot_convergence_suite()
scpn_quantum_control.phase.qnn_framework_agreement¶
Caller-supplied framework-gradient agreement for bounded phase QNNs.
Source · Public symbols: 5
Classes: ParameterShiftQNNFrameworkGradientAgreement, ParameterShiftQNNFrameworkAgreementResult, ParameterShiftQNNFrameworkAgreementSuiteResult
Functions: verify_parameter_shift_qnn_framework_agreement(), run_parameter_shift_qnn_framework_agreement_suite()
scpn_quantum_control.phase.qnn_framework_bridge_matrix¶
Fail-closed support matrix for bounded phase-QNN framework bridges.
Source · Public symbols: 4
Classes: BoundedQNNFrameworkBridgeCapability, BoundedQNNFrameworkBridgeMatrixResult
Functions: run_bounded_qnn_framework_bridge_matrix(), assert_bounded_qnn_framework_bridge_supported()
scpn_quantum_control.phase.qnn_loss_landscape¶
Deterministic loss-landscape evidence for bounded phase-QNN training.
Source · Public symbols: 4
Classes: ParameterShiftQNNLossLandscapePoint, ParameterShiftQNNLossLandscapeCaseResult, ParameterShiftQNNLossLandscapeSuiteResult
Functions: run_parameter_shift_qnn_loss_landscape_suite()
scpn_quantum_control.phase.qnn_optimizer_benchmark¶
Functional optimizer benchmarks for bounded phase-QNN training.
Source · Public symbols: 4
Classes: QNNOptimizerBaselineResult, ParameterShiftQNNOptimizerBenchmarkCaseResult, ParameterShiftQNNOptimizerBenchmarkSuiteResult
Functions: run_parameter_shift_qnn_optimizer_benchmark_suite()
scpn_quantum_control.phase.qnn_training¶
Deterministic parameter-shift training for bounded phase QNN classifiers.
Source · Public symbols: 9
Classes: ParameterShiftQNNPredictionResult, ParameterShiftQNNTrainingResult, ParameterShiftQNNExternalGradientAgreement, ParameterShiftQNNGradientVerificationResult
Functions: predict_parameter_shift_qnn_classifier(), parameter_shift_qnn_classifier_loss(), parameter_shift_qnn_classifier_gradient(), verify_parameter_shift_qnn_classifier_gradient(), train_parameter_shift_qnn_classifier()
scpn_quantum_control.phase.qnode_affinity_benchmark¶
Small Phase-QNode benchmark harness with isolation metadata.
Source · Public symbols: 6
Classes: PhaseQNodeAffinityBenchmarkMetadata, PhaseQNodeAffinityBenchmarkResult, PhaseQNodeAffinityArtifactValidation
Functions: classify_affinity_evidence(), run_phase_qnode_affinity_benchmark(), validate_phase_qnode_affinity_artifact()
scpn_quantum_control.phase.qnode_circuit¶
Executable facade for registered Phase-QNode circuit routes.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.phase.qnode_circuit_builders¶
Registered Phase-QNode vocabulary, observables, decompositions, and templates.
Source · Public symbols: 8
Functions: registered_phase_qnode_gates(), registered_phase_qnode_observables(), registered_phase_qnode_templates(), registered_phase_qnode_decompositions(), registered_phase_qnode_noise_channels(), build_sparse_ising_chain_hamiltonian(), decompose_phase_qnode_controlled_gate(), build_phase_qnode_template()
scpn_quantum_control.phase.qnode_circuit_contracts¶
Phase-QNode declarations, result records, registries, and validation.
Source · Public symbols: 20
Classes: PhaseQNodeOperation, PhaseQNodeNoiseChannel, PauliTerm, SparsePauliHamiltonian, DenseHermitianObservable, PauliCovarianceObservable, PhaseQNodeSupportReport, PhaseQNodeSupportError, PhaseQNodeCircuit, PhaseQNodeDensityCircuit, PhaseQNodeTemplateSpec, PhaseQNodeDepthProfile, PhaseQNodeRegisteredCircuitSpec, PhaseQNodeExecutionResult, PhaseQNodeDensityExecutionResult, PhaseQNodeGradientResult, PhaseQNodeGradientEvaluationGroup, PhaseQNodeGradientEvaluationPlan, PhaseQNodeMetricTensorResult, PhaseQNodeClassicalFisherResult
scpn_quantum_control.phase.qnode_circuit_differentiation¶
Gradient, Fisher, and metric orchestration for Phase-QNode circuits.
Source · Public symbols: 5
Functions: phase_qnode_computational_basis_fisher_support_report(), parameter_shift_phase_qnode_gradient(), phase_qnode_quantum_fisher_information(), phase_qnode_computational_basis_fisher_information(), phase_qnode_natural_gradient_metric()
scpn_quantum_control.phase.qnode_circuit_execution¶
Numerical statevector and density execution for Phase-QNode circuits.
Source · Public symbols: 2
Functions: execute_phase_qnode_circuit(), execute_phase_qnode_density_matrix()
scpn_quantum_control.phase.qnode_circuit_support¶
Declarative support analysis and shift planning for Phase-QNode circuits.
Source · Public symbols: 7
Functions: build_registered_phase_qnode_circuit(), phase_qnode_depth_profile(), phase_qnode_support_report(), phase_qnode_density_support_report(), phase_qnode_gradient_support_report(), plan_phase_qnode_parameter_shift_evaluations(), phase_qnode_metric_support_report()
scpn_quantum_control.phase.qnode_framework_parity¶
Real optional-framework parity checks for a bounded Phase-QNode circuit.
Source · Public symbols: 3
Classes: PhaseQNodeFrameworkParityRecord, PhaseQNodeFrameworkParitySuiteResult
Functions: run_phase_qnode_framework_parity_suite()
scpn_quantum_control.phase.qnode_provider_transforms¶
Provider-callback QNode transform execution evidence.
Source · Public symbols: 5
Classes: ProviderQNodeTransformResult, ProviderQNodeTransformReadinessSuiteResult
Functions: execute_provider_qnode_transform(), execute_provider_qnode_vmap_grad(), run_provider_qnode_transform_readiness_suite()
scpn_quantum_control.phase.qnode_tape¶
QNode-style differentiable tape records for supported phase objectives.
Source · Public symbols: 5
Classes: PhaseQNodeTapeRecord, PhaseQNodeTapeReadinessSuiteResult, PhaseQNodeTape
Functions: phase_qnode_tape(), run_phase_qnode_tape_readiness_suite()
scpn_quantum_control.phase.qnode_transforms¶
Executable scalar phase-QNode transform evidence.
Source · Public symbols: 7
Classes: PhaseQNodeComplexDerivativeContract, PhaseQNodeTransformResult, PhaseQNodeTransformReadinessSuiteResult
Functions: execute_phase_qnode_transform(), phase_qnode_complex_derivative_contract(), execute_phase_qnode_hessian_vector_product(), run_phase_qnode_transform_readiness_suite()
scpn_quantum_control.phase.qnode_vector_transforms¶
Executable vector-output phase-QNode Jacobian and native vmap evidence.
Source · Public symbols: 8
Classes: PhaseQNodeVectorTransformResult, PhaseQNodeVectorTransformReadinessSuiteResult
Functions: execute_phase_qnode_vector_jacobian(), execute_phase_qnode_vector_hessian(), execute_phase_qnode_vector_jvp(), execute_phase_qnode_vector_vjp(), execute_phase_qnode_vmap_grad(), run_phase_qnode_vector_transform_readiness_suite()
scpn_quantum_control.phase.qsvt_evolution¶
QSVT-based Hamiltonian simulation for the Kuramoto-XY model.
Source · Public symbols: 8
Classes: QSVTResourceEstimate
Functions: hamiltonian_1norm(), hamiltonian_spectral_norm(), qsvt_query_count(), trotter1_step_count(), trotter2_step_count(), qsvt_resource_estimate(), qsp_phase_angles()
scpn_quantum_control.phase.results¶
Typed result objects for phase-dynamics APIs.
Source · Public symbols: 1
Classes: TrajectoryResult
scpn_quantum_control.phase.structured_ansatz¶
General-purpose structured VQE ansatz based on physical coupling matrices.
Source · Public symbols: 1
Functions: build_structured_ansatz()
scpn_quantum_control.phase.synchronisation_objectives¶
Differentiable synchronisation losses for phase-control objectives.
Source · Public symbols: 6
Functions: kuramoto_order_parameter(), kuramoto_order_parameter_gradient(), kuramoto_order_parameter_target_term(), phase_locking_target_term(), cluster_synchronisation_target_term(), build_synchronisation_objective()
scpn_quantum_control.phase.synchronisation_witness¶
Order-parameter and persistent-homology synchronisation witnesses.
Source · Public symbols: 12
Classes: SyncWitnessCase, SyncWitnessRecord, SyncWitnessBoundaryRow, SyncWitnessSuiteResult
Functions: harmonic_order_parameter(), geodesic_phase_distance_matrix(), vietoris_rips_persistence(), betti_curve(), phase_cloud_synchronisation_witness(), default_sync_witness_cases(), sync_witness_boundary_rows(), run_sync_witness_suite()
scpn_quantum_control.phase.tensor_jump¶
Monte Carlo Wave Function (MCWF) method for open Kuramoto-XY systems.
Source · Public symbols: 2
Functions: mcwf_trajectory(), mcwf_ensemble()
scpn_quantum_control.phase.tensorflow_bridge¶
Signature-stable facade for optional TensorFlow phase-gradient routes.
Source · Public symbols: 10
Functions: is_phase_tensorflow_available(), run_tensorflow_phase_qnode_lowering_matrix(), tensorflow_parameter_shift_value_and_grad(), tensorflow_bounded_qnn_value_and_grad(), run_tensorflow_gradient_tape_compatibility_audit(), run_tensorflow_function_compatibility_audit(), run_tensorflow_xla_compatibility_audit(), tensorflow_bounded_qnn_keras_layer(), run_tensorflow_keras_layer_wrapper_audit(), run_tensorflow_maturity_audit()
scpn_quantum_control.phase.tensorflow_bridge_contracts¶
TensorFlow bridge result, compatibility, lowering, and maturity records.
Source · Public symbols: 9
Classes: PhaseTensorFlowParameterShiftResult, PhaseTensorFlowQNNGradientResult, PhaseTensorFlowGradientTapeCompatibilityResult, PhaseTensorFlowFunctionCompatibilityResult, PhaseTensorFlowXLACompatibilityResult, PhaseTensorFlowKerasLayerWrapperAuditResult, PhaseTensorFlowMaturityAuditResult, PhaseTensorFlowPhaseQNodeLoweringRoute, PhaseTensorFlowPhaseQNodeLoweringMatrixResult
scpn_quantum_control.phase.tensorflow_compatibility¶
Bounded TensorFlow compatibility, lowering, and maturity execution.
Source · Public symbols: 7
Functions: run_tensorflow_phase_qnode_lowering_matrix(), run_tensorflow_gradient_tape_compatibility_audit(), run_tensorflow_function_compatibility_audit(), run_tensorflow_xla_compatibility_audit(), tensorflow_bounded_qnn_keras_layer(), run_tensorflow_keras_layer_wrapper_audit(), run_tensorflow_maturity_audit()
scpn_quantum_control.phase.tensorflow_gradients¶
Bounded TensorFlow gradient execution and direct validation primitives.
Source · Public symbols: 2
Functions: tensorflow_parameter_shift_value_and_grad(), tensorflow_bounded_qnn_value_and_grad()
scpn_quantum_control.phase.tensorflow_maintenance¶
TensorFlow maintenance decision for differentiable framework parity.
Source · Public symbols: 3
Classes: PhaseTensorFlowMaintenanceRoute, PhaseTensorFlowMaintenanceReport
Functions: run_tensorflow_maintenance_decision()
scpn_quantum_control.phase.torch_aot_autograd_export¶
AOTAutograd FX graph persistence for bounded PyTorch phase-QNN modules.
Source · Public symbols: 4
Classes: PhaseTorchAOTAutogradGraphRecord, PhaseTorchAOTAutogradExportRoute, PhaseTorchAOTAutogradExportResult
Functions: run_torch_aot_autograd_export_audit()
scpn_quantum_control.phase.torch_autograd_function¶
Bounded PyTorch autograd.Function utilities for phase-QNN gradients.
Source · Public symbols: 4
Classes: PhaseTorchAutogradFunctionRoute, PhaseTorchAutogradFunctionResult
Functions: torch_autograd_function_qnn_loss(), run_torch_autograd_function_audit()
scpn_quantum_control.phase.torch_bridge¶
Optional PyTorch execution facade for phase gradients.
Source · Public symbols: 18
Functions: is_phase_torch_available(), run_torch_phase_qnode_lowering_matrix(), torch_parameter_shift_value_and_grad(), torch_phase_qnode_value_and_grad(), torch_phase_qnode_transform_audit(), torch_phase_qnode_compile_audit(), torch_phase_qnode_compile_boundary_audit(), torch_bounded_qnn_value_and_grad(), torch_autograd_qnn_value_and_grad(), run_torch_func_compatibility_audit(), run_torch_compile_compatibility_audit(), torch_bounded_qnn_module(), torch_bounded_qnn_layer(), run_torch_module_wrapper_audit(), run_torch_training_loop_audit(), run_torch_ecosystem_maturity_audit(), plan_torch_cloud_validation_batch(), run_torch_maturity_audit()
scpn_quantum_control.phase.torch_bridge_contracts¶
Immutable NumPy/stdlib result contracts for the optional Torch bridge.
Source · Public symbols: 19
Classes: PhaseTorchParameterShiftResult, PhaseTorchQNNGradientResult, PhaseTorchAutogradQNNGradientResult, PhaseTorchFuncCompatibilityResult, PhaseTorchCompileCompatibilityResult, PhaseTorchModuleWrapperAuditResult, PhaseTorchTrainingLoopAuditResult, PhaseTorchPhaseQNodeStatevectorResult, PhaseTorchPhaseQNodeTransformResult, PhaseTorchPhaseQNodeCompileResult, PhaseTorchCompileBoundaryRoute, PhaseTorchCompileBoundaryAuditResult, PhaseTorchLiveOverlayEvidence, PhaseTorchEcosystemMaturityRoute, PhaseTorchEcosystemMaturityAuditResult, PhaseTorchCloudValidationRunSpec, PhaseTorchMaturityAuditResult, PhaseTorchPhaseQNodeLoweringRoute, PhaseTorchPhaseQNodeLoweringMatrixResult
scpn_quantum_control.phase.torch_checkpoint¶
Checkpoint replay utilities for bounded PyTorch phase-QNN modules.
Source · Public symbols: 3
Classes: PhaseTorchCheckpointRoute, PhaseTorchCheckpointAuditResult
Functions: run_torch_module_checkpoint_audit()
scpn_quantum_control.phase.torch_checkpoint_matrix¶
Long-lived checkpoint matrix utilities for bounded PyTorch phase-QNN modules.
Source · Public symbols: 5
Classes: PhaseTorchCheckpointMatrixRoute, PhaseTorchCheckpointMatrixTensorMetadata, PhaseTorchCheckpointRuntimeFingerprint, PhaseTorchCheckpointMatrixResult
Functions: run_torch_long_lived_checkpoint_matrix()
scpn_quantum_control.phase.torch_compatibility¶
Bounded Torch transforms, modules, and deterministic training evidence.
Source · Public symbols: 6
Functions: run_torch_func_compatibility_audit(), run_torch_compile_compatibility_audit(), torch_bounded_qnn_module(), torch_bounded_qnn_layer(), run_torch_module_wrapper_audit(), run_torch_training_loop_audit()
scpn_quantum_control.phase.torch_device_state¶
Device-state replay utilities for bounded PyTorch phase-QNN modules.
Source · Public symbols: 3
Classes: PhaseTorchDeviceStateRoute, PhaseTorchDeviceStateAuditResult
Functions: run_torch_module_device_state_audit()
scpn_quantum_control.phase.torch_dynamic_shape_export¶
Dynamic-batch torch.export replay for bounded phase-QNN modules.
Source · Public symbols: 6
Classes: PhaseTorchDynamicShapeExportReplayCase, PhaseTorchDynamicShapeExportRecord, PhaseTorchDynamicShapeExportRoute, PhaseTorchDynamicShapeExportResult
Functions: default_torch_dynamic_shape_export_replay_cases(), run_torch_dynamic_shape_export_audit()
scpn_quantum_control.phase.torch_export¶
Export-persistence utilities for bounded PyTorch phase-QNN modules.
Source · Public symbols: 3
Classes: PhaseTorchExportRoute, PhaseTorchExportAuditResult
Functions: run_torch_module_export_audit()
scpn_quantum_control.phase.torch_export_shape_matrix¶
Static-shape export matrix for bounded PyTorch phase-QNN modules.
Source · Public symbols: 6
Classes: PhaseTorchExportShapeScenario, PhaseTorchExportShapeMatrixRoute, PhaseTorchExportShapeMatrixRecord, PhaseTorchExportShapeMatrixResult
Functions: default_torch_export_shape_scenarios(), run_torch_export_shape_matrix()
scpn_quantum_control.phase.torch_gradients¶
Bounded Torch gradient execution and its direct runtime primitives.
Source · Public symbols: 3
Functions: torch_parameter_shift_value_and_grad(), torch_bounded_qnn_value_and_grad(), torch_autograd_qnn_value_and_grad()
scpn_quantum_control.phase.torch_maturity¶
Torch lowering declarations, cloud planning, and maturity aggregation.
Source · Public symbols: 4
Functions: run_torch_phase_qnode_lowering_matrix(), run_torch_ecosystem_maturity_audit(), plan_torch_cloud_validation_batch(), run_torch_maturity_audit()
scpn_quantum_control.phase.torch_module_state¶
State-dictionary utilities for bounded PyTorch phase-QNN modules.
Source · Public symbols: 6
Classes: PhaseTorchModuleStateTensorMismatch, PhaseTorchModuleStateValidationResult, PhaseTorchModuleStateRoute, PhaseTorchModuleStateAuditResult
Functions: validate_torch_bounded_qnn_state_dict(), run_torch_module_state_audit()
scpn_quantum_control.phase.torch_qnode_transforms¶
Native Torch execution and compiler diagnostics for registered Phase-QNodes.
Source · Public symbols: 4
Functions: torch_phase_qnode_value_and_grad(), torch_phase_qnode_transform_audit(), torch_phase_qnode_compile_audit(), torch_phase_qnode_compile_boundary_audit()
scpn_quantum_control.phase.torch_training_loop_matrix¶
Training-loop matrix utilities for bounded PyTorch phase-QNN modules.
Source · Public symbols: 6
Classes: PhaseTorchTrainingLoopScenario, PhaseTorchTrainingLoopMatrixRoute, PhaseTorchTrainingLoopMatrixRecord, PhaseTorchTrainingLoopMatrixResult
Functions: default_torch_training_loop_scenarios(), run_torch_training_loop_matrix()
scpn_quantum_control.phase.trainability¶
Barren-plateau diagnostics and finite-shot dry-run planning.
Source · Public symbols: 4
Classes: TrainabilityGradientSample, AdaptiveShotAllocationDryRun, BarrenPlateauTrainabilityReport
Functions: run_barren_plateau_trainability_report()
scpn_quantum_control.phase.transform_nesting¶
Fail-closed transform-nesting planner for quantum gradients.
Source · Public symbols: 5
Classes: GradientTransformNestingPlan, GradientTransformNestingAuditResult
Functions: plan_gradient_transform_nesting(), assert_gradient_transform_nesting_supported(), run_gradient_transform_nesting_audit()
scpn_quantum_control.phase.trotter_error¶
Trotter error analysis for the XY Kuramoto Hamiltonian.
Source · Public symbols: 7
Functions: trotter_error_norm(), trotter_error_sweep(), commutator_norm_bound(), nested_commutator_norm_bound(), trotter_error_bound(), optimal_dt(), frequency_heterogeneity()
scpn_quantum_control.phase.trotter_upde¶
Quantum 16-layer UPDE solver: multi-site spin chain.
Source · Public symbols: 3
Classes: UPDEStepResult, UPDETrajectoryResult, QuantumUPDESolver
scpn_quantum_control.phase.variational_metric¶
Exact variational-dynamics linear system for a fixed parametrised ansatz.
Source · Public symbols: 5
Functions: assert_single_parameter_rotations(), analytic_state_derivatives(), mclachlan_metric(), real_time_force(), imaginary_time_force()
scpn_quantum_control.phase.varqite¶
Variational Quantum Imaginary Time Evolution (VarQITE).
Source · Public symbols: 2
Classes: VarQITEResult
Functions: varqite_ground_state()
scpn_quantum_control.phase.xy_compiler¶
Domain-specific circuit compiler for XY Hamiltonian evolution.
Source · Public symbols: 3
Functions: xy_gate(), compile_xy_trotter(), depth_comparison()
scpn_quantum_control.phase.xy_kuramoto¶
Quantum Kuramoto solver via XY spin Hamiltonian + Trotter evolution.
Source · Public symbols: 2
Classes: TrotterEvolutionConfig, QuantumKuramotoSolver
psi_field¶
scpn_quantum_control.psi_field.infoton¶
Infoton: scalar field coupled to the U(1) gauge via covariant derivative.
Source · Public symbols: 4
Classes: InfitonField
Functions: gauge_covariant_kinetic(), matter_action(), create_infoton()
scpn_quantum_control.psi_field.lattice¶
Compact U(1) lattice gauge theory on arbitrary graph topologies.
Source · Public symbols: 3
Classes: PlaquetteResult, U1LatticGauge
Functions: hmc_update()
scpn_quantum_control.psi_field.observables¶
Gauge-invariant observables for the U(1) Ψ-field lattice.
Source · Public symbols: 4
Functions: polyakov_loop(), topological_charge(), string_tension_from_wilson(), average_link()
scpn_quantum_control.psi_field.scpn_mapping¶
Map the 15+1 SCPN layer hierarchy onto a lattice gauge topology.
Source · Public symbols: 2
Classes: SCPNLattice
Functions: scpn_to_lattice()
qec¶
scpn_quantum_control.qec.biological_cli¶
CLI utilities for biological surface-code execution artefacts.
Source · Public symbols: 2
Functions: build_parser(), main()
scpn_quantum_control.qec.biological_diagnostics¶
Biology-oriented topology diagnostics for Biological Surface Code graphs.
Source · Public symbols: 2
Classes: BiologicalSurfaceDiagnostics
Functions: analyse_biological_surface_code()
scpn_quantum_control.qec.biological_pipeline¶
End-to-end biological surface-code pipeline helpers.
Source · Public symbols: 4
Classes: BiologicalQecExecution, BiologicalQecBatchExecution
Functions: run_biological_qec_execution(), run_biological_qec_batch_execution()
scpn_quantum_control.qec.biological_surface_code¶
Topological Quantum Error Correction: Biological Surface Code.
Source · Public symbols: 2
Classes: BiologicalSurfaceCode, BiologicalMWPMDecoder
scpn_quantum_control.qec.control_qec¶
QEC for quantum control signals using a toric surface code and MWPM decoder.
Source · Public symbols: 3
Classes: SurfaceCode, MWPMDecoder, ControlQEC
scpn_quantum_control.qec.dla_protected_scar¶
DLA-protected scar-memory prototypes with finite-time revivals.
Source · Public symbols: 6
Classes: DLAProtectedScarSpec, DLAProtectedScarPrototype, DLAProtectedScarSimulationResult
Functions: build_dla_protected_scar_prototype(), simulate_dla_protected_scar_memory(), evaluate_dla_protected_scar_counts()
scpn_quantum_control.qec.dla_protected_subspace¶
DLA-protected logical synchronisation subspaces.
Source · Public symbols: 11
Classes: DLAProtectedSubspaceSpec, DLAProtectionCertificate, DLAProtectedMemoryPrototype, DLAProtectedWitnessResult, DLAProtectedLogicalSyncWitness
Functions: certify_dla_protected_subspace(), build_dla_protected_memory_prototype(), protected_memory_mask(), sync_memory_mask(), protected_logical_words(), evaluate_dla_protected_memory()
scpn_quantum_control.qec.error_budget¶
Surface code error budget for Kuramoto-XY simulation.
Source · Public symbols: 5
Classes: ErrorBudget
Functions: logical_error_rate(), minimum_code_distance(), compute_error_budget(), compare_error_budgets()
scpn_quantum_control.qec.fault_tolerant¶
Repetition-code UPDE simulation with bit-flip protected logical qubits.
Source · Public symbols: 2
Classes: LogicalQubit, RepetitionCodeUPDE
scpn_quantum_control.qec.logical_dla_parity¶
Logical-level DLA parity resource roadmap.
Source · Public symbols: 9
Classes: LogicalDLAParityRow, MultiscaleComparison
Functions: surface_code_physical_qubits(), repetition_scaffold_physical_qubits(), estimate_logical_dla_parity_row(), estimate_s7_resource_table(), compare_flat_surface_code_to_multiscale(), logical_dla_parity_payload(), logical_dla_parity_markdown()
scpn_quantum_control.qec.multiscale_qec¶
Hierarchical QEC across SCPN layers via concatenated surface codes.
Source · Public symbols: 5
Classes: QECLevel, MultiscaleQECResult
Functions: knm_between_domains(), concatenated_logical_rate(), build_multiscale_qec()
scpn_quantum_control.qec.surface_code_upde¶
Build a structural surface-code UPDE circuit and resource scaffold.
Source · Public symbols: 2
Classes: SurfaceCodeSpec, SurfaceCodeUPDE
scpn_quantum_control.qec.syndrome_flow¶
Syndrome information flow between MS-QEC levels.
Source · Public symbols: 3
Classes: SyndromeFlow
Functions: syndrome_flow_between_levels(), syndrome_flow_analysis()
qsnn¶
scpn_quantum_control.qsnn.dynamic_coupling¶
Dynamic Quantum-Classical Co-Evolution (Quantum Hebbian Learning).
Source · Public symbols: 1
Classes: DynamicCouplingEngine
scpn_quantum_control.qsnn.qlayer¶
Quantum dense layer: multi-qubit entangled spiking network.
Source · Public symbols: 1
Classes: QuantumDenseLayer
scpn_quantum_control.qsnn.qlif¶
Quantum LIF neuron: Ry rotation + Z-basis measurement.
Source · Public symbols: 1
Classes: QuantumLIFNeuron
scpn_quantum_control.qsnn.qstdp¶
Quantum STDP learning via the parameter-shift rule.
Source · Public symbols: 1
Classes: QuantumSTDP
scpn_quantum_control.qsnn.qsynapse¶
Quantum synapse: controlled-Ry gate.
Source · Public symbols: 1
Classes: QuantumSynapse
scpn_quantum_control.qsnn.quantum_neuromorphic_bridge¶
Quantum neuromorphic bridge for QSNN experiments.
Source · Public symbols: 7
Classes: RecurrentCouplingPolicy, QuantumLIFConfig, TraceSTDPConfig, DynamicCouplingConfig, TraceSTDPState, NeuromorphicStepResult, QuantumNeuromorphicBridge
scpn_quantum_control.qsnn.training¶
Parameter-shift gradient training for QuantumDenseLayer.
Source · Public symbols: 4
Classes: QSNNTrainingDiagnostics, QSNNTrainingRun, QSNNParameterShiftDescentRun, QSNNTrainer
sensing¶
scpn_quantum_control.sensing.nv_magnetometry_20T¶
Nitrogen-vacancy (NV) centre magnetometry response model into the 20 T regime.
Source · Public symbols: 9
Classes: NVCenter, NVFieldCalibration
Functions: nv_ground_state_hamiltonian(), nv_energy_levels_hz(), odmr_resonances_hz(), cw_odmr_dc_sensitivity_t_per_sqrt_hz(), odmr_spectrum(), simulate_odmr_measurement(), calibrate_field_from_odmr()
ssgf¶
scpn_quantum_control.ssgf.quantum_costs¶
Quantum cost terms for SSGF integration.
Source · Public symbols: 5
Classes: QuantumCosts
Functions: compute_c_micro(), compute_c4_tcbo(), compute_c_pgbo(), compute_quantum_costs()
scpn_quantum_control.ssgf.quantum_gradient¶
SSGF quantum gradient: dC_quantum/dz via parameter-shift rule.
Source · Public symbols: 3
Classes: QuantumGradientResult
Functions: quantum_cost(), compute_quantum_gradient()
scpn_quantum_control.ssgf.quantum_outer_cycle¶
Quantum SSGF outer cycle: variational geometry descent via quantum cost.
Source · Public symbols: 3
Classes: OuterCycleResult
Functions: classical_cost(), quantum_outer_cycle()
scpn_quantum_control.ssgf.quantum_spectral¶
Spectral bridge: Fiedler value from quantum phase estimation.
Source · Public symbols: 6
Classes: SpectralBridgeResult
Functions: laplacian_spectrum(), entrainment_criterion(), qpe_resource_estimate(), spectral_bridge_analysis(), spectral_bridge_vs_coupling()
studio¶
scpn_quantum_control.studio.benchmark_databank_bundle¶
Federate the committed native-speedup benchmark rows as a schema-B bundle.
Source · Public symbols: 2
Functions: build_benchmark_databank_bundle(), main()
scpn_quantum_control.studio.coupling_invariant¶
Emit the effective-coupling invariant as a schema-B evidence bundle.
Source · Public symbols: 6
Classes: CouplingInvariantSource, CouplingInvariantPayload
Functions: build_coupling_invariant_payload(), validate_coupling_invariant_payload(), build_coupling_invariant_bundle(), main()
scpn_quantum_control.studio.coverage_frontier¶
WS-6 coverage-frontier report for QUANTUM's differentiable claim ledger.
Source · Public symbols: 5
Classes: CoverageFrontierReport
Functions: map_claim_status(), measure_coverage_frontier(), measure_coverage_frontier_from_certifications(), render_coverage_frontier_markdown()
scpn_quantum_control.studio.evidence_bundle¶
Emit schema-B STUDIO evidence bundles from QUANTUM ledgers.
Source · Public symbols: 8
Classes: StudioBundleValidation
Functions: evidence_axes(), build_claim_ledger_bundle(), build_claim_ledger_bundles(), build_hardware_result_pack_bundle(), build_hardware_result_pack_bundles(), validate_bundle(), validate_bundles()
scpn_quantum_control.studio.executive¶
Executive action spine for the standalone SCPN-QUANTUM-CONTROL studio.
Source · Public symbols: 12
Classes: VerbContract, ExecutiveRequest, ExecutionPlan, ExecutionResult, GeneratedScript, ExecutiveRecord, ActionHandler, ActionRegistry
Functions: resolve_verb_contract(), build_generated_script(), preview_action(), run_action()
scpn_quantum_control.studio.executive_analyse¶
The analyse executive action handler — synchronisation witness of a phase cloud.
Source · Public symbols: 1
Classes: AnalyseActionHandler
scpn_quantum_control.studio.executive_benchmark¶
The benchmark executive action handler — native construction speedup.
Source · Public symbols: 4
Classes: BenchmarkActionHandler
Functions: reference_dense_xy_hamiltonian(), native_dense_xy_hamiltonian(), measure_p50_us()
scpn_quantum_control.studio.executive_cli¶
The scpn-studio-run executive dispatch command line interface.
Source · Public symbols: 3
Functions: build_default_registry(), run(), main()
scpn_quantum_control.studio.executive_compile¶
The compile executive action handler — bounded XY compile of a network.
Source · Public symbols: 1
Classes: CompileActionHandler
scpn_quantum_control.studio.executive_differentiate¶
The differentiate executive action handler — the first spine plugin.
Source · Public symbols: 3
Classes: DifferentiateActionHandler
Functions: build_effect_ir(), default_registry()
scpn_quantum_control.studio.executive_execute¶
The execute executive action handler — approval-gated QPU deployment.
Source · Public symbols: 1
Classes: ExecuteActionHandler
scpn_quantum_control.studio.executive_mitigate¶
The mitigate executive action handler — zero-noise extrapolation.
Source · Public symbols: 1
Classes: MitigateActionHandler
scpn_quantum_control.studio.executive_replay¶
The replay executive action handler — hardware-result-pack re-verification.
Source · Public symbols: 1
Classes: ReplayActionHandler
scpn_quantum_control.studio.executive_simulate¶
The simulate executive action handler — bounded XY-Kuramoto evolution.
Source · Public symbols: 1
Classes: SimulateActionHandler
scpn_quantum_control.studio.executive_validate¶
The validate executive action handler — claim-ledger reference validation.
Source · Public symbols: 1
Classes: ValidateActionHandler
scpn_quantum_control.studio.federation¶
The QUANTUM studio's federation document for STUDIO/Hub ingestion.
Source · Public symbols: 5
Functions: build_architecture_map_extension(), build_federation_document(), write_federation_document(), studio_manifest_drift(), main()
scpn_quantum_control.studio.kuramoto_reference¶
Python reference for the WASM Kuramoto live simulator (ST-11).
Source · Public symbols: 5
Classes: KuramotoRun
Functions: encode_kuramoto_input(), order_parameter(), simulate(), decode_output()
scpn_quantum_control.studio.kuramoto_scenario_artifact¶
Committed-artefact emission for the WASM Kuramoto Play panel's ground truth.
Source · Public symbols: 3
Functions: build_kuramoto_scenario_artifact(), validate_kuramoto_scenario_artifact(), main()
scpn_quantum_control.studio.manifest¶
The QUANTUM studio's capability manifest (schema A) on the platform contract.
Source · Public symbols: 2
Functions: declared_surface(), build_manifest()
scpn_quantum_control.studio.program_ad_replay_artifact¶
Committed-artefact emission for the browser-verifiable program-AD gradient replay.
Source · Public symbols: 6
Classes: ProgramADReplayArtifactValidation
Functions: encode_replay_input(), build_program_ad_replay_artifact(), inspect_program_ad_replay_artifact(), validate_program_ad_replay_artifact(), main()
scpn_quantum_control.studio.qec_readiness_bundle¶
Federate the committed offline QEC-readiness decision as a schema-B bundle.
Source · Public symbols: 2
Functions: build_qec_readiness_bundle(), main()
scpn_quantum_control.studio.qpu_result_pack¶
Emit and present the attestation-verifiable studio.qpu-result-pack.v1 unit.
Source · Public symbols: 4
Classes: QpuResultPackPresentation
Functions: build_qpu_result_pack_unit(), present_qpu_result_pack(), seal_qpu_result_pack()
scpn_quantum_control.studio.readout_mitigation_bundle¶
Federate the committed readout-mitigation evidence as a schema-B bundle.
Source · Public symbols: 2
Functions: build_readout_mitigation_bundle(), main()
scpn_quantum_control.studio.recompute_kernel¶
Recompute-verifiable Studio units for deterministic compile claims.
Source · Public symbols: 7
Classes: DecodedXYCompileInput, XYCompileRecomputeUnit
Functions: canonical_xy_compile_input_bytes(), decode_xy_compile_input_bytes(), xy_compile_digest_python(), build_xy_compile_recompute_unit(), verify_xy_compile_recompute_unit()
scpn_quantum_control.studio.reference_validation¶
WS-3 per-claim reference-validation certifications for the Studio frontier.
Source · Public symbols: 4
Classes: ReferenceValidationCertification, ReferenceValidationRegistryValidation, ReferenceValidationRegistry
Functions: load_reference_validation_registry()
scpn_quantum_control.studio.result_pack_seal¶
Seal a QUANTUM hardware result pack into a verifiable honesty envelope (WS-1).
Source · Public symbols: 3
Functions: build_result_pack_unit(), build_provider_attestation(), seal_result_pack()
scpn_quantum_control.studio.scorecard_bundle¶
Emit the differentiable baseline scorecard as a schema-B evidence bundle.
Source · Public symbols: 2
Functions: build_scorecard_bundle(), main()
scpn_quantum_control.studio.support_matrix_bundle¶
Emit the transform-algebra support matrix as a schema-B evidence bundle.
Source · Public symbols: 2
Functions: build_support_matrix_bundle(), main()
scpn_quantum_control.studio.verbs¶
The SCPN-QUANTUM-CONTROL studio's verbs, on the locked platform contract.
Source · Public symbols: 2
Functions: evidence_schemas(), verb_substrates()
scpn_quantum_control.studio.xy_compile_recompute_artifact¶
Committed-artefact emission for a browser-verifiable XY-compile recompute unit.
Source · Public symbols: 3
Functions: build_xy_compile_recompute_artifact(), validate_xy_compile_recompute_artifact(), main()
surrogates¶
scpn_quantum_control.surrogates.fidelity¶
Held-out value and gradient fidelity gates for classical surrogates.
Source · Public symbols: 5
Classes: SurrogateFidelityThresholds, SurrogateFidelityCertificate, SurrogateGradientCertificate
Functions: certify_surrogate_fidelity(), certify_surrogate_gradient()
scpn_quantum_control.surrogates.hybrid¶
BL-33 proposal composition with mandatory exact local validation.
Source · Public symbols: 2
Classes: ExactValidatedSurrogateProposal
Functions: propose_and_validate_surrogate_step()
scpn_quantum_control.surrogates.models¶
Smooth classical surrogates for bounded quantum-objective studies.
Source · Public symbols: 1
Classes: GaussianRBFSurrogate
scpn_quantum_control.surrogates.report¶
Deterministic JSON and Markdown evidence for the BL-45 product.
Source · Public symbols: 4
Classes: SurrogateSupportRow, QuantumReservoirSurrogateEvidence
Functions: render_quantum_reservoir_surrogate_markdown(), write_quantum_reservoir_surrogate_evidence()
scpn_quantum_control.surrogates.train¶
Deterministic fitting for differentiable Gaussian-RBF surrogates.
Source · Public symbols: 3
Classes: SurrogateFitConfig
Functions: input_row_digests(), fit_gaussian_rbf_surrogate()
tcbo¶
scpn_quantum_control.tcbo.quantum_observer¶
Compute small-system TCBO proxy diagnostics from exact ground states.
Source · Public symbols: 2
Classes: TCBOResult
Functions: compute_tcbo_observables()
thermodynamics¶
scpn_quantum_control.thermodynamics.readiness¶
No-submit S9 quantum-thermodynamics readiness model.
Source · Public symbols: 14
Classes: EntropyProductionRate, CalibratedWorkIdentity, IrreversibilityResidual, HeatDissipationRate, ThermodynamicSweepConfig, ThermodynamicSweepRow, ThermodynamicSweepResult
Functions: entropy_production_rate(), calibrated_work_identity(), irreversibility_residual(), heat_dissipation_rate(), run_k_sweep_protocol(), quantum_thermo_payload(), quantum_thermo_markdown()
top_level¶
scpn_quantum_control._constants¶
Shared numerical constants for scpn-quantum-control.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control._paths¶
Locate repository-scoped data files from source and installed layouts.
Source · Public symbols: 2
Functions: project_data_root(), project_data_path()
scpn_quantum_control._rust_accel¶
Single resilient entry point to the optional :mod:oscillatools Rust engine.
Source · Public symbols: 1
Functions: optional_rust_engine()
scpn_quantum_control.active_sensing_product¶
Policy-bounded active sensing over existing sensing and S3 surfaces.
Source · Public symbols: 9
Classes: SensingInventoryRow, InformationGainCandidate, InformationGainScore, ActiveSensingObserverRecord, ActiveSensingPlan
Functions: sensing_surface_inventory(), score_expected_information_gain(), plan_active_sensing(), demo_information_gain_candidates()
scpn_quantum_control.adjoint_replay_product¶
Fail-closed adjoint differentiation via reversible replay product (BL-39).
Source · Public symbols: 15
Classes: AdjointReplaySurfaceRow, CheckpointPolicy, ReversibilityReport, PathEligibilityDecision, MaterialisedAdjointReplayProbe
Functions: list_adjoint_replay_surface_ids(), get_adjoint_replay_surface(), iter_adjoint_replay_surfaces(), build_checkpoint_policy(), assess_reversibility(), decide_adjoint_replay_path(), materialise_demo_adjoint_replay_probe(), map_adjoint_replay_public_surfaces(), build_adjoint_replay_product_registry(), assert_adjoint_replay_product_integrity()
scpn_quantum_control.advanced_witnesses_product¶
Fail-closed advanced witnesses product surface (BL-44).
Source · Public symbols: 27
Classes: WitnessCapabilityRow, WitnessBoundaryRow, WitnessEstimate, PathEligibilityDecision, MaterialisedKrylovProbe, MaterialisedOtocProbe, MaterialisedShadowProbe
Functions: iter_witness_capabilities(), list_witness_capability_ids(), get_witness_capability(), iter_witness_boundaries(), list_witness_boundary_ids(), get_witness_boundary(), list_witness_glossary_keys(), get_witness_glossary_entry(), list_witness_ambient_inventory(), map_advanced_witnesses_public_surfaces(), decide_witness_path(), materialise_krylov_probe(), materialise_demo_krylov_probe(), materialise_otoc_probe(), materialise_demo_otoc_probe(), materialise_shadow_probe(), materialise_demo_shadow_probe(), materialise_bl18_order_parameter_compose(), build_advanced_witnesses_product_registry(), assert_advanced_witnesses_product_integrity()
scpn_quantum_control.advantage_language_protocol¶
Fail-closed advantage-language governance and protocol catalogue (BL-65).
Source · Public symbols: 11
Classes: AdvantageProtocolRecord, NoAdvantageCertificate, AdvantageLanguageProbeResult
Functions: list_advantage_protocol_ids(), get_advantage_protocol(), iter_advantage_protocols(), build_advantage_language_registry(), issue_no_advantage_certificate(), find_advantage_language_triggers(), probe_advantage_language(), assert_advantage_language_registry_integrity()
scpn_quantum_control.attested_result_pack¶
Strip-resistant attested result-pack digests and local envelopes (BL-48).
Source · Public symbols: 9
Classes: AttestedEnvelope, AttestationVerdict
Functions: canonical_content_digest(), build_unsigned_envelope(), verify_attested_envelope(), refuse_invent_green_hardware_attestation(), build_attestation_report(), default_claim_axes(), envelope_from_mapping()
scpn_quantum_control.backend_dispatch¶
Runtime backend selection for array operations.
Source · Public symbols: 6
Functions: set_backend(), get_backend(), get_array_module(), to_numpy(), from_numpy(), available_backends()
scpn_quantum_control.bench_cli¶
One-command benchmark artefact regeneration for the methods papers.
Source · Public symbols: 4
Classes: ExecutionSurfacePolicy, Harness
Functions: run(), main()
scpn_quantum_control.campaign_harness_product¶
Fail-closed campaign harness productisation surface (BL-99).
Source · Public symbols: 15
Classes: CampaignHarnessRow, PathEligibilityDecision, MaterialisedCampaignProbe
Functions: list_campaign_harness_ids(), get_campaign_harness(), iter_campaign_harnesses(), list_ambient_benchmark_family_ids(), decide_campaign_path(), materialise_appqsim_probe(), materialise_iqm_layout_probe(), materialise_closed_loop_probe(), materialise_demo_campaign_probe(), map_campaign_harness_public_surfaces(), build_campaign_harness_product_registry(), assert_campaign_harness_product_integrity()
scpn_quantum_control.circuit_cutting_product¶
Fail-closed circuit-cutting product for large synchronisation workloads.
Source · Public symbols: 12
Classes: CuttingSurfaceRow, CuttingResourceCertificate, SyntheticReconstructionCertificate, CuttingPathDecision
Functions: list_cutting_surface_ids(), get_cutting_surface(), iter_cutting_surfaces(), build_cutting_resource_certificate(), certify_synthetic_reconstruction(), decide_cutting_path(), build_circuit_cutting_product_registry(), assert_circuit_cutting_product_integrity()
scpn_quantum_control.cloud_native_deployment_product¶
Fail-closed cloud-native deployment boundary product surface (BL-101).
Source · Public symbols: 15
Classes: DeploymentPatternRow, ThreatModelRow, PathEligibilityDecision, MaterialisedDeployDryRunProbe
Functions: list_deployment_pattern_ids(), list_threat_ids(), get_deployment_pattern(), iter_deployment_patterns(), decide_deploy_path(), materialise_deploy_dry_run_probe(), materialise_demo_deploy_dry_run_probe(), map_cloud_native_deployment_public_surfaces(), build_cloud_native_deployment_product_registry(), assert_cloud_native_deployment_product_integrity(), compute_spec_digest()
scpn_quantum_control.competitive_baseline_watch¶
Fail-closed continuous competitive-baseline watch surface (BL-61).
Source · Public symbols: 10
Classes: CompetitiveWatchRecord, RefreshProbeResult, FeedProbeResult
Functions: list_competitor_ids(), get_competitive_watch(), iter_competitive_watch(), probe_refresh(), probe_feed(), build_competitive_baseline_watch_registry(), assert_competitive_baseline_watch_integrity()
scpn_quantum_control.compile_budget¶
Resource guards for sparse Pauli-operator construction in the Kuramoto compiler.
Source · Public symbols: 6
Classes: PauliOperatorBudgetError, PauliOperatorEstimate
Functions: pauli_term_upper_bound(), pauli_budget_bytes(), estimate_pauli_operator(), require_pauli_operator_budget()
scpn_quantum_control.compiler_boundary_product¶
Fail-closed external compiler boundary register product surface (BL-66).
Source · Public symbols: 12
Classes: CompilerBoundaryRow, PathEligibilityDecision, MaterialisedCompilerBoundaryProbe
Functions: list_compiler_ids(), get_compiler_boundary(), iter_compiler_boundaries(), decide_compiler_path(), materialise_compiler_boundary_probe(), materialise_demo_compiler_boundary_probe(), map_compiler_boundary_public_surfaces(), build_compiler_boundary_product_registry(), assert_compiler_boundary_product_integrity()
scpn_quantum_control.config¶
Single source of truth for runtime configuration.
Source · Public symbols: 3
Classes: SCPNConfig
Functions: get_config(), reload_config()
scpn_quantum_control.control_stack_compose_product¶
Fail-closed compose existing control/* product surface (BL-67).
Source · Public symbols: 15
Classes: OwnershipRow, AdapterPortRow, PathEligibilityDecision, MaterialisedClosedLoopTelemetryProbe
Functions: list_ownership_module_ids(), list_adapter_port_ids(), get_ownership_row(), get_adapter_port(), iter_ownership_rows(), decide_control_compose_path(), materialise_closed_loop_telemetry_probe(), materialise_demo_closed_loop_telemetry_probe(), map_control_stack_compose_public_surfaces(), build_control_stack_compose_product_registry(), assert_control_stack_compose_product_integrity()
scpn_quantum_control.control_stack_runtime_adapters¶
Executable BL-67 adapters over existing control and co-simulation surfaces.
Source · Public symbols: 12
Classes: PolicyGatedAdapterError, RealtimeFeedbackPort, QaoaMpcPort, RealtimeFeedbackAdapterResult, QaoaMpcAdapterResult, CosimulationPartitionTelemetry, CosimulationPartitionAdapterResult, PulseComposeBoundaryDecision
Functions: run_realtime_feedback_adapter(), run_qaoa_mpc_adapter(), run_cosimulation_partition_adapter(), decide_pulse_compose_boundary()
scpn_quantum_control.custom_derivatives_product¶
Fail-closed custom / registered derivatives product surface (BL-92).
Source · Public symbols: 16
Classes: CustomDerivativeContractRow, RegistrationResult
Functions: list_custom_derivative_contract_ids(), get_custom_derivative_contract(), iter_custom_derivative_contracts(), registration_contract_policy(), parse_product_identity(), build_example_scaled_linear_rule(), new_product_registry(), register_product_custom_rule(), require_product_custom_rule(), list_product_registered_identities(), probe_example_rule_round_trip(), map_custom_derivatives_public_surfaces(), build_custom_derivatives_product_registry(), assert_custom_derivatives_product_integrity()
scpn_quantum_control.dense_budget¶
Memory guards for dense Hilbert-space allocations.
Source · Public symbols: 9
Classes: DenseAllocationError, DenseAllocationEstimate
Functions: hilbert_dimension(), dense_object_bytes(), available_memory_bytes(), dense_budget_bytes(), estimate_dense_allocation(), require_dense_allocation(), require_dense_eigensolver_workspace()
scpn_quantum_control.diff¶
Canonical first-path namespace for differentiable quantum-control workflows.
Source · Public symbols: 10
Classes: ShotPolicy, EstimatorProvenance, BackendCapabilityMetadata, DifferentiableCircuitDiagnostics, JITExplanation, DifferentiableCircuit
Functions: differentiable_circuit(), jit_or_explain(), supported_transforms(), namespace_metadata()
scpn_quantum_control.diff_contract_audit¶
Executable DP-004 contract audit for differentiable circuit facades.
Source · Public symbols: 3
Classes: DifferentiableCircuitContractCheck, DifferentiableCircuitContractAuditResult
Functions: run_differentiable_circuit_contract_audit()
scpn_quantum_control.differentiable¶
Native differentiable-programming primitives for SCPN quantum objectives.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.differentiable_api¶
Unified differentiable-programming facade over supported local routes.
Source · Public symbols: 18
Functions: differentiable_value(), differentiable_gradient(), differentiable_jacobian(), differentiable_hessian(), differentiable_support_report(), explain_differentiability(), differentiable_compile_report(), differentiable_benchmark_report(), differentiable_baseline_scorecard_report(), differentiable_competitive_baseline_refresh_report(), differentiable_rust_python_inventory_report(), differentiable_architecture_map_report(), differentiable_dependency_environment_map_report(), differentiable_isolated_benchmark_plan_report(), differentiable_transform_algebra_report(), differentiable_qfi_fss_report(), differentiable_frontend_report(), differentiable_api()
scpn_quantum_control.differentiable_api_contracts¶
Immutable envelopes and type contracts for the unified differentiable API.
Source · Public symbols: 4
Classes: UnifiedDifferentiableAPIResult, DifferentiabilityDiagnosticReport, DifferentiableDashboardCapabilityRow, DifferentiableDashboardStatus
scpn_quantum_control.differentiable_architecture_map¶
Architecture and Rustification map for differentiable-programming governance.
Source · Public symbols: 6
Classes: DifferentiableArchitectureMapLayer, DifferentiableArchitectureMap, DifferentiableArchitectureMapValidation
Functions: run_differentiable_architecture_map(), validate_differentiable_architecture_map(), render_differentiable_architecture_map_markdown()
scpn_quantum_control.differentiable_baseline_scorecard¶
Baseline scorecard governance for differentiable computing claims.
Source · Public symbols: 8
Classes: DifferentiableBaselineScorecardRow, DifferentiableBaselineScorecard, DifferentiableBaselineScorecardValidation, DifferentiablePromotionLanguageAudit
Functions: run_differentiable_baseline_scorecard(), validate_differentiable_baseline_scorecard(), audit_differentiable_promotion_language(), render_differentiable_baseline_scorecard_markdown()
scpn_quantum_control.differentiable_batch_helpers¶
Batch and sample tensor validation helpers for native transforms.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.differentiable_benchmark_report¶
Claim-bounded local differentiable benchmark report builders.
Source · Public symbols: 2
Classes: DifferentiableBenchmarkReport
Functions: build_differentiable_benchmark_report()
scpn_quantum_control.differentiable_canonical_api¶
Canonical differentiable transform dispatchers.
Source · Public symbols: 2
Functions: value_and_grad(), grad()
scpn_quantum_control.differentiable_claim_ledger¶
Claim ledger for bounded differentiable Phase-QNode evidence.
Source · Public symbols: 10
Classes: ClaimLedgerRow, ClaimLedger, ClaimLedgerValidation, DifferentiableSupportSurfaceAlignment
Functions: load_differentiable_claim_ledger(), load_differentiable_support_surface_alignment(), validate_claim_ledger(), validate_public_language_against_ledger(), validate_differentiable_support_surface_alignment(), validate_public_claim_table()
scpn_quantum_control.differentiable_claim_rendering¶
Render bounded differentiable claim evidence as deterministic Markdown.
Source · Public symbols: 3
Functions: render_claim_ledger_markdown(), render_differentiable_support_surface_alignment_markdown(), render_public_claim_table()
scpn_quantum_control.differentiable_competitive_baselines¶
Freshness gate for differentiable-computing competitive baselines.
Source · Public symbols: 9
Classes: CompetitiveBaselineRow, CompetitiveBaselineRefresh, CompetitiveBaselineValidation, CompetitiveBaselinePromotionGate
Functions: run_competitive_baseline_refresh(), load_competitive_baseline_refresh(), validate_competitive_baseline_refresh(), audit_competitive_baseline_promotion_gate(), render_competitive_baseline_refresh_markdown()
scpn_quantum_control.differentiable_consistency¶
Consistency diagnostics for native differentiable transforms.
Source · Public symbols: 2
Functions: check_parameter_shift_consistency(), check_custom_derivative_consistency()
scpn_quantum_control.differentiable_custom_derivatives¶
Exact custom JVP, VJP, and Jacobian transform wrappers.
Source · Public symbols: 12
Functions: custom_jvp(), batch_custom_jvp(), batch_value_and_custom_jvp(), value_and_custom_jvp(), custom_vjp(), batch_custom_vjp(), batch_value_and_custom_vjp(), value_and_custom_vjp(), custom_jacobian(), batch_custom_jacobian(), batch_value_and_custom_jacobian(), value_and_custom_jacobian()
scpn_quantum_control.differentiable_dashboard¶
Claim-bounded capability catalog for differentiable dashboard consumers.
Source · Public symbols: 1
Functions: differentiable_dashboard_status()
scpn_quantum_control.differentiable_dependency_environment_evidence¶
Version-pin and execution-route evidence for differentiable environments.
Source · Public symbols: 2
Classes: DifferentiableDependencyEnvironmentEvidence
Functions: build_differentiable_dependency_environment_evidence()
scpn_quantum_control.differentiable_dependency_environment_map¶
Dependency and environment evidence map for differentiable-programming governance.
Source · Public symbols: 6
Classes: DifferentiableDependencyEnvironmentProfile, DifferentiableDependencyEnvironmentMap, DifferentiableDependencyEnvironmentMapValidation
Functions: run_differentiable_dependency_environment_map(), validate_differentiable_dependency_environment_map(), render_differentiable_dependency_environment_map_markdown()
scpn_quantum_control.differentiable_exact_modes¶
Exact scalar forward- and reverse-mode gradient wrappers.
Source · Public symbols: 4
Functions: value_and_forward_mode_grad(), forward_mode_gradient(), value_and_reverse_mode_grad(), reverse_mode_gradient()
scpn_quantum_control.differentiable_external_validation¶
External-validation package manifests for differentiable evidence.
Source · Public symbols: 15
Classes: EnvironmentLockfileSummary, ExternalValidationEnvironmentLock, ExternalValidationEnvironmentLockValidation, ExternalValidationArtifactEntry, ExternalValidationArtifactBundle
Functions: summarize_environment_lockfile(), summarize_artifact_entry(), build_external_validation_environment_lock(), build_external_validation_artifact_bundle(), load_external_validation_environment_lock(), load_external_validation_artifact_bundle(), validate_external_validation_environment_lock(), validate_external_validation_artifact_bundle(), render_external_validation_environment_lock_markdown(), render_external_validation_artifact_bundle_markdown()
scpn_quantum_control.differentiable_finite_difference¶
Finite-difference and complex-step diagnostic differentiable transforms.
Source · Public symbols: 37
Functions: finite_difference_gradient(), complex_step_gradient(), batch_complex_step_gradient(), batch_value_and_complex_step_grad(), value_and_jacobian(), jacobian(), value_and_jacfwd(), jacfwd(), value_and_jacrev(), jacrev(), value_and_hessian(), hessian(), batch_value_and_finite_difference_grad(), value_and_complex_step_grad(), value_and_finite_difference_grad(), finite_difference_jacobian(), value_and_finite_difference_jacobian(), finite_difference_jvp(), value_and_jvp(), jvp(), value_and_finite_difference_jvp(), batch_finite_difference_jvp(), batch_value_and_finite_difference_jvp(), vector_jacobian_product(), finite_difference_vjp(), value_and_finite_difference_vjp(), value_and_vjp(), vjp(), batch_vector_jacobian_product(), batch_finite_difference_vjp(), batch_value_and_finite_difference_vjp(), finite_difference_hessian(), value_and_finite_difference_hessian(), finite_difference_hvp(), value_and_finite_difference_hvp(), batch_finite_difference_hvp(), batch_value_and_finite_difference_hvp()
scpn_quantum_control.differentiable_fisher¶
Empirical-Fisher matrix-free solves for residual-map derivatives.
Source · Public symbols: 3
Functions: empirical_fisher_vector_product(), empirical_fisher_conjugate_gradient(), least_squares_covariance()
scpn_quantum_control.differentiable_framework_overlay¶
Reproducible CPU-only overlay profile for optional AD frameworks.
Source · Public symbols: 9
Classes: FrameworkOverlayManifest, FrameworkOverlayVerification
Functions: default_framework_overlay_path(), build_framework_overlay_manifest(), install_framework_overlay(), verify_framework_overlay_manifest(), verify_framework_overlay_path(), framework_overlay_pythonpath(), main()
scpn_quantum_control.differentiable_gradient_descent¶
Native gradient-descent optimizer for differentiable scalar objectives.
Source · Public symbols: 1
Classes: DifferentiableOptimizer
scpn_quantum_control.differentiable_implicit_sensitivity¶
Implicit stationary and fixed-point sensitivity solvers.
Source · Public symbols: 2
Functions: implicit_stationary_sensitivity(), implicit_fixed_point_sensitivity()
scpn_quantum_control.differentiable_jax_adapter¶
Optional JAX autodiff adapter for native differentiable objectives.
Source · Public symbols: 2
Functions: is_jax_autodiff_available(), jax_value_and_grad()
scpn_quantum_control.differentiable_levenberg_marquardt¶
Levenberg-Marquardt and Gauss-Newton residual optimization helpers.
Source · Public symbols: 7
Classes: LevenbergMarquardtOptimizer
Functions: gauss_newton_gradient(), custom_gauss_newton_gradient(), levenberg_marquardt_step(), custom_levenberg_marquardt_step(), evaluate_levenberg_marquardt_step(), update_levenberg_marquardt_damping()
scpn_quantum_control.differentiable_module_hardening_audit¶
Module coverage and diagnostic audit for differentiable-programming surfaces.
Source · Public symbols: 4
Classes: DifferentiableModuleHardeningRecord, DifferentiableModuleHardeningAuditResult
Functions: differentiable_module_hardening_registry(), run_differentiable_module_hardening_audit()
scpn_quantum_control.differentiable_natural_gradient¶
Natural-gradient preconditioning and scalar line-search helpers.
Source · Public symbols: 4
Classes: NaturalGradientOptimizer
Functions: armijo_backtracking_line_search(), weighted_gradient_sum(), natural_gradient()
scpn_quantum_control.differentiable_parameter_contracts¶
Parameter metadata and validation contracts for differentiable objectives.
Source · Public symbols: 4
Classes: Parameter, ParameterBounds, ParameterShiftRule
Functions: multi_frequency_parameter_shift_rule()
scpn_quantum_control.differentiable_parameter_shift¶
Parameter-shift transforms for scalar differentiable objectives.
Source · Public symbols: 5
Functions: parameter_shift_gradient(), batch_parameter_shift_gradient(), batch_value_and_parameter_shift_grad(), value_and_parameter_shift_grad(), parameter_shift_gradient_with_uncertainty()
scpn_quantum_control.differentiable_registered_custom¶
Registry-backed custom derivative wrappers for native transforms.
Source · Public symbols: 3
Functions: registered_custom_jvp(), registered_custom_vjp(), registered_custom_jacobian()
scpn_quantum_control.differentiable_residual_weights¶
IRLS residual weighting helpers for differentiable least-squares paths.
Source · Public symbols: 2
Functions: huber_residual_weights(), soft_l1_residual_weights()
scpn_quantum_control.differentiable_result_contracts¶
Validated result records for native differentiable-programming transforms.
Source · Public symbols: 32
Classes: GradientResult, FiniteShotSampleProvenance, ParameterShiftSampleRecord, StochasticGradientResult, SPSAObjectiveSample, SPSAProbeRecord, SPSAGradientResult, ScoreFunctionSampleRecord, ScoreFunctionGradientResult, ShotAllocationResult, OptimizationResult, ArmijoLineSearchResult, GradientCheckResult, CustomDerivativeCheckResult, JacobianResult, JVPResult, VJPResult, HessianResult, SparseMatrixResult, HVPResult, NaturalGradientResult, NaturalGradientOptimizationResult, LevenbergMarquardtStep, LevenbergMarquardtTrial, LevenbergMarquardtDampingUpdate, LevenbergMarquardtResult, LeastSquaresCovarianceResult, FisherVectorProductResult, FisherConjugateGradientResult, WeightedGradientResult, ImplicitSensitivityResult, FixedPointSensitivityResult
scpn_quantum_control.differentiable_rust_python_inventory¶
Rust/Python inventory governance for differentiable rustification planning.
Source · Public symbols: 6
Classes: DifferentiableRustPythonInventoryRow, DifferentiableRustPythonInventory, DifferentiableRustPythonInventoryValidation
Functions: run_differentiable_rust_python_inventory(), validate_differentiable_rust_python_inventory(), render_differentiable_rust_python_inventory_markdown()
scpn_quantum_control.differentiable_scalar_kernels¶
Scalar forward- and reverse-mode automatic differentiation kernels.
Source · Public symbols: 10
Classes: DualNumber, ReverseNode
Functions: dual_sin(), dual_cos(), dual_exp(), dual_log(), reverse_sin(), reverse_cos(), reverse_exp(), reverse_log()
scpn_quantum_control.differentiable_sparse_derivatives¶
Sparse derivative conversion helpers for native differentiable transforms.
Source · Public symbols: 5
Functions: dense_to_sparse_matrix(), sparse_jacobian(), sparse_hessian(), empirical_fisher_metric(), sparse_empirical_fisher_metric()
scpn_quantum_control.differentiable_stochastic_estimators¶
SPSA, score-function, and shot-budget stochastic gradient helpers.
Source · Public symbols: 3
Functions: spsa_gradient_estimate(), score_function_gradient_estimate(), allocate_parameter_shift_shots()
scpn_quantum_control.differentiable_stochastic_policy¶
Fail-closed stochastic-gradient uncertainty policy contracts.
Source · Public symbols: 3
Classes: GradientFailurePolicy, StochasticGradientConfidenceInterval
Functions: gradient_confidence_interval()
scpn_quantum_control.differentiable_transform_algebra¶
Metamorphic transform-algebra gate for differentiable local routes.
Source · Public symbols: 4
Classes: TransformAlgebraCase, TransformAlgebraAudit
Functions: run_transform_algebra_audit(), assert_transform_algebra_audit_passes()
scpn_quantum_control.differentiable_transform_helpers¶
Shared scalar, parameter, bounds, and tape helpers for native transforms.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.differentiable_transform_support_matrix¶
Generated support-matrix rows for the transform-algebra audit.
Source · Public symbols: 3
Classes: TransformAlgebraCaseLike, TransformAlgebraSupportMatrixRow
Functions: build_transform_algebra_support_matrix()
scpn_quantum_control.differentiable_transform_support_matrix_artifact¶
Committed-artefact emission for the transform-algebra support matrix.
Source · Public symbols: 5
Classes: TransformSupportMatrixArtifactValidation
Functions: build_transform_support_matrix_artifact(), validate_transform_support_matrix_artifact(), render_transform_support_matrix_markdown(), main()
scpn_quantum_control.differentiable_vmap¶
Eager vectorization transform for differentiable-programming objectives.
Source · Public symbols: 1
Functions: vmap()
scpn_quantum_control.error_mitigation_product¶
Fail-closed differentiable error-mitigation taxonomy product (BL-59).
Source · Public symbols: 19
Classes: MitigatorTaxonomyRow, MitigationBoundaryRow, PathEligibilityDecision, MaterialisedZneProbe, MaterialisedReadoutProbe
Functions: list_mitigator_ids(), list_mitigation_boundary_ids(), get_mitigator(), get_mitigation_boundary(), iter_mitigators(), iter_mitigation_boundaries(), decide_mitigation_path(), materialise_zne_probe(), materialise_demo_zne_probe(), materialise_readout_probe(), studio_mitigate_claim_boundary(), map_error_mitigation_public_surfaces(), build_error_mitigation_product_registry(), assert_error_mitigation_product_integrity()
scpn_quantum_control.execution_surface¶
Static execution-surface scanner for notebooks and publication scripts.
Source · Public symbols: 8
Classes: ExecutionSurfaceFinding, ExecutionSurfaceManifestEntry, ExecutionSurfaceViolation
Functions: load_execution_surface_manifest(), evaluate_execution_surface_manifest(), iter_execution_surface_paths(), find_unmanifested_high_risk_surfaces(), scan_execution_surface_path()
scpn_quantum_control.fault_tolerant_resource_product¶
Compose existing QEC resource primitives into a conservative BL-36 report.
Source · Public symbols: 12
Classes: FaultTolerantResourceBoundaryError, FormulaReference, SyncProblemResourceRequest, ResourceEstimate, SensitivityPoint, RegimeComparisonRow, FaultTolerantResourceProduct
Functions: estimate_ft_resources(), build_ft_sensitivity(), build_regime_comparison(), build_fault_tolerant_resource_product(), render_ft_resource_markdown()
scpn_quantum_control.geometric_control_product¶
Fail-closed geometric quantum control product surface (BL-50).
Source · Public symbols: 21
Classes: GeometryCapabilityRow, GeometryBoundaryRow, PathEligibilityDecision, MaterialisedMetricDiagnosticsProbe, MaterialisedQngDirectionProbe
Functions: list_geometry_capability_ids(), list_geometry_boundary_ids(), list_geometry_glossary_keys(), get_geometry_glossary_entry(), get_geometry_capability(), get_geometry_boundary(), iter_geometry_capabilities(), iter_geometry_boundaries(), list_geometry_ambient_inventory(), decide_geometry_path(), materialise_metric_diagnostics_probe(), materialise_demo_metric_diagnostics_probe(), materialise_qng_direction_probe(), map_geometric_control_public_surfaces(), build_geometric_control_product_registry(), assert_geometric_control_product_integrity()
scpn_quantum_control.governed_route_matrix¶
Fail-closed multi-ecosystem differentiable route matrix and explain API.
Source · Public symbols: 9
Classes: RouteCapability, GovernedRouteRecord, RouteExplanation
Functions: list_governed_route_ids(), get_governed_route(), iter_governed_routes(), build_governed_route_matrix(), explain_route(), assert_no_blank_matrix_cells()
scpn_quantum_control.gradient_plan_explanation_artifact¶
Committed gradient-plan explanations for the Studio cockpit.
Source · Public symbols: 5
Classes: GradientPlanExplanationArtifactValidation
Functions: build_gradient_plan_explanation_artifact(), validate_gradient_plan_explanation_artifact(), render_gradient_plan_explanation_markdown(), main()
scpn_quantum_control.hardware_result_pack_evidence¶
Generate a release-audit evidence packet for hardware result packs.
Source · Public symbols: 9
Functions: sha256(), utc_stamp(), run_json_command(), run_log_command(), load_manifest(), select_packs(), rel(), parse_pack_ids(), main()
scpn_quantum_control.hardware_result_packs¶
Offline verification and deterministic export for hardware result packs.
Source · Public symbols: 14
Functions: default_repo_root(), sha256(), digest_bytes(), walk_values(), contains_text(), load_manifest(), select_packs(), artifact_path(), verify_manifest(), tarinfo_for_bytes(), write_deterministic_tar_gz(), export_result_packs(), parse_pack_ids(), main()
scpn_quantum_control.hardware_safe_execution¶
Fail-closed hardware-safe gradient execution policy product (BL-47).
Source · Public symbols: 13
Classes: ExecutionPolicy, DryRunPlan, EnforceDecision, AuditRecord
Functions: list_execution_policy_ids(), get_execution_policy(), iter_execution_policies(), default_execution_policy(), dry_run_execution_plan(), enforce_execution_request(), build_audit_record(), build_hardware_safe_execution_registry(), assert_hardware_safe_execution_integrity()
scpn_quantum_control.hermetic_reproduction_kit¶
Hermetic external reproduction kit contract (BL-55).
Source · Public symbols: 13
Classes: KitDigestSpec, HermeticKitEntry, DigestCheckResult
Functions: list_hermetic_kit_entry_ids(), get_hermetic_kit_entry(), iter_hermetic_kit_entries(), build_hermetic_reproduction_kit(), sha256_hex_of(), verify_digest(), verify_kit_entry_digests(), probe_hermetic_kit_entry(), assert_hermetic_kit_integrity(), fixture_payload()
scpn_quantum_control.identity_observer_product¶
Fail-closed control observers over the existing identity metrics.
Source · Public symbols: 7
Classes: IdentityMetricInventoryRow, IdentityObserverThresholds, IdentityObserverRecord, IdentitySafetyDecision
Functions: identity_metric_inventory(), identity_observer_unsuitable_scenarios(), evaluate_identity_safety()
scpn_quantum_control.jax_nqs_baseline_product¶
Build claim-bounded JAX NQS evidence against exact diagonalisation.
Source · Public symbols: 7
Classes: JAXNQSBaselineSpec, JAXNQSEnvironment, JAXNQSComparison, JAXNQSBaselineProduct
Functions: run_jax_nqs_baseline(), render_jax_nqs_baseline_markdown(), write_jax_nqs_baseline_evidence()
scpn_quantum_control.kuramoto¶
Backward-compatible re-export shim for the relocated Kuramoto toolkit facade.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.kuramoto_core¶
Small public facade for Kuramoto-XY problems.
Source · Public symbols: 10
Classes: KuramotoProblem
Functions: validate_kuramoto_inputs(), build_kuramoto_problem(), compile_hamiltonian(), compile_dense_hamiltonian(), compile_trotter_circuit(), compile_analog_program(), compile_hybrid_program(), measure_order_parameter(), simulate_variant_trajectory()
scpn_quantum_control.kyma_mechanism_benchmark_product¶
Fail-closed KYMA / KYMA v2 public mechanism-only benchmark product (BL-73).
Source · Public symbols: 15
Classes: KymaSuiteRow, FrozenDesignConstants, PathEligibilityDecision, MaterialisedMechanismCertificateProbe
Functions: load_frozen_design_constants(), list_kyma_suite_ids(), get_kyma_suite(), iter_kyma_suites(), get_frozen_design_constants(), decide_kyma_path(), materialise_mechanism_certificate_probe(), materialise_demo_mechanism_certificate_probe(), map_kyma_mechanism_benchmark_public_surfaces(), build_kyma_mechanism_benchmark_product_registry(), assert_kyma_mechanism_benchmark_product_integrity()
scpn_quantum_control.logging_setup¶
Structlog-backed logging bootstrap.
Source · Public symbols: 3
Functions: configure_logging(), get_logger(), reset_for_testing()
scpn_quantum_control.metamorphic_ad_verification¶
Versioned metamorphic AD verification catalogue and pure residual checks (BL-46).
Source · Public symbols: 10
Classes: MetamorphicLawRecord, MetamorphicCheckResult
Functions: list_metamorphic_law_ids(), get_metamorphic_law(), iter_metamorphic_laws(), build_metamorphic_ad_registry(), probe_metamorphic_law(), evaluate_linearity_residual(), evaluate_chain_rule_residual(), assert_metamorphic_registry_integrity()
scpn_quantum_control.migration_guides_product¶
Fail-closed PennyLane + Qiskit migration guides product surface (BL-41).
Source · Public symbols: 13
Classes: MigrationConceptRow, PathEligibilityDecision, MaterialisedPennyLaneRoundTrip, MaterialisedQiskitLocalGradient
Functions: list_migration_concept_ids(), get_migration_concept(), iter_migration_concepts(), decide_migration_path(), materialise_demo_pennylane_round_trip(), materialise_demo_qiskit_local_gradient(), map_migration_guides_public_surfaces(), build_migration_guides_product_registry(), assert_migration_guides_product_integrity()
scpn_quantum_control.multi_hal_federation_product¶
Fail-closed Multi-HAL provider federation product surface (BL-75).
Source · Public symbols: 14
Classes: HalCapabilityRecord, PathEligibilityDecision, MaterialisedFederationDryRunProbe
Functions: list_hal_backend_ids(), list_hal_providers(), get_hal_capability(), iter_hal_capabilities(), build_federation_matrix(), decide_federation_route(), materialise_federation_dry_run_probe(), materialise_demo_federation_dry_run_probe(), map_multi_hal_federation_public_surfaces(), build_multi_hal_federation_product_registry(), assert_multi_hal_federation_product_integrity()
scpn_quantum_control.neural_operator_baseline_product¶
Compose existing neural-operator baselines under fail-closed governance.
Source · Public symbols: 8
Classes: BaselineSurfaceRow, ArtifactVerification, DatasetAdmission, IntegrationDisposition, NeuralOperatorBaselineProduct
Functions: verify_neural_operator_artifact(), assess_forecast_dataset(), build_neural_operator_baseline_product()
scpn_quantum_control.notebook_programme_product¶
Fail-closed differentiable notebook programme product surface (BL-40).
Source · Public symbols: 12
Classes: CurriculumNotebookRow, PathEligibilityDecision, MaterialisedCurriculumProbe
Functions: list_curriculum_notebook_ids(), get_curriculum_notebook(), iter_curriculum_notebooks(), decide_notebook_programme_path(), resolve_curriculum_directory(), materialise_curriculum_probe(), map_notebook_programme_public_surfaces(), build_notebook_programme_registry(), assert_notebook_programme_product_integrity()
scpn_quantum_control.open_system_mcwf_product¶
Fail-closed open-system MCWF completeness product surface (BL-51).
Source · Public symbols: 22
Classes: OpenSystemSurfaceRow, OpenSystemBoundaryRow, PathEligibilityDecision, MaterialisedMcwfEnsembleProbe, MaterialisedReproducibilityProbe
Functions: list_open_system_surface_ids(), list_open_system_boundary_ids(), get_open_system_surface(), get_open_system_boundary(), iter_open_system_surfaces(), iter_open_system_boundaries(), decide_open_system_path(), materialise_mcwf_ensemble_probe(), materialise_demo_mcwf_ensemble_probe(), materialise_reproducibility_probe(), export_sim_noise_model(), import_sim_noise_model(), map_open_system_mcwf_public_surfaces(), list_ambient_objective_boundary_ids(), list_default_objective_case_ids(), build_open_system_mcwf_product_registry(), assert_open_system_mcwf_product_integrity()
scpn_quantum_control.pgbo_qgt_product¶
Fail-closed PGBO quantum geometric tensor product surface (BL-71).
Source · Public symbols: 16
Classes: QgtCapabilityRow, QgtBoundaryRow, PathEligibilityDecision, MaterialisedPgboTensorProbe
Functions: list_qgt_capability_ids(), list_qgt_boundary_ids(), get_qgt_capability(), get_qgt_boundary(), iter_qgt_capabilities(), iter_qgt_boundaries(), decide_qgt_path(), materialise_pgbo_tensor_probe(), materialise_demo_pgbo_tensor_probe(), map_pgbo_qgt_public_surfaces(), build_pgbo_qgt_product_registry(), assert_pgbo_qgt_product_integrity()
scpn_quantum_control.phase_qnode_product¶
Fail-closed Phase-QNode product catalogue and journey map (BL-90).
Source · Public symbols: 9
Classes: PhaseQNodeJourney, PhaseQNodeJourneyDecision
Functions: list_phase_qnode_journey_ids(), get_phase_qnode_journey(), iter_phase_qnode_journeys(), dry_run_phase_qnode_journey(), map_phase_qnode_public_surfaces(), build_phase_qnode_product_registry(), assert_phase_qnode_product_integrity()
scpn_quantum_control.polyglot_edge_ad_product¶
Fail-closed polyglot edge Program-AD product (BL-74).
Source · Public symbols: 12
Classes: EdgeADRuntimeRow, EdgeADPathDecision, CommittedWasmReplayCertificate
Functions: list_edge_ad_runtime_ids(), get_edge_ad_runtime(), iter_edge_ad_runtimes(), decide_edge_ad_path(), load_committed_wasm_replay_payload(), materialise_wasm_replay_certificate(), map_polyglot_edge_ad_public_surfaces(), build_polyglot_edge_ad_product_registry(), assert_polyglot_edge_ad_product_integrity()
scpn_quantum_control.polyglot_parity_certificate¶
Fail-closed bit-exact polyglot parity certificate product surface (BL-49).
Source · Public symbols: 14
Classes: ParityFamily, PolyglotParityCertificate, CertificateVerifyDecision
Functions: list_parity_family_ids(), get_parity_family(), iter_parity_families(), canonical_json_bytes(), digest_payload(), build_sample_certificate(), certificate_from_dict(), verify_certificate(), map_parity_public_surfaces(), build_polyglot_parity_product_registry(), assert_polyglot_parity_product_integrity()
scpn_quantum_control.program_ad_adjoint¶
Program AD reverse-adjoint generation result records and accessors.
Source · Public symbols: 7
Classes: ProgramADAdjointStep, ProgramADAdjointResult
Functions: program_adjoint_result(), program_adjoint_gradient(), program_adjoint_replay_gradient(), program_adjoint_grad(), program_adjoint_value_and_grad()
scpn_quantum_control.program_ad_adjoint_generation¶
Reverse-mode adjoint generation over the stabilised whole-program AD IR.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.program_ad_alias_analysis¶
Program AD alias/effect analysis drivers and static-lattice provenance parsing.
Source · Public symbols: 2
Functions: analyze_program_ad_alias_effects(), program_ad_static_alias_lattice_report()
scpn_quantum_control.program_ad_alias_contracts¶
Immutable Program AD alias, lattice, and provenance result contracts.
Source · Public symbols: 10
Classes: ProgramADAliasSet, ProgramADAliasEffectAnalysis, ProgramADStaticAliasLatticeComponent, ProgramADUnknownAliasEdge, ProgramADViewAliasProvenance, ProgramADListAliasProvenance, ProgramADLoopCarriedStateProvenance, ProgramADControlPathAliasProvenance, ProgramADRebindingAliasProvenance, ProgramADStaticAliasLatticeReport
scpn_quantum_control.program_ad_array_indexing¶
Static array-indexing derivative rules for Program AD registry dispatch.
Source · Public symbols: 6
Functions: program_ad_array_getitem_derivative_rule(), program_ad_array_take_derivative_rule(), program_ad_array_take_along_axis_derivative_rule(), program_ad_array_delete_derivative_rule(), program_ad_array_pad_derivative_rule(), program_ad_array_insert_derivative_rule()
scpn_quantum_control.program_ad_assembly_primitives¶
Program AD assembly derivative factories and registry contracts.
Source · Public symbols: 4
Functions: program_ad_assembly_split_derivative_rule(), program_ad_assembly_tril_derivative_rule(), program_ad_assembly_triu_derivative_rule(), program_ad_assembly_diagonal_derivative_rule()
scpn_quantum_control.program_ad_broadcast_assembly¶
Static broadcast assembly derivative rules for Program AD.
Source · Public symbols: 2
Functions: program_ad_assembly_broadcast_to_derivative_rule(), program_ad_assembly_broadcast_arrays_derivative_rule()
scpn_quantum_control.program_ad_cumulative_primitives¶
Static cumulative derivative rules for Program AD registry dispatch.
Source · Public symbols: 3
Functions: program_ad_cumulative_cumsum_derivative_rule(), program_ad_cumulative_cumprod_derivative_rule(), program_ad_cumulative_diff_derivative_rule()
scpn_quantum_control.program_ad_effect_ir¶
Validated Program AD effect-IR records and metadata parser.
Source · Public symbols: 7
Classes: ProgramADSSAValue, ProgramADEffect, ProgramADAliasEdge, ProgramADPhiNode, ProgramADControlRegion, ProgramADEffectIR
Functions: parse_program_ad_effect_ir()
scpn_quantum_control.program_ad_elementwise_primitives¶
Program AD elementwise primitive contracts and direct derivative factories.
Source · Public symbols: 1
Functions: program_ad_elementwise_binary_derivative_rule()
scpn_quantum_control.program_ad_fuzz_assurance¶
Fail-closed Rust Program AD fuzz assurance product surface (BL-96).
Source · Public symbols: 14
Classes: FuzzTarget, FuzzPolicy, FuzzProbeDecision
Functions: list_fuzz_target_ids(), get_fuzz_target(), iter_fuzz_targets(), fuzz_assurance_policy(), validate_time_box_seconds(), dry_run_fuzz_target(), corpus_governance_policy(), crash_pipeline_policy(), map_fuzz_public_surfaces(), build_fuzz_assurance_registry(), assert_fuzz_assurance_integrity()
scpn_quantum_control.program_ad_interpolation_primitives¶
Static interpolation derivative rules for Program AD.
Source · Public symbols: 1
Functions: program_ad_interpolation_interp_derivative_rule()
scpn_quantum_control.program_ad_linalg_primitives¶
Static linear-algebra derivative rules and registry contracts for Program AD.
Source · Public symbols: 14
Classes: ProgramADLinalgConditioningDiagnostic
Functions: diagnose_program_ad_linalg_conditioning(), program_ad_linalg_solve_derivative_rule(), program_ad_linalg_matrix_power_derivative_rule(), program_ad_linalg_multi_dot_derivative_rule(), program_ad_linalg_trace_derivative_rule(), program_ad_linalg_diag_derivative_rule(), program_ad_linalg_diagflat_derivative_rule(), program_ad_linalg_eig_derivative_rule(), program_ad_linalg_eigvals_derivative_rule(), program_ad_linalg_eigh_derivative_rule(), program_ad_linalg_eigvalsh_derivative_rule(), program_ad_linalg_svdvals_derivative_rule(), program_ad_linalg_pinv_derivative_rule()
scpn_quantum_control.program_ad_product_primitives¶
Program AD product/contraction derivative factories and registry contracts.
Source · Public symbols: 5
Functions: program_ad_product_matmul_derivative_rule(), program_ad_product_tensordot_derivative_rule(), program_ad_product_inner_derivative_rule(), program_ad_product_outer_derivative_rule(), program_ad_product_einsum_derivative_rule()
scpn_quantum_control.program_ad_reduction_primitives¶
Program AD reduction primitive contracts and direct derivative factories.
Source · Public symbols: 10
Functions: program_ad_reduction_sum_derivative_rule(), program_ad_reduction_mean_derivative_rule(), program_ad_reduction_var_derivative_rule(), program_ad_reduction_std_derivative_rule(), program_ad_reduction_max_derivative_rule(), program_ad_reduction_min_derivative_rule(), program_ad_reduction_median_derivative_rule(), program_ad_reduction_quantile_derivative_rule(), program_ad_reduction_percentile_derivative_rule(), program_ad_reduction_prod_derivative_rule()
scpn_quantum_control.program_ad_registry¶
Primitive registry contracts and Program AD registry-dispatch coverage.
Source · Public symbols: 20
Classes: CustomDerivativeRule, PrimitiveIdentity, PrimitiveTransformRule, PrimitiveContract, ProgramADRegistryDispatchCoverageRow, ProgramADRegistryDispatchCoverageReport, CustomDerivativeRegistry
Functions: register_custom_derivative_rule(), register_primitive_transform_rule(), register_primitive_batching_rule(), register_primitive_lowering_rule(), primitive_shape_rule_for(), primitive_dtype_rule_for(), primitive_static_argument_rule_for(), primitive_nondifferentiable_policy_for(), primitive_effect_for(), primitive_contract_for(), primitive_complete_contract_for(), program_ad_registry_dispatch_coverage_report(), custom_derivative_rule_for()
scpn_quantum_control.program_ad_rust_bridge¶
Rust bridge wrappers for bounded Program AD effect IR replay.
Source · Public symbols: 7
Classes: ProgramADEffectIRLike, RustProgramADInterpreterResult, RustProgramADValueAndGradientResult, RustProgramADRegistryMetadataMirrorResult
Functions: interpret_program_ad_effect_ir_with_rust(), value_and_grad_program_ad_effect_ir_with_rust(), mirror_program_ad_registry_metadata_with_rust()
scpn_quantum_control.program_ad_selection_primitives¶
Program AD selection derivative factories and registry contracts.
Source · Public symbols: 2
Functions: program_ad_selection_where_derivative_rule(), program_ad_selection_clip_derivative_rule()
scpn_quantum_control.program_ad_shape_transforms¶
Static shape-transform derivative rules for Program AD registry dispatch.
Source · Public symbols: 17
Functions: program_ad_shape_reshape_derivative_rule(), program_ad_shape_ravel_derivative_rule(), program_ad_shape_transpose_derivative_rule(), program_ad_shape_expand_dims_derivative_rule(), program_ad_shape_squeeze_derivative_rule(), program_ad_shape_swapaxes_derivative_rule(), program_ad_shape_moveaxis_derivative_rule(), program_ad_shape_roll_derivative_rule(), program_ad_shape_flip_derivative_rule(), program_ad_shape_flipud_derivative_rule(), program_ad_shape_fliplr_derivative_rule(), program_ad_shape_rot90_derivative_rule(), program_ad_shape_repeat_derivative_rule(), program_ad_shape_tile_derivative_rule(), program_ad_shape_atleast_1d_derivative_rule(), program_ad_shape_atleast_2d_derivative_rule(), program_ad_shape_atleast_3d_derivative_rule()
scpn_quantum_control.program_ad_signal_primitives¶
Static convolution and correlation derivative rules for Program AD.
Source · Public symbols: 2
Functions: program_ad_signal_convolve_derivative_rule(), program_ad_signal_correlate_derivative_rule()
scpn_quantum_control.program_ad_stack_block_assembly¶
Static stack, append, concatenate, and block assembly rules for Program AD.
Source · Public symbols: 8
Functions: program_ad_assembly_concatenate_derivative_rule(), program_ad_assembly_stack_derivative_rule(), program_ad_assembly_hstack_derivative_rule(), program_ad_assembly_vstack_derivative_rule(), program_ad_assembly_column_stack_derivative_rule(), program_ad_assembly_dstack_derivative_rule(), program_ad_assembly_append_derivative_rule(), program_ad_assembly_block_derivative_rule()
scpn_quantum_control.program_ad_stencil_primitives¶
Static finite-difference stencil derivative rules for Program AD.
Source · Public symbols: 1
Functions: program_ad_stencil_gradient_derivative_rule()
scpn_quantum_control.program_ad_trapezoid_primitives¶
Static trapezoidal-integration derivative rules for Program AD.
Source · Public symbols: 1
Functions: program_ad_reduction_trapezoid_derivative_rule()
scpn_quantum_control.public_api_stability¶
Fail-closed public-vs-internal API stability catalogue (BL-97).
Source · Public symbols: 14
Classes: PublicApiSymbolRecord, PathClassification, DeprecationProbe, BreakingChangeDecision
Functions: list_public_api_symbol_ids(), get_public_api_symbol(), iter_public_api_symbols(), classify_api_path(), probe_deprecation(), validate_breaking_change(), deprecated_public(), build_public_api_stability_registry(), assert_public_api_stability_integrity(), version_compatibility_note()
scpn_quantum_control.qpu_compute¶
Public QPU compute façade and command-line entry point.
Source · Public symbols: 1
Functions: main()
scpn_quantum_control.qpu_compute_product¶
Fail-closed qpu_compute plan/runtime product surface (BL-95).
Source · Public symbols: 13
Classes: ComputePlanKind, ComputePlanRecord, ComputePlanDecision
Functions: list_plan_kind_ids(), get_plan_kind(), iter_plan_kinds(), list_supported_kernels(), list_supported_backend_policies(), construct_compute_plan(), dry_run_compute_plan(), audit_compute_plan_decision(), build_qpu_compute_product_registry(), assert_qpu_compute_product_integrity()
scpn_quantum_control.qpu_compute_runtime¶
Simulator runtime and JSON I/O for QPU compute contracts.
Source · Public symbols: 14
Functions: deterministic_counts(), make_compute_request(), execute_simulator_request(), write_compute_request(), read_compute_request(), write_compute_result(), read_compute_result(), write_node_descriptor(), read_node_descriptor(), write_stream_delta(), read_stream_delta(), write_fusion_result(), read_fusion_result(), run_simulator_from_artifact()
scpn_quantum_control.qpu_compute_types¶
Provider-neutral QPU compute request/result contracts.
Source · Public symbols: 9
Classes: QPUComputeRequest, QPUComputeResult, QPUNodeDescriptor, QPUStreamDelta, QPUFusionResult
Functions: require_non_empty(), json_sha256(), counts_sha256(), fuse_compute_results()
scpn_quantum_control.quantum_sync_challenge_oracle_product¶
Fail-closed Quantum Sync Challenge oracle product surface (BL-32).
Source · Public symbols: 17
Classes: ProblemFamilyRow, MetricCatalogueRow, BaselineCatalogueRow, PathEligibilityDecision, MaterialisedOracleProbe
Functions: list_problem_family_ids(), list_metric_ids(), list_baseline_ids(), get_problem_family(), iter_problem_families(), compute_instance_digest(), decide_challenge_path(), materialise_oracle_probe(), materialise_demo_oracle_probe(), map_quantum_sync_challenge_oracle_public_surfaces(), build_quantum_sync_challenge_oracle_product_registry(), assert_quantum_sync_challenge_oracle_product_integrity()
scpn_quantum_control.resource_budget_gate¶
Fail-closed compile & dense resource budget product surface (BL-94).
Source · Public symbols: 12
Classes: BudgetDimension, ResourceBudgetEstimate, ResourceBudgetDecision, ResourceBudgetExceededError
Functions: list_budget_dimension_ids(), get_budget_dimension(), iter_budget_dimensions(), estimate_resource_budget(), check_resource_budget(), enforce_resource_budget(), build_resource_budget_registry(), assert_resource_budget_integrity()
scpn_quantum_control.scorecard_acceptance_engine¶
Fail-closed baseline-scorecard acceptance / promotion engine (BL-56).
Source · Public symbols: 8
Classes: ScorecardCategoryRecord, PromoteDecision
Functions: list_scorecard_category_ids(), get_scorecard_category(), iter_scorecard_categories(), build_scorecard_acceptance_registry(), promote_scorecard_category(), assert_scorecard_acceptance_integrity()
scpn_quantum_control.ssgf_geometry_gradient_product¶
Governed SSGF quantum-in-the-loop geometry-gradient product.
Source · Public symbols: 15
Classes: SsgfPublicSurfaceRow, GradientRouteDecision, QuantumCostCertificate, GeometryGradientCertificate, SsgfGeometryObserverRecord, OuterCycleEvidence
Functions: list_ssgf_public_surfaces(), ssgf_gradient_unsuitable_scenarios(), decide_ssgf_gradient_route(), certify_quantum_cost(), certify_geometry_gradient(), geometry_observer_from_certificate(), materialise_outer_cycle_evidence(), build_ssgf_geometry_gradient_registry(), assert_ssgf_geometry_gradient_integrity()
scpn_quantum_control.stable_core¶
Stable first-path contracts for SCPN quantum-control workflows.
Source · Public symbols: 21
Classes: Problem, Backend, Experiment, Result
Functions: build_problem(), build_backend(), classical_reference_backend(), hardware_replay_backend(), qiskit_backend(), qutip_backend(), pennylane_backend(), pulser_surrogate_backend(), backend_capability_matrix(), stable_core_capability_payload(), normalised_stable_core_json(), stable_core_capability_markdown(), write_stable_core_capability_artifacts(), build_experiment(), build_result(), problem_from_kuramoto(), problem_to_kuramoto()
scpn_quantum_control.stable_core_preflight¶
Backend preflight checks for stable core experiments.
Source · Public symbols: 6
Classes: StableCorePreflightResult
Functions: run_stable_core_preflight(), stable_core_backend_dependencies(), stable_core_preflight_fixtures_payload(), stable_core_preflight_fixtures_json(), stable_core_preflight_fixtures_markdown()
scpn_quantum_control.stable_core_product¶
Fail-closed stable_core experiment model product surface (BL-81).
Source · Public symbols: 29
Classes: StableCoreContractRow, StableCoreRoundTripResult
Functions: list_stable_core_contract_ids(), get_stable_core_contract(), iter_stable_core_contracts(), schema_version_policy(), validate_model_schema_version(), problem_from_dict(), backend_from_dict(), experiment_from_dict(), result_from_dict(), wrap_model_envelope(), unwrap_model_envelope(), canonical_json_bytes(), digest_stable_core_payload(), serialise_problem(), serialise_backend(), serialise_experiment(), serialise_result(), deserialise_problem(), deserialise_backend(), deserialise_experiment(), deserialise_result(), round_trip_problem(), round_trip_experiment(), build_demo_experiment(), map_stable_core_public_surfaces(), build_stable_core_product_registry(), assert_stable_core_product_integrity()
scpn_quantum_control.stochastic_estimators_product¶
Fail-closed stochastic estimators & policies product surface (BL-93).
Source · Public symbols: 12
Classes: StochasticEstimatorRow, EstimatorDryRunDecision, MaterialisedSPSAProbe
Functions: list_stochastic_estimator_ids(), get_stochastic_estimator(), iter_stochastic_estimators(), build_product_failure_policy(), dry_run_stochastic_estimator(), materialise_demo_spsa_probe(), map_stochastic_estimators_public_surfaces(), build_stochastic_estimators_product_registry(), assert_stochastic_estimators_product_integrity()
scpn_quantum_control.structured_log_fallback¶
Structured logging with a stdlib fallback that tolerates event kwargs.
Source · Public symbols: 2
Classes: KwargTolerantLoggerAdapter
Functions: get_structured_logger()
scpn_quantum_control.studio_executive_product¶
Fail-closed Studio executive + coverage frontier product surface (BL-62).
Source · Public symbols: 12
Classes: ExecutiveVerbRow, PathEligibilityDecision, MaterialisedCoverageFrontierProbe
Functions: list_executive_verb_ids(), get_executive_verb(), iter_executive_verbs(), decide_executive_path(), compute_coverage_frontier_score(), materialise_demo_coverage_frontier_probe(), map_studio_executive_public_surfaces(), build_studio_executive_product_registry(), assert_studio_executive_product_integrity()
scpn_quantum_control.thermo_readiness_product¶
Fail-closed thermodynamics readiness product surface (BL-100).
Source · Public symbols: 19
Classes: ReadinessCapabilityRow, FepInventoryRow, PathEligibilityDecision, MaterialisedKSweepProbe
Functions: verify_ambient_claim_boundary(), list_readiness_capability_ids(), list_fep_module_ids(), get_readiness_capability(), get_fep_inventory_row(), iter_readiness_capabilities(), iter_fep_inventory(), decide_readiness_path(), materialise_k_sweep_probe(), materialise_demo_k_sweep_probe(), materialise_quantum_thermo_payload_probe(), map_thermo_readiness_public_surfaces(), build_thermo_readiness_product_registry(), assert_thermo_readiness_product_integrity(), compute_k_sweep_request_digest()
scpn_quantum_control.unsuitable_scenario_registry¶
Versioned unsuitable-scenario and anti-silent-wrong-gradient registry.
Source · Public symbols: 8
Classes: UnsuitableScenarioRecord, ScenarioProbeResult
Functions: list_unsuitable_scenario_ids(), get_unsuitable_scenario(), iter_unsuitable_scenarios(), build_unsuitable_scenario_registry(), probe_unsuitable_scenario(), assert_unsuitable_registry_integrity()
scpn_quantum_control.visualisation_dashboard_product¶
Fail-closed fixture-driven visualisation dashboard product (BL-34).
Source · Public symbols: 13
Classes: VisualisationPanelRow, PathEligibilityDecision, SecretsScanResult, MaterialisedStaticReportProbe
Functions: list_visualisation_panel_ids(), get_visualisation_panel(), iter_visualisation_panels(), scan_export_for_secrets(), decide_visualisation_path(), materialise_demo_static_report_probe(), map_visualisation_dashboard_public_surfaces(), build_visualisation_dashboard_product_registry(), assert_visualisation_dashboard_product_integrity()
scpn_quantum_control.whole_program_ad_api¶
Public whole-program automatic differentiation entry points.
Source · Public symbols: 2
Functions: whole_program_value_and_grad(), whole_program_grad()
scpn_quantum_control.whole_program_ad_product¶
Fail-closed whole-program AD product catalogue and journey map (BL-91).
Source · Public symbols: 10
Classes: WholeProgramADJourney, WholeProgramADJourneyDecision
Functions: list_whole_program_ad_journey_ids(), get_whole_program_ad_journey(), iter_whole_program_ad_journeys(), dry_run_whole_program_ad_journey(), map_whole_program_ad_public_surfaces(), map_whole_program_ad_architecture_layers(), build_whole_program_ad_product_registry(), assert_whole_program_ad_product_integrity()
scpn_quantum_control.whole_program_ad_result¶
Whole-program automatic-differentiation result records.
Source · Public symbols: 3
Classes: WholeProgramTraceEvent, WholeProgramIRNode, WholeProgramADResult
scpn_quantum_control.whole_program_frontend¶
Static bytecode/source inspection pipeline for whole-program Program AD.
Source · Public symbols: 1
Functions: compile_whole_program_frontend()
scpn_quantum_control.whole_program_frontend_contracts¶
Immutable IR and report contracts for static whole-program frontend inspection.
Source · Public symbols: 9
Classes: WholeProgramBytecodeInstruction, WholeProgramSourceIRFeature, WholeProgramBytecodeBasicBlock, WholeProgramSourceRegion, WholeProgramSourceBytecodeLineMap, WholeProgramSymbolScopeEntry, WholeProgramUnsupportedSemanticDiagnostic, WholeProgramSemanticsReport, WholeProgramCompilerFrontendReport
scpn_quantum_control.whole_program_trace_metadata¶
Static normalisation of whole-program AD trace operation shapes and axes.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.whole_program_trace_predicates¶
Derivative-safe primal control-flow predicates for whole-program AD.
Source · Public symbols: 1
Classes: TraceADPredicateArray
scpn_quantum_control.whole_program_trace_runtime¶
Runtime trace-context builders for whole-program automatic differentiation.
Source · Public symbols: 0
No public module-level class or function is declared.
scpn_quantum_control.whole_program_trace_values¶
Operator-intercepted forward-AD trace value classes and their operations.
Source · Public symbols: 2
Classes: TraceADScalar, TraceADArray
scpn_quantum_control.wirtinger_calculus¶
Wirtinger calculus: holomorphic and non-holomorphic complex derivatives.
Source · Public symbols: 7
Classes: WirtingerDerivative, WirtingerOptimisationResult
Functions: wirtinger_partials(), is_holomorphic(), holomorphic_gradient(), real_objective_gradient(), minimise_real_objective()
scpn_quantum_control.wirtinger_implicit_product¶
Fail-closed Wirtinger + implicit differentiation product surface (BL-64).
Source · Public symbols: 13
Classes: WirtingerImplicitSurfaceRow, MaterialisedWirtingerProbe, MaterialisedImplicitProbe, ComplexContractDecision
Functions: list_wirtinger_implicit_surface_ids(), get_wirtinger_implicit_surface(), iter_wirtinger_implicit_surfaces(), decide_complex_objective_contract(), materialise_demo_wirtinger_probe(), materialise_demo_implicit_stationary_probe(), map_wirtinger_implicit_public_surfaces(), build_wirtinger_implicit_product_registry(), assert_wirtinger_implicit_product_integrity()
topology_control¶
scpn_quantum_control.topology_control.artefacts¶
Serialisation and digest artefacts for topological optimisation traces.
Source · Public symbols: 2
Classes: TopologyOptimisationArtifact
Functions: export_topology_optimisation_artifact()
scpn_quantum_control.topology_control.complexes¶
Persistent-H1 complex builders and backend abstractions for topology control.
Source · Public symbols: 9
Classes: PersistenceDiagram, H1Summary, PersistentHomologyBackend, NetworkCycleBackend, RipserPHBackend
Functions: max_h1_for_vertices(), build_coupling_distance_matrix(), build_correlation_distance_matrix(), spike_trace_correlation_distance()
scpn_quantum_control.topology_control.constraints¶
Constraint ledgers and projection routines for coupling graph control.
Source · Public symbols: 6
Classes: CouplingGraphBounds, HardwareEmbeddingConstraint, ConstraintViolation, TopologyConstraintLedger
Functions: canonical_edge(), algebraic_connectivity()
scpn_quantum_control.topology_control.hardware_integration¶
No-QPU hardware manifest gate for topology-control experiments.
Source · Public symbols: 2
Classes: TopologyHardwareManifest
Functions: validate_topology_hardware_manifest()
scpn_quantum_control.topology_control.objectives¶
Degeneracy-safe persistent-H1 objectives for coupling graph control.
Source · Public symbols: 5
Classes: DegeneracyMode, ObjectiveBreakdown, CouplingTopologyObjective
Functions: classify_degeneracy(), objective_sha256_payload()
scpn_quantum_control.topology_control.optimizers¶
Projected optimisers for non-smooth persistent-H1 objectives.
Source · Public symbols: 4
Classes: TopologyOptimisationStep, TopologyOptimisationTrace, ProjectedSPSAOptimizer, ProjectedScipyOptimizer
scpn_quantum_control.topology_control.qsnn_integration¶
QSNN dynamic-coupling policy hooks for persistent-H1 control.
Source · Public symbols: 1
Classes: TopologicalDynamicCouplingPolicy
topology_kernel_product¶
scpn_quantum_control.topology_kernel_product.classifier¶
Custody-checked binary kernel ridge fitting and evaluation.
Source · Public symbols: 4
Classes: KernelRidgeClassifier
Functions: fit_kernel_ridge(), predict_kernel_ridge(), evaluate_kernel_ridge()
scpn_quantum_control.topology_kernel_product.evidence¶
Deterministic evidence and claim-boundary rendering for BL-88.
Source · Public symbols: 5
Classes: KernelSupportRow, TopologyKernelEvidence
Functions: build_topology_kernel_evidence(), render_topology_kernel_markdown(), write_topology_kernel_evidence()
scpn_quantum_control.topology_kernel_product.kernels¶
Validated exact-statevector and classical-control kernel construction.
Source · Public symbols: 7
Functions: validate_topology(), topology_digest(), validate_feature_matrix(), fidelity_kernel_matrix(), rbf_kernel_matrix(), permute_topology(), permute_edge_features()
scpn_quantum_control.topology_kernel_product.schema¶
Immutable contracts for the bounded BL-88 quantum-kernel product.
Source · Public symbols: 4
Classes: TopologyKernelConfig, TopologyKernelMatrix, TopologyKernelDataset, KernelEvaluation
scpn_quantum_control.topology_kernel_product.synthetic¶
Deterministic graph controls and teacher-aligned synthetic data.
Source · Public symbols: 5
Functions: ring_topology(), path_topology(), complete_topology(), zero_topology(), build_teacher_aligned_dataset()