Skip to content

Notebooks

These Python notebooks run in Google Colab with no local installation. Click a Open in Colab badge to launch, then run the cells top to bottom. Each notebook mirrors an interactive activity on the site and lets you take the analysis further with real code.

Getting started with Colab

A free Google account is all you need. Colab gives you a Python environment in the browser. Lightweight notebooks use the libraries already available in Colab; the ERT notebook detects Colab and installs pygimli automatically when needed.

Available Notebooks

Notebook Topic Launch
gravity_drift_correction.ipynb Build a drift curve and correct a gravity loop Open In Colab
gravity_forward_model.ipynb Forward-model the anomaly of a buried sphere Open In Colab
seismic_refraction.ipynb Pick first breaks and invert a two-layer model Open In Colab
ert_forward_model.ipynb Forward-model an ERT pseudosection with pyGIMLi Open In Colab
ashton_field_data.ipynb Quality-control real Ashton Prairie ERT, EM, elevation, and seismic data with PyHydroGeophysX Open In Colab

More notebooks are on the way

Additional exercises for magnetics, EM, GPR, MT, and borehole logs are being added. The badges above will go live as each notebook lands in the repository.

Research Code: PyHydroGeophysX

The course tools are teaching versions of a real research package. PyHydroGeophysX, developed in Dr. Chen's group, integrates hydrological model outputs (MODFLOW, ParFlow) with geophysical forward modeling and inversion across ERT, seismic, and EM methods. Its example notebooks run in Colab, and its documentation is at geohang.github.io/PyHydroGeophysX.

These examples need the geophysics dependencies

Unlike the teaching notebooks above, the PyHydroGeophysX examples install heavier libraries (pyGIMLi, SimPEG). In the first Colab cell run: 

!pip install "pyhydrogeophysx[geophysics]"

Example Method Launch
Ex_hydro_to_multigeophys Hydrology → ERT/seismic/EM Open In Colab
Ex_ERT_workflow ERT forward + inversion Open In Colab
Ex_TL_inversion Time-lapse ERT Open In Colab
Ex_SRT_inv Seismic refraction tomography Open In Colab
Ex_joint_inversion Joint ERT + seismic Open In Colab
Ex_TDEM_workflow Time-domain EM Open In Colab

To cite the package, see the References page. It also builds on pyGIMLi (Rücker et al., 2017) for mesh generation, forward modeling, and inversion.