Skip to main content

Module elastic_virieux

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§

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.
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.

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.