Skip to content

Credits & Citation

The algorithm is Matthew Heberger's

The delineation method at the heart of pourpoint, the approach summarized in How it works, is the work of Matthew Heberger (ORCID 0000-0001-9122-0030). He designed the method, validated it against reference watersheds, published it, and released a reference implementation as the open-source, MIT-licensed delineator tool, alongside the point-and-click Global Watersheds web application.

pourpoint is an independent Rust reimplementation of that method. The algorithm design is entirely Heberger's; what pourpoint adds is engineering reach: Heberger's delineator is built specifically around the MERIT-Hydro and MERIT-Basins datasets, while pourpoint runs the same method on any HFX-compliant hydrofabric, including GRIT, MERIT-Basins, and others. Because delineator is MIT-licensed, the license permits this reimplementation. This page credits him because correctness and courtesy require it.

A note on lineage

Heberger's own paper is candid about precedent, and so is this page. The idea of combining raster and vector methods for watershed delineation traces back to Djokic and Ye (1999); Heberger's contribution is the modern open-source, free, and global implementation that made the hybrid method fast and widely usable.

The GRIT hydrofabric

pourpoint's canonical hosted example dataset is GRIT (Global River Topology), a global river-network dataset by Wortmann et al. GRIT is a separate work from the delineation algorithm; if you delineate over the GRIT hydrofabric, cite it alongside Heberger's method:

Wortmann, M., et al. (2025). Global River Topology (GRIT). doi:10.1029/2024WR038308

How to cite Heberger's work

If the delineation algorithm matters to your work, please cite Heberger.

The paper:

Heberger, M. (2025). Fast, accurate watershed delineation with a hybrid of raster and vector methods. Manuscript submitted to Environmental Modelling & Software. SSRN preprint: https://doi.org/10.2139/ssrn.5939056 (https://ssrn.com/abstract=5939056). Author copy: preprint PDF.

The Global Watersheds web application:

Heberger, M. Global Watersheds (web application). https://mghydro.com/watersheds

BibTeX for the delineator software:

@software{delineator,
  author    = {Matthew Heberger},
  title     = {delineator: Global Watershed Delineation with Python},
  year      = {2026},
  publisher = {GitHub},
  version   = {2.1},
  url       = {https://github.com/mheberger/delineator}
}

How to cite pourpoint

pourpoint and its Python bindings are MIT-licensed and do not have their own DOI or paper. If you use them in research, cite Heberger's algorithm as above and point to the repository:

pourpoint: watershed delineation for any HFX-compliant hydrofabric. https://github.com/CooperBigFoot/pourpoint