Skip to main content

Module science_validation

Module science_validation 

Source
Expand description

First-principles science oracle validation (energy conservation, Stokes-Mueller, calibration). Independent physical invariant, passivity, conservation, uncertainty, and cross-modal registration verifiers for the EMF v4 and QAC v1 scientific evolution programme (Packet N04 — independent_science_reviewer, Gates G-SCIENCE & G-GPU).

All reference expectations in this module hierarchy are evaluated from closed-form first-principles equations in independent f64 and checked i128 rational arithmetic without delegating to candidate solver implementations.

§Submodules

  • [stokes_mueller]: Stokes physical realizability (overflow-safe scaled 3D hypot, degree of polarization, non-clamping over-polarization rejection), Jones-to-Mueller exact equivalence, and $4\times 4$ Cloude Hermitian coherency matrix positive-semidefiniteness & passivity.
  • [passivity_conservation]: C02-C09 numerical budget evaluators (f64 closed-form, $N$-term Higham $\gamma_N$ reduction, QAC B32 scalar & vector $L_2$), electromagnetic Poynting balance, 3D Cartesian Yee CFL & discrete dispersion, acoustic fluid/elastic/interface conservation, multi-port scattering matrix passivity ($|\mathbf{S}|_2 \le 1$), and grid-refinement convergence order ($p \ge 1.8$).
  • [uncertainty_ece]: C02-C05 uncertainty descriptor validation, Gaussian coverage factor $k \leftrightarrow p$ consistency via positive-term Kummer $\operatorname{erf}(k/\sqrt{2})$, one-shot affine calibration idempotence, half-open calibration windows, $3\times 3$ SPD covariance rotation $\mathbf{R}\boldsymbol{\Sigma}\mathbf{R}^T$, Mahalanobis NEES, ECE, Brier score, and Gaussian NLL.
  • [specialized_oracles]: Mode 0x0106 (EMF ionizing radiation Beer-Lambert, independent absorbed dose, $\text{keV}\to\text{J}$, XCOM dose-inference prohibition), Mode 0x0107 (EMF bioelectric dipole forward potential & singularity/reference guards), Mode 0x0106 (QAC haptic contact pressure, Hooke restoring force, role/expiry guards), Mode 0x0107 (QAC ultrasound round-trip ToF, derated Mechanical Index, monostatic Doppler, TI model guard), and C02-C08 I/Q carrier conjugation bridge.
  • [cross_modal_registration]: Ordered f64 quaternion norm admission, derived orthogonal Hamilton rotations, proper rotation determinant/orthogonality gates, exact i128 rational clock synchronization, material 0 EMF/QAC disambiguation, and .10d/.m64 anatomical AABB and surface-normal invariants.

Re-exports§

