Skip to main content

qualia_core_db/audio/qac/numerical/
mod.rs

1//! QAC Continuum Numerical Solvers, Frequency-Domain Helmholtz, Room Acoustics & Kramers-Kronig Dispersion.
2//!
3//! Implements Packet **N02 (`acoustic_numerical_engineer`)** for the QAC v1 evolution contract,
4//! delegating reusable 3D continuum solvers to [`etalon_sim::acoustics_continuum`] and WGSL
5//! compute kernels to [`etalon_wgsl_forge::numerical::physics::acoustic_fdtd`], while providing
6//! QAC v1 Mode `0x0000` (`pressure_velocity_continuum`) and Mode `0x0001`
7//! (`elastic_stress_velocity_continuum`) 64-byte wire record codecs and GPU buffer adapters:
8//! - [`fdtd_fluid`]: Mode `0x0000` (`PressureVelocityRecord`) + 3D staggered-grid fluid FDTD/CPML
9//!   solver and WGSL compute kernel adapter.
10//! - [`elastic_virieux`]: Mode `0x0001` (`ElasticStressVelocityRecord`) + 3D Virieux 6-component
11//!   Cauchy stress-velocity solver, Hamilton quaternion stress rotation, normal-incidence impedance
12//!   interface, and WGSL compute kernel adapter.
13//! - [`helmholtz`]: 3D frequency-domain Helmholtz operator (7pt/27pt stencils), Jacobi/BiCGSTAB
14//!   solvers, 3D Green's function, and cavity eigenmode oracles.
15//! - [`room_acoustics`]: Sabine, Eyring-Norris, and Millington-Sette $T_{60}$ calculators and
16//!   ISO 3382-1 Schroeder backward integration ($\text{EDT}, T_{20}, T_{30}, C_{50}, C_{80}, D_{50}, T_s$).
17//! - [`attenuation_kk`]: Kramers-Kronig causal attenuation-dispersion consistency for power-law
18//!   media ($0 < y < 3$, including $y=1$) and multi-relaxation atmospheric/seawater profiles.
19
20pub mod attenuation_kk;
21pub mod elastic_virieux;
22pub mod fdtd_fluid;
23pub mod helmholtz;
24pub mod poroelastic_bioheat;
25pub mod room_acoustics;
26
27#[cfg(test)]
28mod tests;
29
30pub use attenuation_kk::{MultiRelaxationMedium, PowerLawAttenuation, RelaxationProcess};
31pub use poroelastic_bioheat::*;
32pub use elastic_virieux::{
33    decode_elastic_stress_velocity_records, encode_elastic_stress_velocity_records,
34    step_elastic_virieux_in_place, CauchyStress6, ElasticBoundaryCondition, ElasticMedium,
35    ElasticStressVelocityRecord, ElasticVirieuxConfig, ElasticVirieuxState, HamiltonQuaternionXyzw,
36    NormalIncidenceInterface, TensorStrain6, ELASTIC_STRESS_VELOCITY_RECORD_STRIDE,
37    ESV_DEFINED_VALIDITY_MASK, ESV_VALID_DISPLACEMENT, ESV_VALID_STRESS, ESV_VALID_VELOCITY,
38    MODE_ELASTIC_STRESS_VELOCITY_CONTINUUM,
39};
40#[cfg(feature = "gpu-runtime")]
41pub use elastic_virieux::{
42    elastic_config_to_gpu_params, elastic_virieux_fdtd_step_cpu, elastic_virieux_fdtd_step_gpu,
43    elastic_virieux_fdtd_step_with_context, pack_elastic_virieux_state_f32,
44    unpack_elastic_virieux_state_f32, ElasticVirieuxFdtdGpuParams, ElasticVirieuxGpuBoundary,
45    ELASTIC_VIRIEUX_CELL_STRIDE, ELASTIC_VIRIEUX_FDTD_ENTRY, ELASTIC_VIRIEUX_FDTD_WGSL,
46};
47pub use etalon_sim::acoustics_continuum::{
48    assert_b32_scalar_budget, b32_scalar_tolerance, B32_UNIT_ROUNDOFF,
49};
50pub use fdtd_fluid::{
51    collocate_fluid_cell, decode_pressure_velocity_records, encode_pressure_velocity_records,
52    evaluate_direct_energy_and_intensity, step_fluid_fdtd_in_place, FluidBoundaryCondition,
53    FluidFdtdConfig, FluidFdtdState, FluidMedium, NumericalError, PressureVelocityRecord,
54    StaggeredFluidOffsets, MODE_PRESSURE_VELOCITY_CONTINUUM, PRESSURE_VELOCITY_RECORD_STRIDE,
55    PV_DEFINED_VALIDITY_MASK, PV_VALID_ENERGY_DENSITY, PV_VALID_INTENSITY, PV_VALID_POSITION,
56    PV_VALID_PRESSURE, PV_VALID_VELOCITY,
57};
58#[cfg(feature = "gpu-runtime")]
59pub use fdtd_fluid::{
60    acoustic_fluid_fdtd_step_cpu, acoustic_fluid_fdtd_step_gpu,
61    acoustic_fluid_fdtd_step_with_context, fluid_config_to_gpu_params, pack_fluid_fdtd_state_f32,
62    unpack_fluid_fdtd_state_f32, AcousticFluidFdtdGpuParams, AcousticFluidGpuBoundary,
63    ACOUSTIC_FLUID_CELL_STRIDE, ACOUSTIC_FLUID_FDTD_ENTRY, ACOUSTIC_FLUID_FDTD_WGSL,
64};
65pub use helmholtz::{
66    apply_helmholtz_operator, helmholtz_greens_function_3d,
67    rectangular_cavity_eigenfrequency_hz, rectangular_cavity_eigenmode_value,
68    solve_helmholtz_bicgstab, step_helmholtz_jacobi, Complex64, HelmholtzBoundary,
69    HelmholtzConfig, HelmholtzSolveReport, HelmholtzStencil, HelmholtzWorkspace,
70};
71pub use room_acoustics::{
72    analyze_room_impulse_response, fit_decay_rt60_s, schroeder_backward_integration_db,
73    RirAcousticsReport, RoomGeometry, SurfacePatch, RT60_NUMERATOR_55_25,
74    RT60_NUMERATOR_EXACT_24LN10,
75};