Skip to main content

Module elastic_virieux

Module elastic_virieux 

Source
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§

CauchyStress6
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).
ElasticMedium
Isotropic linear elastic solid (or explicit $\mu=0$ fluid-limit) medium parameters (Schema 200).
ElasticStressVelocityRecord
Mode 0x0001 (elastic_stress_velocity_continuum) 64-byte wire record.
ElasticVirieuxConfig
Configuration for the 3D Virieux staggered-grid elastic velocity-stress solver.
ElasticVirieuxFdtdGpuParams
Parameters for a 3D Virieux staggered elastic velocity-stress step (ELASTIC_VIRIEUX_FDTD_WGSL).
ElasticVirieuxState
Complete state of the 3D Virieux staggered-grid velocity-stress solver.
HamiltonQuaternionXyzw
Active local-to-parent Hamilton quaternion [x, y, z, w] (C02-C04 / CROSS-A01).
NormalIncidenceInterface
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$).
TensorStrain6
Six-component symmetric small-strain tensor in canonical QAC order: [\varepsilon_{xx}, \varepsilon_{yy}, \varepsilon_{zz}, \varepsilon_{xy}, \varepsilon_{yz}, \varepsilon_{xz}].

Enums§

ElasticBoundaryCondition
Boundary condition for the 3D Virieux staggered-grid elastic solver.
ElasticVirieuxGpuBoundary
Boundary mode for GPU/CPU f32 Virieux 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 0x0001 wire records into ElasticStressVelocityRecord values.
elastic_config_to_gpu_params
Convert an ElasticVirieuxConfig into ElasticVirieuxFdtdGpuParams for 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 WgpuComputeContext and runs elastic_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 0x0001 ElasticStressVelocityRecord values into contiguous 64-byte wire records.
pack_elastic_virieux_state_f32
Pack an ElasticVirieuxState into the flat f32 storage buffer layout ([vx, vy, vz, sxx, syy, szz, sxy, syz, sxz] per cell) consumed by ELASTIC_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 f32 storage buffer ([vx, vy, vz, sxx, syy, szz, sxy, syz, sxz] per cell) back into an ElasticVirieuxState.