PyGMT paper figures

This repository contains the Jupyter notebooks and supporting data used to generate the figures presented in the PyGMT paper:

Tian, D., Fröhlich, Y., Leong, W. J., Grund, M., Schlitzer, W., Jones, M., Uieda, L., Luis, J. M. F. (2026). PyGMT: Bridging Python and the Generic Mapping Tools for Geospatial Visualization and Analysis. Geochemistry, Geophysics, Geosystems, 27(7), e2026GC013105. https://doi.org/10.1029/2026GC013105

Notebooks

• Fig1_PyGMT_GMT_comparison.ipynb: Comparison of GMT CLI (Bash) and PyGMT (Python) scripts
• Fig2_PyGMT_ecosystem.ipynb: The PyGMT ecosystem
• Fig3_PyGMT_backgrounds.ipynb: Different types of geographic background basemaps of Iceland
• Fig4_PyGMT_pandas.ipynb: Seismicity along the Andaman-Sumatra-Java subduction zone
• Fig5_PyGMT_xarray.ipynb: Hemispherical views of long-wavelength Mars topography
• Fig6_PyGMT_geopandas.ipynb: Choropleth map of the population in the US
• Fig7_PyGMT_datetime.ipynb with star_history_github_*.csv: GitHub star history of GMT and the wrappers

Environment setup

These notebooks require GMT, PyGMT, and other dependencies to be installed in the same environment. The environment.yml file can be used to create a conda environment with all the required dependencies.

Create and activate the environment:

conda env create -f environment.yml
conda activate pygmt-paper-figures

Running the notebooks

Start JupyterLab inside the activated environment:

jupyter lab

Then open the notebooks and run them within the pygmt-paper-figures environment.

Notes

• Some figures download remote resources or rely on online datasets.
• Figure outputs are typically saved as PNG files from within the notebooks.

Citation

The notebooks in this repository are archived on Zenodo and can be cited as:

Tian, D., Fröhlich, Y., Grund, M., Schlitzer, W., & Leong, W. J. (2026). Reproducible materials for "PyGMT: Bridging Python and the Generic Mapping Tools for Geospatial Visualization and Analysis". Zenodo. https://doi.org/10.5281/zenodo.19412361

License

This repository is licensed under the MIT License. See the LICENSE file for details.