How ndf-poli-usp/spyro works
Spyro is a Firedrake-based seismic wave modeling and inversion library. The main workflow configures a model and mesh, injects seismic sources, propagates acoustic waves, samples receiver data, and—when running FWI—compares synthetic and observed records to optimize the velocity model. The map also retains documented mesh, PML, parallelism, and adjoint capabilities. Relationships are limited to README statements and source-index references; unsampled implementation details are not assumed.
Main entry points: wave.py Wave solver API · inversion.py FWI driver · acoustic_wave.py Acoustic propagation · model_parameters.py Model configuration
Components 20
Model setup
- Model configuration
spyro/io/model_parameters.py - Mesh generation
spyro/meshing/meshing_functions.py - Finite element spaces
spyro/domains/space.py - Material fields
spyro/io/material_properties_io.py - PML boundaries
spyro/pml/pml_nsnc.py - Hybrid absorbing layers
spyro/abc/abc_layer.py
Wave simulation
- Wave solver API
spyro/solvers/wave.py - Acoustic propagation
spyro/solvers/acoustic_wave.py - Time integration
spyro/solvers/time_integration_central_difference.py - Seismic sources
spyro/sources/Sources.py - Receiver sampling
spyro/receivers/Receivers.py - Elastic wave modeling
spyro/solvers/elastic_wave/isotropic_wave.py - Eikonal solver
spyro/solvers/eikonal/eikonal_eq.py
Inversion and analysis
- FWI driver
spyro/solvers/inversion.py - Misfit functionals
spyro/solvers/functionals.py - Adjoint propagation
spyro/solvers/backward_time_integration.py
Runtime support
- Shot and model I/O
spyro/io/basicio.py - Ensemble parallelism
spyro/mpi/spyro_mpi.py - Wave visualization
spyro/plots/general_plots.py
Other components
- Researcher
Connections 22
- Researcher → Model configuration: configures
- Model configuration → Mesh generation: sets parameters
spyro/io/model_parameters.py - Wave solver API → Finite element spaces: uses spaces
spyro/solvers/wave.py - Wave solver API → Material fields: loads fields
spyro/solvers/wave.py - Wave solver API → Seismic sources: uses sources
spyro/solvers/wave.py - Wave solver API → Receiver sampling: samples receivers
spyro/solvers/wave.py - Wave solver API → Time integration: propagates with
spyro/solvers/wave.py - Acoustic propagation → Wave solver API: extends API
spyro/solvers/acoustic_wave.py - Acoustic propagation → Ensemble parallelism: uses ensembles
spyro/solvers/acoustic_wave.py - Seismic sources → Receiver sampling: uses projector
spyro/sources/Sources.py - FWI driver → Acoustic propagation: constructs solver
spyro/solvers/inversion.py - FWI driver → Wave solver API: sets mesh
spyro/solvers/inversion.py - FWI driver → Misfit functionals: evaluates objective
spyro/solvers/inversion.py - FWI driver → Adjoint propagation: computes gradient
- FWI driver → Wave visualization: visualizes results
spyro/solvers/inversion.py - Wave solver API → PML boundaries: supports boundaries
spyro/solvers/wave.py - Wave solver API → Hybrid absorbing layers: supports boundaries
- Mesh generation → Hybrid absorbing layers: builds layer mesh
- Shot and model I/O → Ensemble parallelism: uses ensemble I/O
spyro/io/basicio.py - Wave solver API → Shot and model I/O: uses I/O helpers
spyro/solvers/wave.py - Researcher → Elastic wave modeling: models elastic waves
- Researcher → Eikonal solver: solves travel times