SpecSWD documentation

SpecSWD computes surface-wave dispersion, eigenfunctions, and sensitivity kernels in layered elastic, acoustic, anisotropic, and attenuating media.

The native Python interface uses NumPy arrays and CSR containers. The optional specd.torch backend uses PyTorch tensors and automatic differentiation, and runs without native extensions. Both backends share the versioned HDF5 dispersion schema with the C++ interface.

User guide

• SpecSWD
  • Native build requirements
  • Configure and build
  • Numerical types
  • Documentation
• Tutorial
  • Layered model convention
  • Love-wave VTI model
  • Rayleigh and Scholte VTI model
  • Fully anisotropic model
  • Constant-Q attenuation
  • Phase and group velocity
  • Sensitivity kernels
  • Variable-mode frequency grids
• PyTorch backend
  • Installation
  • Forward solve and automatic differentiation
  • Model parameters
  • Outputs and kernels
  • Frequency and azimuth sweeps
  • Numerical scope
  • Examples and validation
• C++ and PyTorch efficiency
  • Measurement conditions
  • Reproduce
• NumPy and HDF5 output
  • Ragged dispersion rows
  • Python API
  • Command-line output
  • File schema
  • C++ API
• Gallery
  • Two-layer attenuating Love-wave model
  • Coupled fluid/solid Scholte-wave model

API reference

• Native Python API reference
  • Solver workspace
    • SpecWorkSpace
  • CSR dispersion containers
    • ComplexCSR
    • DispersionTable
  • Complete solver output
    • RaggedComplexField
    • KernelTable
    • SolverOutput
  • Constant-Q helpers
    • constant_q_response()
    • constant_q_response_derivatives()
  • Thomson-Haskell comparison solver
    • THSolver
• PyTorch API reference
  • Solver workspace
    • SpecWorkSpace
  • Tensor dispersion tables
    • DispersionTable
  • Material helpers
    • constant_q_response()
    • isotropic_c21()