PyHydroGeophysX#

Open-source hydrogeophysics

PyHydroGeophysX

Connect hydrological models with geophysical measurements.

Predict survey responses from hydrological states, interpret field observations, and bring geophysical constraints back into hydrological models.

Run the Python quickstart Download Desktop Studio

View example workflows →

compare Hydrological model Petrophysics Hydrological properties Geophysical modelling Petrophysics Predicted geophysical response Measured geophysical data inversion

Start with what you have#

Choose the path that matches your data and research question.

I have a hydrological model

Start from MODFLOW, ParFlow, water content, saturation or porosity. Apply petrophysical relationships and predict ERT, seismic, EM or potential-field measurements.

Hydrology to ERT
I have geophysical observations

Quality-check field measurements, recover physical-property models, and translate the results into hydrologically meaningful quantities.

Field ERT Data QC
I have repeated or multiple surveys

Analyse change through time, introduce structural information, combine complementary methods, and assess uncertainty.

Time-Lapse Monitoring

Choose how you want to work#

The same workflows are available from a script, from a desktop interface, or through natural language.

Python

Build reproducible workflows, automate repeated analyses, and integrate PyHydroGeophysX into research code.

10-minute quickstart
Desktop Studio

Process data, inspect surveys, build meshes, run inversions and visualise results through an interactive interface.

Desktop Studio (Qt)
AI-assisted workflows

Use natural-language guidance to configure, execute and inspect the supported hydrogeophysical workflows.

Agents, Web App and Desktop

See AQUAH in action#

AQUAH is the built-in assistant. It takes a goal in plain language, configures the workflow, runs it and reports back. It runs in the desktop application and in the browser, and both demos below show a complete workflow, not a mock-up.

Desktop Studio. The assistant beside the scientific modules, with step-by-step approval or a run straight through to a report. Desktop guide
Web app. The same assistant in a browser, with nothing to install. Web app guide

Download Desktop Studio Open the web app Install with an AI agent

Windows and macOS bundles are published on GitHub Releases. The AI-agent install prompt is a text file you paste into a coding assistant to have it check the environment, install the package and verify startup; Installation covers the manual route, with its own video.

Supported methods and models#

Use each method on its own, or connect it to a hydrological, monitoring, structural or joint workflow.

ERT Seismic refraction TDEM FDEM Gravity Magnetics MT MODFLOW ParFlow

Compare the methods to see what each one needs as input and which workflows it can feed.

Open-source hydrogeophysics#

Python package · Desktop Studio · Reproducible examples · API reference

GitHub · Installation · Data and processing · API reference · Usage and downloads · Environmental Geophysics course

Citing PyHydroGeophysX#

If PyHydroGeophysX contributes to your research, please cite the software paper and any numerical engines your analysis actually ran.

View citation guide