Expand description
QAC Mode 0x0001 (elastic_stress_velocity_continuum) Wire Adapter & 3D Virieux Elastic Facade.
Re-exports the canonical 3D Virieux 6-component Cauchy stress-velocity solver, active Hamilton
quaternion stress rotation, and Mode 03 normal-incidence impedance interface from
[etalon_sim::acoustics_continuum::elastic_virieux] 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§
- 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). - 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.
- Hamilton
Quaternion Xyzw - Active local-to-parent Hamilton quaternion
[x, y, z, w](C02-C04 / CROSS-A01). - 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$).
- 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§
- 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.
Constants§
- 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.
Functions§
- decode_
elastic_ stress_ velocity_ records - Decode a contiguous byte slice of 64-byte Mode
0x0001wire records intoElasticStressVelocityRecordvalues. - elastic_
config_ to_ gpu_ params - Convert an
ElasticVirieuxConfigintoElasticVirieuxFdtdGpuParamsfor WGSL compute execution. - 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. - encode_
elastic_ stress_ velocity_ records - Encode a slice of Mode
0x0001ElasticStressVelocityRecordvalues into contiguous 64-byte wire records. - pack_
elastic_ virieux_ state_ f32 - Pack an
ElasticVirieuxStateinto the flatf32storage buffer layout ([vx, vy, vz, sxx, syy, szz, sxy, syz, sxz]per cell) consumed byELASTIC_VIRIEUX_FDTD_WGSL. - 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.
- unpack_
elastic_ virieux_ state_ f32 - Unpack a flat
f32storage buffer ([vx, vy, vz, sxx, syy, szz, sxy, syz, sxz]per cell) back into anElasticVirieuxState.