Expand description
QAC Continuum Numerical Solvers, Frequency-Domain Helmholtz, Room Acoustics & Kramers-Kronig Dispersion.
Implements Packet N02 (acoustic_numerical_engineer) for the QAC v1 evolution contract,
delegating reusable 3D continuum solvers to [etalon_sim::acoustics_continuum] and WGSL
compute kernels to [etalon_wgsl_forge::numerical::physics::acoustic_fdtd], while providing
QAC v1 Mode 0x0000 (pressure_velocity_continuum) and Mode 0x0001
(elastic_stress_velocity_continuum) 64-byte wire record codecs and GPU buffer adapters:
fdtd_fluid: Mode0x0000(PressureVelocityRecord) + 3D staggered-grid fluid FDTD/CPML solver and WGSL compute kernel adapter.elastic_virieux: Mode0x0001(ElasticStressVelocityRecord) + 3D Virieux 6-component Cauchy stress-velocity solver, Hamilton quaternion stress rotation, normal-incidence impedance interface, and WGSL compute kernel adapter.helmholtz: 3D frequency-domain Helmholtz operator (7pt/27pt stencils), Jacobi/BiCGSTAB solvers, 3D Green’s function, and cavity eigenmode oracles.room_acoustics: Sabine, Eyring-Norris, and Millington-Sette $T_{60}$ calculators and ISO 3382-1 Schroeder backward integration ($\text{EDT}, T_{20}, T_{30}, C_{50}, C_{80}, D_{50}, T_s$).attenuation_kk: Kramers-Kronig causal attenuation-dispersion consistency for power-law media ($0 < y < 3$, including $y=1$) and multi-relaxation atmospheric/seawater profiles.
Re-exports§
pub use elastic_virieux::decode_elastic_stress_velocity_records;pub use elastic_virieux::encode_elastic_stress_velocity_records;pub use elastic_virieux::elastic_config_to_gpu_params;pub use elastic_virieux::pack_elastic_virieux_state_f32;pub use elastic_virieux::unpack_elastic_virieux_state_f32;pub use fdtd_fluid::decode_pressure_velocity_records;pub use fdtd_fluid::encode_pressure_velocity_records;pub use fdtd_fluid::fluid_config_to_gpu_params;pub use fdtd_fluid::pack_fluid_fdtd_state_f32;pub use fdtd_fluid::unpack_fluid_fdtd_state_f32;pub use poroelastic_bioheat::*;
Modules§
- attenuation_
kk - Kramers-Kronig Acoustic Attenuation-Dispersion Consistency Facade.
- elastic_
virieux - QAC Mode
0x0001(elastic_stress_velocity_continuum) Wire Adapter & 3D Virieux Elastic Facade. - fdtd_
fluid - QAC Mode
0x0000(pressure_velocity_continuum) Wire Adapter & 3D Staggered Fluid FDTD Facade. - helmholtz
- 3D Helmholtz Frequency-Domain Solver & Green’s Function Oracle Facade.
- poroelastic_
bioheat - Biot Poroelastic Dispersion, 21-Constant Anisotropic Christoffel Solver, Kouyoumjian-Pathak UTD Wedge Diffraction, ISO 532-1 (Zwicker) Sone Loudness, and AIUM/NEMA UD 3 Pennes Bioheat TI.
- room_
acoustics - Room Acoustics: Sabine / Eyring-Norris / Millington-Sette $T_{60}$ & Schroeder RIR Integration Facade.
Structs§
- Acoustic
Fluid Fdtd GpuParams - Parameters for a 3D staggered fluid FDTD leapfrog step (
ACOUSTIC_FLUID_FDTD_WGSL). - Cauchy
Stress6 - Six-component symmetric Cauchy stress tensor in canonical QAC order:
[\sigma_{xx}, \sigma_{yy}, \sigma_{zz}, \sigma_{xy}, \sigma_{yz}, \sigma_{xz}]in Pascals (tensile-positive). - Complex64
- Complex double-precision scalar
re + i * im. - Elastic
Medium - Isotropic linear elastic solid (or explicit $\mu=0$ fluid-limit) medium parameters (Schema 200).
- Elastic
Stress Velocity Record - Mode
0x0001(elastic_stress_velocity_continuum) 64-byte wire record. - Elastic
Virieux Config - Configuration for the 3D Virieux staggered-grid elastic velocity-stress solver.
- Elastic
Virieux Fdtd GpuParams - Parameters for a 3D Virieux staggered elastic velocity-stress step (
ELASTIC_VIRIEUX_FDTD_WGSL). - Elastic
Virieux State - Complete state of the 3D Virieux staggered-grid velocity-stress solver.
- Fluid
Fdtd Config - Configuration for the 3D staggered-grid fluid acoustic FDTD solver.
- Fluid
Fdtd State - Complete restartable state for the 3D staggered fluid acoustic FDTD solver.
- Fluid
Medium - Stationary homogeneous fluid medium parameters (Schema 200 subset).
- Hamilton
Quaternion Xyzw - Active local-to-parent Hamilton quaternion
[x, y, z, w](C02-C04 / CROSS-A01). - Helmholtz
Config - Configuration for the 3D Helmholtz operator $(\nabla^2 + k^2)\hat{p} = -\hat{s}$.
- Helmholtz
Solve Report - Convergence summary for an iterative 3D Helmholtz solve.
- Helmholtz
Workspace - Caller-owned workspace for zero-allocation BiCGSTAB and Jacobi Helmholtz solves.
- Multi
Relaxation Medium - Multi-relaxation + classical thermoviscous causal acoustic medium.
- Normal
Incidence Interface - Normal-incidence planar acoustic / longitudinal impedance reflection and transmission across an interface from medium 1 ($Z_1 > 0$) into medium 2 ($Z_2 \ge 0$).
- Power
LawAttenuation - Power-law causal acoustic attenuation and Kramers-Kronig dispersion model.
- Pressure
Velocity Record - Mode
0x0000(pressure_velocity_continuum) 64-byte wire record. - Relaxation
Process - Single molecular/chemical acoustic relaxation mechanism.
- RirAcoustics
Report - Complete ISO 3382-1 room impulse response (RIR) decay and clarity analysis.
- Room
Geometry - Room geometry and acoustic boundary model for $T_{60}$ calculations.
- Staggered
Fluid Offsets - Staggered component offsets in fractions of grid spacing and solver clock ticks (AQ-02).
- Surface
Patch - Surface patch with area $S_i$ ($\text{m}^2$) and random-incidence absorption coefficient $\alpha_i$.
- Tensor
Strain6 - Six-component symmetric small-strain tensor in canonical QAC order:
[\varepsilon_{xx}, \varepsilon_{yy}, \varepsilon_{zz}, \varepsilon_{xy}, \varepsilon_{yz}, \varepsilon_{xz}].
Enums§
- Acoustic
Fluid GpuBoundary - Boundary mode for GPU/CPU
f32staggered fluid FDTD stepping. - Elastic
Boundary Condition - Boundary condition for the 3D Virieux staggered-grid elastic solver.
- Elastic
Virieux GpuBoundary - Boundary mode for GPU/CPU
f32Virieux elastic velocity-stress stepping. - Fluid
Boundary Condition - Boundary condition kind for the 3D fluid FDTD solver.
- Helmholtz
Boundary - Boundary condition for the 3D Helmholtz grid.
- Helmholtz
Stencil - Finite-difference stencil choice for the 3D Helmholtz operator.
- Numerical
Error - Errors raised by QAC numerical continuum and room/dispersion solvers.
Constants§
- ACOUSTIC_
FLUID_ CELL_ STRIDE - Scalars per cell in the flat 3D fluid FDTD state buffer:
[p, vx, vy, vz]. - ACOUSTIC_
FLUID_ FDTD_ ENTRY - Entry-point name of
ACOUSTIC_FLUID_FDTD_WGSL. - ACOUSTIC_
FLUID_ FDTD_ WGSL - WGSL compute kernel for 3D staggered-grid fluid acoustic pressure-velocity FDTD.
- B32_
UNIT_ ROUNDOFF - Single-precision unit roundoff constant $u_{32} = 2^{-24}$ defined by the C02
B32arithmetic budget. - ELASTIC_
STRESS_ VELOCITY_ RECORD_ STRIDE - Exact record stride in bytes for Mode
0x0001. - ELASTIC_
VIRIEUX_ CELL_ STRIDE - Scalars per cell in the flat 3D elastic Virieux state buffer:
[vx, vy, vz, sxx, syy, szz, sxy, syz, sxz]. - ELASTIC_
VIRIEUX_ FDTD_ ENTRY - Entry-point name of
ELASTIC_VIRIEUX_FDTD_WGSL. - ELASTIC_
VIRIEUX_ FDTD_ WGSL - WGSL compute kernel for 3D Virieux staggered-grid elastic velocity-stress FDTD.
- ESV_
DEFINED_ VALIDITY_ MASK - Mask of all defined validity bits in Mode
0x0001. - ESV_
VALID_ DISPLACEMENT - Validity bit for particle displacement
displacement_m. - ESV_
VALID_ STRESS - Validity bit for 6-component Cauchy stress
stress_xx_yy_zz_xy_yz_xz_pa. - ESV_
VALID_ VELOCITY - Validity bit for particle velocity
velocity_m_s. - MODE_
ELASTIC_ STRESS_ VELOCITY_ CONTINUUM - Canonical QAC mode identifier for
elastic_stress_velocity_continuum. - MODE_
PRESSURE_ VELOCITY_ CONTINUUM - Canonical QAC mode identifier for
pressure_velocity_continuum. - PRESSURE_
VELOCITY_ RECORD_ STRIDE - Exact record stride in bytes for Mode
0x0000. - PV_
DEFINED_ VALIDITY_ MASK - Mask of all defined validity bits in Mode
0x0000. - PV_
VALID_ ENERGY_ DENSITY - Validity bit for collocated energy density
energy_density_j_m3. - PV_
VALID_ INTENSITY - Validity bit for collocated acoustic intensity
intensity_w_m2. - PV_
VALID_ POSITION - Validity bit flags for
PressureVelocityRecord. - PV_
VALID_ PRESSURE - Validity bit for acoustic pressure perturbation
pressure_pa. - PV_
VALID_ VELOCITY - Validity bit for particle velocity vector
particle_velocity_m_s. - RT60_
NUMERATOR_ 55_ 25 - Canonical numerator constant $55.25 = \frac{60 \times 4}{\ln(10)^{-1}} \approx 24\ln(10)$ used in the Sabine/Eyring/Millington formulas.
- RT60_
NUMERATOR_ EXACT_ 24LN10 - Exact theoretical numerator $24\ln(10) \approx 55.2620422318571$.
Functions§
- acoustic_
fluid_ fdtd_ step_ cpu - CPU reference stepper for one full 3D staggered fluid FDTD leapfrog step (
ACOUSTIC_FLUID_CELL_STRIDE = 4). - acoustic_
fluid_ fdtd_ step_ gpu - Convenience GPU wrapper that allocates a
WgpuComputeContextand runsacoustic_fluid_fdtd_step_with_context. - acoustic_
fluid_ fdtd_ step_ with_ context - Dispatch one full 3D staggered fluid FDTD leapfrog step using a caller-supplied
WgpuComputeContext. - analyze_
room_ impulse_ response - Perform full ISO 3382-1 analysis on a discrete room impulse response $h[n]$ sampled at
sample_rate_hz. - apply_
helmholtz_ operator - Apply the 3D discrete Helmholtz operator $A\hat{p} = (\nabla_h^2 + k^2)\hat{p}$ into
out. - assert_
b32_ scalar_ budget - Assert that
actualagrees withy_refwithin the C02B32budget at characteristic scalescale_s. - b32_
scalar_ tolerance - Compute the C02
B32scalar absolute error tolerance for a reference valuey_refat characteristic physical scalescale_s: $$\text{tol}(y_{\text{ref}}, S) = 8 u_{32} S + 2\times 10^{-6} |y_{\text{ref}}|, \qquad u_{32} = 2^{-24}$$ - collocate_
fluid_ cell - Interpolate staggered velocities in space and time to cell center
(ix, iy, iz)at step $n$. - elastic_
virieux_ fdtd_ step_ cpu - CPU reference stepper for one full 3D Virieux staggered elastic velocity-stress step (
ELASTIC_VIRIEUX_CELL_STRIDE = 9). - elastic_
virieux_ fdtd_ step_ gpu - Convenience GPU wrapper that allocates a
WgpuComputeContextand runselastic_virieux_fdtd_step_with_context. - elastic_
virieux_ fdtd_ step_ with_ context - Dispatch one full 3D Virieux staggered elastic velocity-stress step using a caller-supplied
WgpuComputeContext. - evaluate_
direct_ energy_ and_ intensity - Evaluate collocated energy density and intensity only when the offsets are collocated; rejects direct multiplication of staggered fields without interpolation (C02 Mode 00).
- fit_
decay_ rt60_ s - Fit linear least-squares decay slope on
edc_dbbetweenstart_db(e.g.-5.0) andend_db(e.g.-35.0) and return the extrapolated $-60\text{ dB}$ decay time $T_{60}$ in seconds. - helmholtz_
greens_ function_ 3d - Analytical 3D free-space outgoing Green’s function $$G(r) = \frac{e^{i k r}}{4\pi r}, \qquad r = |\mathbf{x} - \mathbf{x}_0|_2 > 0$$ Rejects $r \le 0$ singularity per C02.
- rectangular_
cavity_ eigenfrequency_ hz - Analytical eigenfrequency $f_{n_x,n_y,n_z}$ (in Hz) of a 3D rectangular acoustic cavity with side lengths $(L_x, L_y, L_z)$, sound speed $c$, and mode indices $(n_x, n_y, n_z)$: $$f_{n_x,n_y,n_z} = \frac{c}{2}\sqrt{\left(\frac{n_x}{L_x}\right)^2 + \left(\frac{n_y}{L_y}\right)^2 + \left(\frac{n_z}{L_z}\right)^2}$$
- rectangular_
cavity_ eigenmode_ value - Evaluate the analytical standing-wave eigenmode shape in a 3D rectangular cavity at
pos_m: - schroeder_
backward_ integration_ db - Compute the normalized Schroeder backward energy integration curve in dB: $$E(k) = \sum_{n=k}^{N-1} h[n]^2, \qquad L_{\text{EDC}}(k) = 10\log_{10}!\left(\frac{E(k)}{E(0)}\right)$$ Rejects empty, non-finite, or all-zero silent impulse responses (C02-C01 / AQ-04).
- solve_
helmholtz_ bicgstab - Solve $(\nabla_h^2 + k^2)\hat{p} = -\hat{s}$ (where
rhsis $-\hat{s}$) using BiCGSTAB over caller-ownedworkspacewith zero heap allocations inside the loop. - step_
elastic_ virieux_ in_ place - Advance the 3D Virieux staggered-grid elastic state by one full leapfrog step $\Delta t$ with zero heap allocations on the hot path.
- step_
fluid_ fdtd_ in_ place - Advance the 3D staggered-grid fluid FDTD state by one full leapfrog step $\Delta t$ with zero heap allocations on the hot path.
- step_
helmholtz_ jacobi - Damped Jacobi relaxation step for the 3D Helmholtz operator over caller-owned workspace.