Skip to content

ElasticTTISG3D

Governing equations

ElasticTTISG3D solves the three-dimensional first-order velocity-stress equations of a tilted transversely isotropic solid. With the particle velocities \(v_i\) (vx, vy, vz), the stresses \(\sigma_{ij}\) (sxx, syy, szz, sxy, sxz, syz) and the density \(\rho\) (rho),

\[ \rho \frac{\partial v_i}{\partial t} = \sum_j \frac{\partial \sigma_{ij}}{\partial x_j}, \qquad \frac{\partial \sigma_I}{\partial t} = \sum_{J=1}^{6} C_{IJ}\, \dot e_J, \]

in Voigt notation (\(1 = xx\), \(2 = yy\), \(3 = zz\), \(4 = yz\), \(5 = xz\), \(6 = xy\)), with \(\dot e_1 = \partial_x v_x\), \(\dot e_2 = \partial_y v_y\), \(\dot e_3 = \partial_z v_z\) and the engineering shear strain rates \(\dot e_4 = \partial_z v_y + \partial_y v_z\), \(\dot e_5 = \partial_z v_x + \partial_x v_z\), \(\dot e_6 = \partial_y v_x + \partial_x v_y\). All 21 independent entries of \(C_{IJ}\) are used.

Stiffness from the model parameters. The VTI stiffness is built from vp0, vs0, rho and the Thomsen parameters epsilon, delta, gamma,

\[ C_{33}^0 = \rho v_{p0}^2, \quad C_{44}^0 = C_{55}^0 = \rho v_{s0}^2, \quad C_{11}^0 = C_{22}^0 = (1 + 2\varepsilon)\, C_{33}^0, \quad C_{66}^0 = (1 + 2\gamma)\, C_{44}^0, \quad C_{12}^0 = C_{11}^0 - 2C_{66}^0, \]
\[ C_{13}^0 = C_{23}^0 = \sqrt{\max\!\left[0,\; (C_{33}^0 - C_{44}^0)^2 + 2\delta\, C_{33}^0 (C_{33}^0 - C_{44}^0)\right]} - C_{44}^0 , \]

and rotated with the Bond matrix \(\mathbf{M}(R)\) of the rotation

\[ R = \begin{pmatrix} \cos\phi \cos\theta & -\sin\phi & \cos\phi \sin\theta \\ \sin\phi \cos\theta & \cos\phi & \sin\phi \sin\theta \\ -\sin\theta & 0 & \cos\theta \end{pmatrix}, \qquad \mathbf{C} = \mathbf{M}\, \mathbf{C}^0\, \mathbf{M}^{\mathsf T}, \]

which is the same as rotating the fourth-order tensor, \(C_{ijkl} = R_{ip} R_{jq} R_{kr} R_{ls} C^0_{pqrs}\). The symmetry axis points along \((\sin\theta \cos\phi,\ \sin\theta \sin\phi,\ \cos\theta)\): the tilt \(\theta\) (theta) is measured from the \(z\) axis (\(z\) positive downward) and the azimuth \(\phi\) (phi) from the \(x\) axis toward \(y\). Where \(|\theta| < 10^{-7}\) the unrotated VTI entries are used directly, so the gradient with respect to theta and phi is zero at those points. With \(\varepsilon = \delta = \gamma = \theta = \phi = 0\) the update is numerically identical to the isotropic Elastic3D.

Discretisation

Derivatives are standard staggered-grid differences of order spatial_order (default 4), on the Virieux grid shared with Elastic3D: relative to the node \((i, j, k)\) of the normal stresses, vx, vy, vz sit half a cell along \(x\), \(y\), \(z\), and sxy, sxz, syz at the centres of the \(xy\), \(xz\), \(yz\) cell faces. Each strain rate is computed where its staggered derivative falls (\(\dot e_1, \dot e_2, \dot e_3\) with the normal stresses, \(\dot e_4, \dot e_5, \dot e_6\) with syz, sxz, sxy), and the stress update uses all six at that location without interpolation. A coupling \(C_{IJ}\dot e_J\) whose strain rate lives at another node than \(\sigma_I\) is therefore applied with a half-cell offset along one or two axes. For an untilted medium all non-zero couplings are co-located; the offsets enter only through the tilt-induced entries. The density and stiffness arrays are read at the array index of each velocity or stress, without averaging. Time stepping is leapfrog (velocities, then stresses).

Boundary conditions

The default pml_type="cpmls" applies a CPML to every first derivative, with profiles evaluated on the integer and half-integer nodes (see Absorbing boundaries). A free surface is not implemented: free_surface=True is refused at construction, because the isotropic image method would not give a stress-free surface for an anisotropic medium.

References

  • Thomsen, L., 1986, Weak elastic anisotropy: Geophysics, 51(10), 1954–1966, doi:10.1190/1.1442051.
  • Virieux, J., 1986, P-SV wave propagation in heterogeneous media: Velocity-stress finite-difference method: Geophysics, 51(4), 889–901, doi:10.1190/1.1442147.

sweep.equations.ElasticTTISG3D

ElasticTTISG3D(spatial_order=4, device='cpu', backend='torch')

Bases: sweep.equations.base.FirstOrderEquation

First-order 3-D three-component elastic TTI wave equation (axis-aligned SG).

