Skip to content

ElasticTTISG

Governing equations

ElasticTTISG solves the same equations as ElasticTTI: the first-order velocity-stress system of a tilted transversely isotropic solid, invariant in \(y\), with the velocities vx, vy, vz, the stresses sxx, szz, syz, sxz, sxy and the density rho,

\[ \rho\, \partial_t v_x = \partial_x \sigma_{xx} + \partial_z \sigma_{xz}, \qquad \rho\, \partial_t v_y = \partial_x \sigma_{xy} + \partial_z \sigma_{yz}, \qquad \rho\, \partial_t v_z = \partial_x \sigma_{xz} + \partial_z \sigma_{zz}, \]
\[ \partial_t \sigma_I = C_{I1}\, \dot e_1 + C_{I3}\, \dot e_3 + C_{I4}\, \dot e_4 + C_{I5}\, \dot e_5 + C_{I6}\, \dot e_6, \qquad I \in \{1, 3, 4, 5, 6\}, \]

with \(\dot e_1 = \partial_x v_x\), \(\dot e_3 = \partial_z v_z\), \(\dot e_4 = \partial_z v_y\), \(\dot e_5 = \partial_z v_x + \partial_x v_z\) and \(\dot e_6 = \partial_x v_y\). The eight models vp0, vs0, rho, epsilon, delta, gamma, theta, phi are mapped to the 15 stiffness entries exactly as in ElasticTTI (Thomsen VTI stiffness, then the rotation by tilt \(\theta\) from \(z\) and azimuth \(\phi\) from \(x\) toward \(y\); phi couples the P-SV and SH fields in 2-D).

Discretisation

Derivatives are standard staggered-grid differences of order spatial_order (default 8) along \(x\) and \(z\). Relative to the node \((i, j)\) of sxx and szz, the fields sit at

Field Position
sxx, szz, vy \((i, j)\)
vx, sxy \((i + \tfrac12, j)\)
vz, syz \((i, j + \tfrac12)\)
sxz \((i + \tfrac12, j + \tfrac12)\)

Each strain rate is computed where its staggered derivative falls: \(\dot e_1\) and \(\dot e_3\) at \((i, j)\), \(\dot e_6\) at \((i + \tfrac12, j)\), \(\dot e_4\) at \((i, j + \tfrac12)\) and \(\dot e_5\) at \((i + \tfrac12, j + \tfrac12)\). The stress update uses every strain rate at that location without interpolation, so a coupling \(C_{IJ}\dot e_J\) whose strain rate lives at another node than \(\sigma_I\) is applied with a half-cell (or diagonal half-cell) offset. For an untilted medium (\(\theta = 0\)) all non-zero couplings are co-located and the scheme is the standard staggered grid; the offsets enter only through the tilt-induced entries. The density and stiffness arrays are likewise read at the array index of each velocity or stress, without averaging. Time stepping is leapfrog (velocities, then stresses). Point sources and receivers are not smoothed, since the axis-aligned stencils have no checkerboard null space.

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

ElasticTTISG(spatial_order=8, device='cpu', backend='torch')

Bases: sweep.equations.elastic_tti.ElasticTTI

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

Same physics as :class:ElasticTTI (Bond-rotated TTI stiffness, 8 raw model parameters) but with derivatives taken on an axis-aligned standard staggered grid (forward / backward FD pairs along x and z). Mixed-location stiffness couplings are used directly without interpolation — this is a clean no-interpolation SG reference companion to the RSG implementation. CPML follows the staggered-grid cpmls convention (8 profiles).

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 x; default receiver.
  • vy (aliases: velocity_y): Particle velocity in y.
  • vz (aliases: velocity_z): Particle velocity in z; default receiver.
  • sxx (aliases: stress_xx): Normal stress xx; default source.
  • szz (aliases: stress_zz): Normal stress zz; default source.
  • syz (aliases: stress_yz): Shear stress yz.
  • sxz (aliases: stress_xz): Shear stress xz.
  • sxy (aliases: stress_xy): Shear stress xy.
  • m_vxx: CPML memory for dvx/dx (internal).
  • m_vxz: CPML memory for dvx/dz (internal).
  • m_vyx: CPML memory for dvy/dx (internal).
  • m_vyz: CPML memory for dvy/dz (internal).
  • m_vzx: CPML memory for dvz/dx (internal).
  • m_vzz: CPML memory for dvz/dz (internal).
  • m_txxx: CPML memory for dsxx/dx (internal).
  • m_txzz: CPML memory for dsxz/dz (internal).
  • m_txyx: CPML memory for dsxy/dx (internal).
  • m_tyzz: CPML memory for dsyz/dz (internal).
  • m_txzx: CPML memory for dsxz/dx (internal).
  • m_tzzz: CPML memory for dszz/dz (internal).

Defaults

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

Build the 2-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_sg2d/forward.cu) which uses more registers and runs noticeably slower. The PyTorch eager path is unaffected. Defaults to 8.

  • 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_sg2d'

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.

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.