Module elastic_virieux
Expand description
3D Elastic Stress-Velocity Virieux Solver & Tensor Mechanics (QAC Mode 0x0001).
Implements the C02/C03 contract for elastic_stress_velocity_continuum and Mode 03
normal-incidence impedance interfaces:
- 64-byte wire record (
ElasticStressVelocityRecord) with all 6 independent Cauchy stress components $(\sigma_{xx},\sigma_{yy},\sigma_{zz},\sigma_{xy},\sigma_{yz},\sigma_{xz})$ (tensile-positive, $p = -\operatorname{tr}(\boldsymbol{\sigma})/3$). - Explicit distinction between tensor small strain $\varepsilon_{ij}$ and engineering Voigt shear strain $\gamma_{ij} = 2\varepsilon_{ij}$ (C02-C04).
- Isotropic Hooke’s law $\boldsymbol{\sigma} = \lambda\operatorname{tr}(\boldsymbol{\varepsilon})\mathbf{I} + 2\mu\boldsymbol{\varepsilon}$, compressional wave speed $c_P = \sqrt{(K + \tfrac{4}{3}\mu)/\rho}$, and shear wave speed $c_S = \sqrt{\mu/\rho}$.
- Active Hamilton
[x, y, z, w]quaternion rotation with C02-C04 ordered squared-norm admission (<= 1e-12), derived orthogonal rotation $\mathbf{R}$, vector map $\mathbf{R}\mathbf{v}$, and stress map $\boldsymbol{\sigma}’ = \mathbf{R}\boldsymbol{\sigma}\mathbf{R}^T$. - Free-surface vacuum boundary ($\boldsymbol{\sigma}\cdot\mathbf{n} = \mathbf{0}$), fluid-solid traction continuity, and normal-incidence impedance reflection/transmission.
- 3D Virieux staggered-grid velocity-stress leapfrog solver with Courant gate.
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 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.
Constants§
- ELASTIC_
STRESS_ VELOCITY_ RECORD_ STRIDE - Exact record stride in bytes for Mode
0x0001. - 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§
- 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.