Velocity-stress formulation for a tilted transversely isotropic 3-D medium: the 8 raw model parameters (Thomsen-style VTI constants plus tilt theta and azimuth phi) are reduced to the full 21 independent stiffness components C11…C66 via the 3-D Bond rotation, and the six stresses couple to all six Voigt strain rates. Derivatives use the Virieux staggered grid shared with :class:~sweep.equations.elastic3d.Elastic; mixed-location stiffness couplings are used directly without interpolation, making this the 3-D companion of :class:ElasticTTISG. CPML follows the staggered-grid cpmls convention (12 profiles).

With isotropic parameters (epsilon=delta=gamma=theta=phi=0) the stiffness collapses to lambda/mu and the update is numerically identical to the isotropic 3-D elastic equation.

Models (constructor input order)

  • vp0 (m/s): VTI-frame vertical P velocity.
  • vs0 (m/s): VTI-frame vertical S velocity.
  • rho (kg/m^3): Density.
  • epsilon: Thomsen epsilon.
  • delta: Thomsen delta.
  • gamma: Thomsen gamma.
  • theta (rad): Tilt angle.
  • phi (rad): Azimuth angle.

Wavefields

  • vx (aliases: velocity_x): Particle velocity in the x direction; default receiver.
  • vy (aliases: velocity_y): Particle velocity in the y direction; default receiver.
  • vz (aliases: velocity_z): Particle velocity in the z direction; default receiver.
  • sxx (aliases: stress_xx): Normal stress in the x direction; default source.
  • syy (aliases: stress_yy): Normal stress in the y direction; default source.
  • szz (aliases: stress_zz): Normal stress in the z direction; default source.
  • sxy (aliases: stress_xy, shear_xy): Shear stress component.
  • sxz (aliases: stress_xz, shear_xz): Shear stress component.
  • syz (aliases: stress_yz, shear_yz): Shear stress component.
  • m_vxx: CPML memory variable for dvx/dx (internal).
  • m_vxy: CPML memory variable for dvx/dy (internal).
  • m_vxz: CPML memory variable for dvx/dz (internal).
  • m_vyx: CPML memory variable for dvy/dx (internal).
  • m_vyy: CPML memory variable for dvy/dy (internal).
  • m_vyz: CPML memory variable for dvy/dz (internal).
  • m_vzx: CPML memory variable for dvz/dx (internal).
  • m_vzy: CPML memory variable for dvz/dy (internal).
  • m_vzz: CPML memory variable for dvz/dz (internal).
  • m_sxxx: CPML memory variable for dsxx/dx (internal).
  • m_szzz: CPML memory variable for dszz/dz (internal).
  • m_sxyx: CPML memory variable for dsxy/dx (internal).
  • m_sxyy: CPML memory variable for dsxy/dy (internal).
  • m_sxzx: CPML memory variable for dsxz/dx (internal).
  • m_sxzz: CPML memory variable for dsxz/dz (internal).
  • m_syyy: CPML memory variable for dsyy/dy (internal).
  • m_syzy: CPML memory variable for dsyz/dy (internal).
  • m_syzz: CPML memory variable for dsyz/dz (internal).

Defaults

  • source_type: ['sxx', 'syy', 'szz']
  • receiver_type: ['vx', 'vy', 'vz']
  • pml_type: 'cpmls'

Build the 3-D-3C elastic TTI equation operator (axis-aligned SG).

Parameters:

  • spatial_order –

    FD accuracy order of the staggered first-derivative operator — e.g. spatial_order=4 is fourth-order accurate. Internally the half-stencil width is M = spatial_order // 2 (used for loop bounds and PML padding). Must be an even integer (2, 4, 6, 8, 10, …). Performance note (impl='c' on CUDA): the compiled kernels ship template specialisations only for spatial_order ∈ {2, 4, 6, 8}. Above 8 the dispatcher drops to a generic runtime path (order = -1 in src/sweep/csrc/cuda/equations/elastic_tti_sg3d/forward.cu) which uses more registers and runs noticeably slower. The PyTorch eager path is unaffected. Defaults to 4.

  • device –

    Device for the operator's static gradient kernels. Use 'cuda' / a torch.device for GPU runs so the propagator can follow without a host↔device copy. Defaults to 'cpu'.

  • backend –

    Array / programming backend, 'torch' or 'jax'. When you later want impl='c', leave this on 'torch'. Defaults to 'torch'.

C_HAS_RECURSIVE_CKPT class-attribute

C_HAS_RECURSIVE_CKPT = False

bool(x) -> bool

Returns True when the argument x is true, False otherwise. The builtins True and False are the only two instances of the class bool. The class bool is a subclass of the class int, and cannot be subclassed.

C_NAME class-attribute

C_NAME = 'elastic_tti_sg3d'

str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str

Create a new string object from the given object. If encoding or errors is specified, then the object must expose a data buffer that will be decoded using the given encoding and error handler. Otherwise, returns the result of object.str() (if defined) or repr(object). encoding defaults to sys.getdefaultencoding(). errors defaults to 'strict'.

prepare_models_for_c class-attribute

prepare_models_for_c = True

bool(x) -> bool

Returns True when the argument x is true, False otherwise. The builtins True and False are the only two instances of the class bool. The class bool is a subclass of the class int, and cannot be subclassed.

supports_free_surface class-attribute

supports_free_surface = False

bool(x) -> bool

Returns True when the argument x is true, False otherwise. The builtins True and False are the only two instances of the class bool. The class bool is a subclass of the class int, and cannot be subclassed.

takes_invariants class-attribute

takes_invariants = True

bool(x) -> bool

Returns True when the argument x is true, False otherwise. The builtins True and False are the only two instances of the class bool. The class bool is a subclass of the class int, and cannot be subclassed.