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),
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,
and rotated with the Bond matrix \(\mathbf{M}(R)\) of the rotation
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 ¶
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=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_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'/ 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.
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.