qualia_core_db/q42/material_coupling/mod.rs
1//! Physical and cryptographic material coupling across EMF v4 (`Q42EMF64`), QAC v1 (`qac\0\0\0\0\0`),
2//! and `.m64` (`Q42ConstituentLutEntry` / `M64StrataColumnRecord`) containers (Packet M01).
3//!
4//! Implements:
5//! - [`constitutive`]: Schema 133 multi-pole Debye + Lorentz + ohmic conductivity $\varepsilon(\omega)$
6//! and $\mu(\omega)$, full $3\times 3$ symmetric/Hermitian anisotropic constitutive tensors, and
7//! C02-C04 active Hamilton quaternion frame rotations (`(((x*x+y*y)+z*z)+w*w)` with `1e-12` admission).
8//! - [`dispersion`]: Numerical Kramers-Kronig passivity ($\omega\operatorname{Im}\varepsilon \ge 0$,
9//! $\omega\operatorname{Im}\mu \ge 0$), Cauchy principal-value Hilbert integral consistency checks,
10//! Brillouin dispersive stored energy density, and Mode 0 instantaneous/phasor field state evaluation.
11//! - [`acoustic_coupling`]: QAC Schema 200 fluid and isotropic/orthotropic elastic media, 6-component
12//! Cauchy stress and tensor strain (`p = -trace(sigma)/3`), planar normal/oblique fluid-fluid and
13//! fluid-solid Zoeppritz energy partitioning ($R_E + T_E = 1$), power-law attenuation dispersion,
14//! and C02-C06 EMF vs QAC material namespace separation.
15//! - [`transduction`]: Photoacoustic thermoelastic pressure generation ($p_0 = \Gamma \mu_a \Phi$)
16//! with thermal/stress confinement checks, piezoelectric electro-elastic coupling ($k^2 < 1$),
17//! Duhamel-Neumann thermo-elastic stress, coupled radar/sonar interface scattering, and C02-C08
18//! explicit EMF ($\exp(-i\omega t)$) $\leftrightarrow$ QAC ($\exp(+i\omega t)$) I/Q carrier conjugation.
19//! - [`binding`]: Schema 105 cryptographic `.m64` container & 16-KB `BankedConstituentLut` BLAKE3-256
20//! verification, Bank 1 epoch and canonical material hash checks, Schema 106 proper-rigid vs
21//! general-affine transform separation, and C02-C03 signed-`i128` rational clock `[from, until)`
22//! validity verification.
23
24pub mod acoustic_coupling;
25pub mod binding;
26pub mod constitutive;
27pub mod dispersion;
28pub mod transduction;
29
30#[cfg(test)]
31mod tests;
32#[cfg(test)]
33mod tests_binding;
34
35pub use acoustic_coupling::{
36 evaluate_fluid_solid_oblique_partition, evaluate_planar_interface_scattering,
37 resolve_emf_material_entry, resolve_qac_material_ref, AcousticCouplingError, CauchyStress6,
38 ContinuumMedium, EmfMaterialZeroPolicy, FluidSolidObliquePartition,
39 InterfaceScatteringCoefficients, MediumKind, OrthotropicElasticMedium,
40 PowerLawAcousticAttenuation, ResolvedEmfMaterial, TensorStrain6,
41};
42pub use binding::{
43 compute_blake3_256, reject_spatial_key_only_join, CoordinateTransform4x4,
44 CoordinateTransformKind, HalfOpenValidityInterval, MaterialBinding, MaterialBindingError,
45 MaterialEntryIdentity, RationalClock, RationalInstant, VerifiedBoundMaterial,
46 TRANSFORM_ORTHOGONALITY_TOLERANCE,
47};
48pub use constitutive::{
49 ActiveHamiltonRotation, AnisotropicConstitutiveTensor3x3, Complex64, ConstitutiveError,
50 ConstitutiveModel, DebyePole, LorentzPole, C_0_M_PER_S, EPSILON_0_F_PER_M, MU_0_H_PER_M,
51 QUATERNION_NORM_SQ_TOLERANCE, ROTATION_ORTHOGONALITY_BUDGET, Z_0_OHMS,
52};
53pub use dispersion::{
54 evaluate_brillouin_energy_density_j_per_m3, evaluate_isotropic_eb_state,
55 evaluate_wave_propagation, kramers_kronig_im_from_re, kramers_kronig_re_from_im,
56 verify_kramers_kronig_consistency, verify_passivity_on_grid, DispersionError,
57 EmAmplitudeConvention, EmWavePropagation, InstantaneousOrPhasorFieldState,
58 KramersKronigReport,
59};
60pub use transduction::{
61 convert_iq_carrier_convention, evaluate_radar_sonar_normal_interface,
62 evaluate_thermoelastic_stress, reconstruct_real_passband_sample, IqCarrierConvention,
63 PhotoacousticParameters, PhotoacousticResponse, PiezoelectricConstitutiveModel,
64 PiezoelectricState, RadarSonarInterfaceSummary, TransductionError,
65};