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,
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 ¶
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=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, …). Performance note (impl='c'on CUDA): the compiled kernels ship template specialisations only forspatial_order ∈ {2, 4, 6, 8}. Above 8 the dispatcher drops to a generic runtime path (order = -1insrc/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'/ atorch.devicefor 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 wantimpl='c', leave this on'torch'. Defaults to'torch'.
C_HAS_RECURSIVE_CKPT
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.
C_NAME
class-attribute
¶
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
¶
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.