How gns-science/gsolve works
gSolve is a Python gravity-survey processing library. Its principal workflow imports meter readings and site metadata, builds a survey, applies meter and time-dependent corrections, adjusts survey loops/networks to estimate absolute gravity, then computes gravity corrections and anomalies for export and plotting. The README also documents terrain correction, residual filtering, and three adjustment algorithms. Groupings reflect these domain stages and shared tabular-data infrastructure; unsampled modules are represented only where their paths and capabilities are supported by the tree and README.
Main entry points: observations.py Survey model · sites.py Sites and ties · anomalies.py Gravity anomalies · terrain_corrections.py Terrain correction
Components 20
Survey input
- Scintrex reader
src/gsolve/scintrex.py - Observations
src/gsolve/observations.py - Sites and ties
src/gsolve/sites.py - Excel I/O
src/gsolve/core/excel_io.py
Survey processing
- Survey model
src/gsolve/observations.py - Meter calibration
src/gsolve/meter_conversion.py - Earth tide
src/gsolve/tide/earth_tide.py - Ocean loading
src/gsolve/tide/ocean_load.py - Network adjustment
src/gsolve/gsolve_algorithms.py - Survey results
src/gsolve/gsolve_outputs.py
Gravity reductions
- Gravity corrections
src/gsolve/reductions/corrections.py - Terrain correction
src/gsolve/reductions/terrain_corrections.py - DEM preparation
src/gsolve/core/xr_methods.py - Raster operations
src/gsolve/core/xr_accessor.py - Gravity anomalies
src/gsolve/reductions/anomalies.py
Results and data
- Plots and reports
src/gsolve/reports.py - Tabular data model
src/gsolve/core/data.py
Other components
- Survey analyst
- pygtide
- pyhardisp
Connections 26
- Survey analyst → Scintrex reader: imports readings
- Survey analyst → Observations: supplies survey data
- Survey analyst → Sites and ties: supplies site data
- Scintrex reader → Observations: provides readings
- Observations → Survey model: forms survey
- Sites and ties → Survey model: provides site metadata
- Survey model → Meter calibration: calibrates readings
- Survey model → Earth tide: corrects earth tide
- Survey model → Ocean loading: corrects ocean loading
- Earth tide → pygtide: uses ETERNA
- Ocean loading → pyhardisp: loads model
- Survey model → Network adjustment: adjusts network
- Network adjustment → Survey results: produces results
- Sites and ties → Gravity corrections: supplies site heights
- Survey results → Gravity anomalies: supplies absolute gravity
- Gravity corrections → Gravity anomalies: supplies reductions
- DEM preparation → Terrain correction: prepares elevation data
- Raster operations → Terrain correction: supports raster operations
- Sites and ties → Terrain correction: supplies site locations
- Terrain correction → Gravity anomalies: supplies terrain values
- Gravity anomalies → Plots and reports: provides results
- Survey results → Plots and reports: provides survey results
- Survey model → Excel I/O: reads and writes workbooks
- Sites and ties → Excel I/O: reads and writes workbooks
- Gravity anomalies → Excel I/O: exports results
- Survey model → Tabular data model: uses tabular structures