ElasticTTI¶
Governing equations¶
ElasticTTI solves the first-order velocity-stress equations of a tilted
transversely isotropic (TTI) solid in two dimensions with three displacement
components: the medium and the wavefield vary in \(x\) and \(z\) (\(z\) positive
downward) and are invariant in \(y\) (\(\partial_y = 0\)). With the particle
velocities \(v_x, v_y, v_z\) (vx, vy, vz), the stresses \(\sigma_{xx}\),
\(\sigma_{zz}\), \(\sigma_{yz}\), \(\sigma_{xz}\), \(\sigma_{xy}\) (sxx, szz,
syz, sxz, sxy) and the density \(\rho\) (rho),
in Voigt notation (\(1 = xx\), \(2 = yy\), \(3 = zz\), \(4 = yz\), \(5 = xz\), \(6 = xy\)), with the strain rates
Because \(\dot e_2 = \partial_y v_y = 0\) and \(\sigma_{yy}\) does not enter the momentum equations, \(\sigma_{yy}\) is not carried and only the 15 stiffness entries \(C_{11}, C_{13}, \ldots, C_{66}\) that multiply \(\dot e_1, \dot e_3, \ldots, \dot e_6\) are used.
Stiffness from the model parameters. The VTI stiffness is built from the
vertical velocities \(v_{p0}\) (vp0), \(v_{s0}\) (vs0), \(\rho\) and the Thomsen
parameters \(\varepsilon\), \(\delta\), \(\gamma\) (epsilon, delta, gamma):
which is Thomsen's exact definition of \(\delta\) solved for \(C_{13}\). The tensor is then rotated, \(C_{ijkl} = R_{ip} R_{jq} R_{kr} R_{ls} C^0_{pqrs}\), with
so 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 and the azimuth \(\phi\) (phi) from
the \(x\) axis toward \(y\). The azimuth is used in 2-D: for \(\phi = 0\) the
entries \(C_{14}, C_{16}, C_{34}, C_{36}, C_{45}, C_{56}\) vanish and the P-SV
fields (vx, vz, sxx, szz, sxz) decouple from the SH fields (vy,
syz, sxy); for \(\phi \neq 0\) the two systems are coupled. 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.
Discretisation¶
Space is discretised on a rotated staggered grid: all three velocities share the grid nodes and all five stresses share the cell centres, so no quantity is interpolated. The \(x\) and \(z\) derivatives are formed from the two diagonal differences,
where
\(u_{\pm\pm} = u\big(x \pm (m - \tfrac12)\Delta x,\; z \pm (m - \tfrac12)\Delta z\big)\),
\(c_m\) are the staggered-grid coefficients and \(M\) = spatial_order / 2
(default spatial_order=8). Time stepping is leapfrog: the velocities are advanced from the stresses, then the stresses
from the new velocities. The rotated stencils leave the checkerboard mode
\((-1)^{i+j}\) undamped and unpropagated; with checkerboard_smoothing=True
(default) point sources and receivers are spread over a 3 × 3 binomial stencil
whose response to that mode is zero. There is no compiled impl='c' path.
Boundary conditions¶
The absorbing boundary is a CPML (see
Absorbing boundaries); the class requires the
default pml_type="cpmlr" but uses only its \(a\) and \(b\) profiles, with one
memory variable per first derivative, \(\psi \leftarrow a\psi + b\,\partial u\)
and \(\partial u \leftarrow \partial u + \psi\). 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¶
- Saenger, E. H., N. Gold, and S. A. Shapiro, 2000, Modeling the propagation of elastic waves using a modified finite-difference grid: Wave Motion, 31(1), 77–92, doi:10.1016/s0165-2125(99)00023-2.
- Saenger, E. H., and T. Bohlen, 2004, Finite-difference modeling of viscoelastic and anisotropic wave propagation using the rotated staggered grid: Geophysics, 69(2), 583–591, doi:10.1190/1.1707078.
- Thomsen, L., 1986, Weak elastic anisotropy: Geophysics, 51(10), 1954–1966, doi:10.1190/1.1442051.
sweep.equations.ElasticTTI ¶
Bases: sweep.equations.base.FirstOrderEquation
First-order 2-D three-component elastic TTI wave equation (RSG).
Velocity-stress formulation for a fully anisotropic 2-D three-component
medium (8 stiffness parameters reduced to the 15 independent
components C11…C66 via Bond rotation from the Thomsen-style
VTI parameters). Derivatives are taken on a rotated staggered grid
(RSG: cell-corner ↔ cell-centre with diagonal stencils) so no
interpolation is required between staggered locations; CPML is the
recursive variant cpmlr (six profiles).
Reference: Bond-rotated VTI stiffness with RSG operators (Saenger / Bohlen rotated staggered grid).
Point sources and point receivers are folded through a 3x3 binomial
stencil by default to keep the RSG checkerboard null space out of both
the forward record and the adjoint — see checkerboard_smoothing.
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:'cpmlr'
Build the 2-D-3C elastic TTI equation operator (RSG variant).
Parameters:
-
spatial_order–FD accuracy order of the rotated staggered-grid (RSG) first derivative — e.g.
spatial_order=4is fourth-order accurate. Internally the half-stencil width isM = spatial_order // 2(used for loop bounds and PML padding). Must be an even integer (2, 4, 6, 8, 10, …). Higher orders reduce grid dispersion at the cost of more compute per step and a wider PML halo. This equation has no compiledimpl='c'path; useimpl='eager'(the SG variant :class:ElasticTTISGdoes have a CUDA kernel). Defaults to 8. -
device–Device for the operator's static RSG kernels. Use
'cuda'/ atorch.devicefor GPU eager runs. Defaults to'cpu'. -
backend–Array / programming backend,
'torch'or'jax'. Defaults to'torch'. -
checkerboard_smoothing–The RSG diagonal stencils have a checkerboard null space
(-1)^(i+j): it maps to zero under the diagonal differences, so the scheme neither propagates nor damps it, a single-cell source excites it and a single-cell receiver samples it back. The damage is in the waveform, not the amplitude — against the axis-aligned :class:ElasticTTISGreference on a uniform TTI medium (theta 30 deg, vz source and receiver) the trace correlation drops to cos 0.70 below the source and cos 0.51 in the weak-radiation (horizontal) direction, while the peak amplitude is only 1.15x too large. When True (default) source injection and receiver sampling are folded through a 3x3 binomial stencil, whose response to the checkerboard mode is exactly(1-2+1)^2/16 = 0; it does not move the source/receiver position, and the traces come back to cos 0.994-1.000 against the SG reference. Both ends are treated because the receiver gather's transpose is the adjoint source injection, so sampling raw would re-excite the mode on the backward pass and contaminate the gradient. Set False to recover the legacy raw point injection/sampling.
source_receiver_stencil
property
¶
3x3 binomial stencil folded into source injection / receiver
sampling by the propagator (see checkerboard_smoothing).
Returned as a plain NumPy array so both the torch and the jax front-ends can consume it without importing the other backend.
supports_free_surface
class-attribute
¶
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
¶
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.