pub use cross_modal_registration::compose_hamilton_quaternions_xyzw;
pub use cross_modal_registration::evaluate_exact_sample_instant;
pub use cross_modal_registration::ordered_quaternion_norm_sq;
pub use cross_modal_registration::transform_local_to_parent;
pub use cross_modal_registration::verify_anatomical_region_registration;
pub use cross_modal_registration::verify_and_derive_quaternion_rotation;
pub use cross_modal_registration::verify_cross_modal_clock_join;
pub use cross_modal_registration::verify_material_and_anatomy_coupling;
pub use cross_modal_registration::verify_stationary_proper_rotation_matrix;
pub use cross_modal_registration::MaterialDomainFamily;
pub use cross_modal_registration::RationalClockDescriptor;
pub use cross_modal_registration::RationalSeconds;
pub use cross_modal_registration::RegistrationValidationError;
pub use cross_modal_registration::VerifiedQuaternionRotation;
pub use cross_modal_registration::FRAME_ADMISSION_TOLERANCE;
pub use passivity_conservation::evaluate_acoustic_interface_oracle;
pub use passivity_conservation::evaluate_em_mode0_instantaneous_oracle;
pub use passivity_conservation::evaluate_em_wavelength_m;
pub use passivity_conservation::evaluate_qac_elastic_mode01_oracle;
pub use passivity_conservation::evaluate_qac_fluid_mode00_oracle;
pub use passivity_conservation::gamma_n_f64;
pub use passivity_conservation::verify_acoustic_energy_conservation;
pub use passivity_conservation::verify_b32_scalar_budget;
pub use passivity_conservation::verify_b32_vector_budget;
pub use passivity_conservation::verify_f64_closed_form_budget;
pub use passivity_conservation::verify_grid_convergence_order;
pub use passivity_conservation::verify_n_term_reduction_budget;
pub use passivity_conservation::verify_poynting_conservation_balance;
pub use passivity_conservation::verify_scattering_matrix_passivity;
pub use passivity_conservation::verify_yee_cfl_and_dispersion;
pub use passivity_conservation::BudgetEvaluation;
pub use passivity_conservation::ConservationValidationError;
pub use passivity_conservation::EmMode0OracleResult;
pub use passivity_conservation::QacElasticMode01OracleResult;
pub use passivity_conservation::QacFluidMode00OracleResult;
pub use passivity_conservation::C02_AMPLITUDE_SCALES_B32;
pub use passivity_conservation::C02_AMPLITUDE_SCALES_F64;
pub use passivity_conservation::F32_UNIT_ROUNDOFF;
pub use passivity_conservation::F64_EPSILON;
pub use passivity_conservation::F64_UNIT_ROUNDOFF;
pub use passivity_conservation::VACUUM_IMPEDANCE_OHM;
pub use passivity_conservation::VACUUM_PERMEABILITY_H_PER_M;
pub use passivity_conservation::VACUUM_PERMITTIVITY_F_PER_M;
pub use specialized_oracles::convert_and_verify_iq_carrier_bridge;
pub use specialized_oracles::convert_kev_to_joules;
pub use specialized_oracles::convert_mw_per_cm2_to_w_per_m2;
pub use specialized_oracles::convert_spectral_density_hz_to_wavelength_m;
pub use specialized_oracles::evaluate_absorbed_dose_gy;
pub use specialized_oracles::evaluate_bioelectric_dipole_potential_v;
pub use specialized_oracles::evaluate_equivalent_dose_sv;
pub use specialized_oracles::evaluate_haptic_mechanical_oracle;
pub use specialized_oracles::evaluate_ionizing_beer_lambert_oracle;
pub use specialized_oracles::evaluate_qac_db_spl_oracle;
pub use specialized_oracles::evaluate_qac_modal_oscillator_oracle;
pub use specialized_oracles::evaluate_ultrasound_mode07_oracle;
pub use specialized_oracles::reconstruct_emf_negative_carrier_rf;
pub use specialized_oracles::reconstruct_qac_positive_carrier_rf;
pub use specialized_oracles::HapticMechanicalOracleResult;
pub use specialized_oracles::HapticRole;
pub use specialized_oracles::IonizingRadiationOracleResult;
pub use specialized_oracles::SpecializedOracleError;
pub use specialized_oracles::UltrasoundOracleResult;
pub use specialized_oracles::ELEMENTARY_CHARGE_J_PER_EV;
pub use stokes_mueller::apply_mueller_matrix;
pub use stokes_mueller::compute_cloude_coherency_matrix;
pub use stokes_mueller::deterministic_transverse_basis;
pub use stokes_mueller::hermitian_4x4_eigenvalues;
pub use stokes_mueller::jones_to_mueller_matrix;
pub use stokes_mueller::jones_vector_to_stokes;
pub use stokes_mueller::rotate_stokes_transverse_basis;
pub use stokes_mueller::scaled_hypot3;
pub use stokes_mueller::vacuum_or_homogeneous_propagation_delay_s;
pub use stokes_mueller::verify_jones_to_mueller_equivalence;
pub use stokes_mueller::verify_mueller_realizability;
pub use stokes_mueller::verify_stokes_realizability;
pub use stokes_mueller::Complex64;
pub use stokes_mueller::PolarimetricValidationError;
pub use stokes_mueller::VerifiedMuellerReport;
pub use stokes_mueller::VerifiedStokesState;
pub use stokes_mueller::C02_ROUNDING_FACTOR;
pub use stokes_mueller::F64_EPS;
pub use stokes_mueller::VACUUM_SPEED_OF_LIGHT_M_PER_S;
pub use uncertainty_ece::apply_or_verify_affine_calibration;
pub use uncertainty_ece::erf_f64;
pub use uncertainty_ece::evaluate_ece_and_brier;
pub use uncertainty_ece::evaluate_gaussian_nll;
pub use uncertainty_ece::gaussian_coverage_probability;
pub use uncertainty_ece::mahalanobis_nees_3d;
pub use uncertainty_ece::rotate_covariance_3x3;
pub use uncertainty_ece::verify_covariance_3x3_spd;
pub use uncertainty_ece::verify_gaussian_coverage_factor;
pub use uncertainty_ece::verify_half_open_calibration_window;
pub use uncertainty_ece::verify_uncertainty_descriptor;
pub use uncertainty_ece::CalibrationMetricsReport;
pub use uncertainty_ece::CalibrationStage;
pub use uncertainty_ece::UncertaintyDescriptor;
pub use uncertainty_ece::UncertaintyKind;
pub use uncertainty_ece::UncertaintyValidationError;

Modules§

cross_modal_registration
Cross-modal EMF v4, QAC v1, and anatomical .10d/.m64 coordinate frame, rational clock, and material/anatomy registration invariant verifiers (C02-C03, C02-C04, C02-C06).
passivity_conservation
Passivity, energy conservation, and C02-C09 numerical budget verifiers.
specialized_oracles
Specialized independent physics oracles for EMF Modes 3, 5, 6, 7 and QAC Modes 04, 05, 06, 07, plus the C02-C08 cross-domain I/Q carrier convention bridge.
stokes_mueller
Stokes vector and Mueller $4\times 4$ matrix polarimetric realizability verifiers (C02 Mode 1 & Mode 4).
uncertainty_ece
Uncertainty calibration, Gaussian coverage factor, covariance rotation, Mahalanobis NEES, and Expected Calibration Error (ECE) verifiers (C02-C03, C02-C04, C02-C05, Modes 6 & 7).

Functions§

run_all_science_validations
Execute a consolidated reference validation pass across all five N04 submodules (stokes_mueller, passivity_conservation, uncertainty_ece, specialized_oracles, and cross_modal_registration).