Skip to main content

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};