Skip to main content

qualia_core_db/q42/science_validation/
mod.rs

1//! Independent physical invariant, passivity, conservation, uncertainty, and cross-modal
2//! registration verifiers for the EMF v4 and QAC v1 scientific evolution programme
3//! (Packet `N04` — `independent_science_reviewer`, Gates `G-SCIENCE` & `G-GPU`).
4//!
5//! All reference expectations in this module hierarchy are evaluated from closed-form
6//! first-principles equations in independent `f64` and checked `i128` rational arithmetic
7//! without delegating to candidate solver implementations.
8//!
9//! ## Submodules
10//! - [`stokes_mueller`]: Stokes physical realizability (overflow-safe scaled 3D hypot, degree of
11//!   polarization, non-clamping over-polarization rejection), Jones-to-Mueller exact equivalence,
12//!   and $4\times 4$ Cloude Hermitian coherency matrix positive-semidefiniteness & passivity.
13//! - [`passivity_conservation`]: C02-C09 numerical budget evaluators (`f64` closed-form,
14//!   $N$-term Higham $\gamma_N$ reduction, QAC `B32` scalar & vector $L_2$), electromagnetic
15//!   Poynting balance, 3D Cartesian Yee CFL & discrete dispersion, acoustic fluid/elastic/interface
16//!   conservation, multi-port scattering matrix passivity ($\|\mathbf{S}\|_2 \le 1$), and
17//!   grid-refinement convergence order ($p \ge 1.8$).
18//! - [`uncertainty_ece`]: C02-C05 uncertainty descriptor validation, Gaussian coverage factor
19//!   $k \leftrightarrow p$ consistency via positive-term Kummer $\operatorname{erf}(k/\sqrt{2})$,
20//!   one-shot affine calibration idempotence, half-open calibration windows, $3\times 3$ SPD
21//!   covariance rotation $\mathbf{R}\boldsymbol{\Sigma}\mathbf{R}^T$, Mahalanobis NEES, ECE,
22//!   Brier score, and Gaussian NLL.
23//! - [`specialized_oracles`]: Mode `0x0106` (EMF ionizing radiation Beer-Lambert, independent
24//!   absorbed dose, $\text{keV}\to\text{J}$, XCOM dose-inference prohibition), Mode `0x0107`
25//!   (EMF bioelectric dipole forward potential & singularity/reference guards), Mode `0x0106`
26//!   (QAC haptic contact pressure, Hooke restoring force, role/expiry guards), Mode `0x0107`
27//!   (QAC ultrasound round-trip ToF, derated Mechanical Index, monostatic Doppler, TI model guard),
28//!   and C02-C08 I/Q carrier conjugation bridge.
29//! - [`cross_modal_registration`]: Ordered `f64` quaternion norm admission, derived orthogonal
30//!   Hamilton rotations, proper rotation determinant/orthogonality gates, exact `i128` rational
31//!   clock synchronization, material `0` EMF/QAC disambiguation, and `.10d`/`.m64` anatomical AABB
32//!   and surface-normal invariants.
33
34pub mod cross_modal_registration;
35pub mod passivity_conservation;
36pub mod specialized_oracles;
37pub mod stokes_mueller;
38pub mod uncertainty_ece;
39
40#[cfg(test)]
41mod tests;
42
43pub use cross_modal_registration::{
44    compose_hamilton_quaternions_xyzw, evaluate_exact_sample_instant, ordered_quaternion_norm_sq,
45    transform_local_to_parent, verify_anatomical_region_registration,
46    verify_and_derive_quaternion_rotation, verify_cross_modal_clock_join,
47    verify_material_and_anatomy_coupling, verify_stationary_proper_rotation_matrix,
48    MaterialDomainFamily, RationalClockDescriptor, RationalSeconds, RegistrationValidationError,
49    VerifiedQuaternionRotation, FRAME_ADMISSION_TOLERANCE,
50};
51pub use passivity_conservation::{
52    evaluate_acoustic_interface_oracle, evaluate_em_mode0_instantaneous_oracle,
53    evaluate_em_wavelength_m, evaluate_qac_elastic_mode01_oracle,
54    evaluate_qac_fluid_mode00_oracle, gamma_n_f64, verify_acoustic_energy_conservation,
55    verify_b32_scalar_budget, verify_b32_vector_budget, verify_f64_closed_form_budget,
56    verify_grid_convergence_order, verify_n_term_reduction_budget,
57    verify_poynting_conservation_balance, verify_scattering_matrix_passivity,
58    verify_yee_cfl_and_dispersion, BudgetEvaluation, ConservationValidationError,
59    EmMode0OracleResult, QacElasticMode01OracleResult, QacFluidMode00OracleResult,
60    C02_AMPLITUDE_SCALES_B32, C02_AMPLITUDE_SCALES_F64, F32_UNIT_ROUNDOFF, F64_EPSILON,
61    F64_UNIT_ROUNDOFF, VACUUM_IMPEDANCE_OHM, VACUUM_PERMEABILITY_H_PER_M,
62    VACUUM_PERMITTIVITY_F_PER_M,
63};
64pub use specialized_oracles::{
65    convert_and_verify_iq_carrier_bridge, convert_kev_to_joules, convert_mw_per_cm2_to_w_per_m2,
66    convert_spectral_density_hz_to_wavelength_m, evaluate_absorbed_dose_gy,
67    evaluate_bioelectric_dipole_potential_v, evaluate_equivalent_dose_sv,
68    evaluate_haptic_mechanical_oracle, evaluate_ionizing_beer_lambert_oracle,
69    evaluate_qac_db_spl_oracle, evaluate_qac_modal_oscillator_oracle,
70    evaluate_ultrasound_mode07_oracle, reconstruct_emf_negative_carrier_rf,
71    reconstruct_qac_positive_carrier_rf, HapticMechanicalOracleResult, HapticRole,
72    IonizingRadiationOracleResult, SpecializedOracleError, UltrasoundOracleResult,
73    ELEMENTARY_CHARGE_J_PER_EV,
74};
75pub use stokes_mueller::{
76    apply_mueller_matrix, compute_cloude_coherency_matrix, deterministic_transverse_basis,
77    hermitian_4x4_eigenvalues, jones_to_mueller_matrix, jones_vector_to_stokes,
78    rotate_stokes_transverse_basis, scaled_hypot3, vacuum_or_homogeneous_propagation_delay_s,
79    verify_jones_to_mueller_equivalence, verify_mueller_realizability, verify_stokes_realizability,
80    Complex64, PolarimetricValidationError, VerifiedMuellerReport, VerifiedStokesState,
81    C02_ROUNDING_FACTOR, F64_EPS, VACUUM_SPEED_OF_LIGHT_M_PER_S,
82};
83pub use uncertainty_ece::{
84    apply_or_verify_affine_calibration, erf_f64, evaluate_ece_and_brier, evaluate_gaussian_nll,
85    gaussian_coverage_probability, mahalanobis_nees_3d, rotate_covariance_3x3,
86    verify_covariance_3x3_spd, verify_gaussian_coverage_factor,
87    verify_half_open_calibration_window, verify_uncertainty_descriptor, CalibrationMetricsReport,
88    CalibrationStage, UncertaintyDescriptor, UncertaintyKind, UncertaintyValidationError,
89};
90
91/// Execute a consolidated reference validation pass across all five `N04` submodules
92/// (`stokes_mueller`, `passivity_conservation`, `uncertainty_ece`, `specialized_oracles`,
93/// and `cross_modal_registration`).
94pub fn run_all_science_validations() -> Result<(), String> {
95    let stokes = jones_vector_to_stokes(Complex64::ONE, Complex64::I);
96    verify_stokes_realizability(stokes).map_err(|e| format!("{e:?}"))?;
97    let j_id = [[Complex64::ONE, Complex64::ZERO], [Complex64::ZERO, Complex64::ONE]];
98    let m_id = jones_to_mueller_matrix(&j_id);
99    verify_mueller_realizability(&m_id, true).map_err(|e| format!("{e:?}"))?;
100    verify_jones_to_mueller_equivalence(&m_id, &j_id, 1.0).map_err(|e| format!("{e:?}"))?;
101    evaluate_em_mode0_instantaneous_oracle(
102        [1.0, 0.0, 0.0],
103        [0.0, 1.0 / VACUUM_SPEED_OF_LIGHT_M_PER_S, 0.0],
104        1.0,
105        1.0,
106    )
107    .map_err(|e| format!("{e:?}"))?;
108    verify_poynting_conservation_balance(-0.5, 0.2, 0.3, 1.0).map_err(|e| format!("{e:?}"))?;
109    verify_yee_cfl_and_dispersion([1e-3; 3], 1e-12, 1.0, 1.0, [10.0, 0.0, 0.0])
110        .map_err(|e| format!("{e:?}"))?;
111    verify_gaussian_coverage_factor(2.0, 0.954_499_736_103_641_6, 1e-12)
112        .map_err(|e| format!("{e:?}"))?;
113    evaluate_ionizing_beer_lambert_oracle(1000.0, 0.01, 0.2, 100.0, false)
114        .map_err(|e| format!("{e:?}"))?;
115    evaluate_bioelectric_dipole_potential_v(
116        [0.0, 0.0, 1e-8],
117        [0.0; 3],
118        Some([0.0, 0.0, 0.1]),
119        true,
120        1.0,
121    )
122    .map_err(|e| format!("{e:?}"))?;
123    verify_and_derive_quaternion_rotation([0.0, 0.0, 0.0, 1.0]).map_err(|e| format!("{e:?}"))?;
124    Ok(())
125}