Expand description
QAC Mode 0x0000 (pressure_velocity_continuum) Wire Adapter & 3D Staggered Fluid FDTD Facade.
Re-exports the canonical 3D staggered-grid fluid FDTD/CPML solver and Mode 0x0000 64-byte
wire record types from [etalon_sim::acoustics_continuum::fdtd_fluid] and the WGSL compute
kernels from [etalon_wgsl_forge::numerical::physics::acoustic_fdtd], adding QAC batch wire
codecs and f64 $\leftrightarrow$ f32 GPU state buffer adapters.
Structs§
- Acoustic
Fluid Fdtd GpuParams - Parameters for a 3D staggered fluid FDTD leapfrog step (
ACOUSTIC_FLUID_FDTD_WGSL). - 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).
- Pressure
Velocity Record - Mode
0x0000(pressure_velocity_continuum) 64-byte wire record. - Staggered
Fluid Offsets - Staggered component offsets in fractions of grid spacing and solver clock ticks (AQ-02).
Enums§
- Acoustic
Fluid GpuBoundary - Boundary mode for GPU/CPU
f32staggered fluid FDTD stepping. - Fluid
Boundary Condition - Boundary condition kind for the 3D fluid FDTD solver.
- 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.
- 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.
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. - collocate_
fluid_ cell - Interpolate staggered velocities in space and time to cell center
(ix, iy, iz)at step $n$. - decode_
pressure_ velocity_ records - Decode a contiguous byte slice of 64-byte Mode
0x0000wire records intoPressureVelocityRecordvalues. - encode_
pressure_ velocity_ records - Encode a slice of Mode
0x0000PressureVelocityRecordvalues into contiguous 64-byte wire records. - 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).
- fluid_
config_ to_ gpu_ params - Convert a
FluidFdtdConfigintoAcousticFluidFdtdGpuParamsfor WGSL compute execution. - pack_
fluid_ fdtd_ state_ f32 - Pack a
FluidFdtdStateinto the flatf32storage buffer layout ([p, vx, vy, vz]per cell) consumed byACOUSTIC_FLUID_FDTD_WGSL. - 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.
- unpack_
fluid_ fdtd_ state_ f32 - Unpack a flat
f32storage buffer ([p, vx, vy, vz]per cell) back into aFluidFdtdState.