Student or educator? Sign up with your school email and get 6 months of Pro free.
CoChat

The DOI matches its Crossref record; 40 of the 40 references it cites were found in a registry or an index; none of the 17 sources its claims cite is checked for support yet.

rabpro: global watershed boundaries, river elevation profiles, and catchment statistics

Open access
Schwenk, Jon, Zussman, Tal, Stachelek, Jemma, Rowland, Joel C. · 2022 · Journal of Open Source Software

Abstract

River and Basin Profiler (rabpro) is a Python package to delineate watersheds, extract river flowlines and elevation profiles, and compute watershed statistics for any location on the Earth's surface.As fundamental hydrologically-relevant units of surface area, watersheds are areas of land that drain via aboveground pathways to the same location, or outlet.Delineations of watershed boundaries are typically performed on digital elevation models (DEMs) that represent surface elevations as gridded rasters.Depending on the resolution of the DEM and the size of the watershed, delineation may be very computationally expensive.With this in mind, we designed rabpro to provide user-friendly workflows to manage the complexity and computational expense of watershed calculations given an arbitrary coordinate pair.In addition to basic watershed delineation, rabpro will extract the elevation profile for a watershed's mainchannel flowline.This enables the computation of river slope, which is a critical parameter in many hydrologic and geomorphologic models.Finally, rabpro provides a user-friendly wrapper around Google Earth Engine's (GEE) Python API to enable cloud-computing of zonal watershed statistics and/or time-varying forcing data from hundreds of available datasets.Altogether, rabpro provides the ability to automate or semi-automate complex watershed analysis workflows across broad spatial extents.

Overview

CoChat Summary

TL;DR

rabpro is a Python package that delineates watershed boundaries, extracts river flowline elevation profiles, and computes zonal watershed statistics for any coordinate on Earth. It combines pixel-based delineation from MERIT-Hydro with subbasin-based delineation from HydroBASINS and wraps Google Earth Engine's Python API for cloud-computed basin statistics and forcing data.

Key findings

  • rabpro provides three primary operations: (1) basin delineation, (2) elevation profiling, and (3) subbasin (zonal) statistics, executable end-to-end from an arbitrary (latitude, longitude) coordinate pair.
  • Delineation can use MERIT-Hydro, described as a global, ~90 meter per pixel hydrologically-processed DEM suite, or HydroBASINS, described as pre-delineated subbasins at approximately ~230 km² per subbasin; the method can be optimized according to basin size.
  • A stated unique innovation is automated "hydrological addressing" of input coordinates: rabpro "snaps" a user coordinate to a nearby flowline while minimizing snapping distance and the difference in upstream drainage area (if provided).
  • The authors state that, to their knowledge, rabpro is the only available package providing efficient end-to-end delineation and characterization of watershed basins at scale.

Methods

  • Design: an open-source Python package (Journal of Open Source Software) intended for watershed-based analysis, particularly data-driven rainfall-runoff modeling, and also used for streamflow trend contextualization, riverbank erosion modeling, and mosquito population dynamics forcing data.
  • Data: MERIT-Hydro (~90 m/pixel) and HydroBASINS (~230 km² per subbasin) for delineation; Google Earth Engine datasets for zonal statistics and time-varying forcing data (e.g., population, NDVI, topo slope, precipitation, soil moisture, temperature).
  • Analysis/workflow: for a single coordinate, instantiate the profiler class and call `delineate_basins()`, `elev_profile()`, and `basin_stats()` in order; for multiple coordinates, loop over coordinate pairs, collect basin polygons into a list, concatenate, and call `basin_stats.compute()` on the resulting GeoDataFrame. Dependencies include GDAL, NumPy, GeoPandas, Shapely, pyproj, scikit-image, scipy, and earthengine-api.

Limitations

  • Stated in the paper: rabpro does not currently provide support for custom watershed datasets similar to HydroBASINS, due to attribute field and data structure requirements that must be consistent for generalizability.
  • Stated in the paper: use of the watershed statistics methods requires a free Google Earth Engine account, and MERIT-Hydro requires users to first register to receive a username and password for download access.
  • Evident from the text: the paper reports no quantitative accuracy assessment, benchmarking, or validation of delineation or statistics against reference data; performance claims (e.g., "simpler, less error-prone, and faster results") are asserted rather than measured.

Model-written summary. Check it against the paper before relying on it.

Integrity signals

Registry

Crossref · 10.21105/joss.04237

Cites

40 of 40 references verified0 citation errors · 0 not checkable

Statistics

Nothing to recompute.

Figures

Figure 1 The core functionality of rabpro demonstrated on the Sigatoka River. (A) Study site with both MERIT and HydroBASINS delineations and river flowline extraction for a hypothetical gage station. Bing VirtualEarth base image. (B) MERIT-Hydro delineation with MERIT-Hydro flowlines underneath. (C) HydroBASINS delineation with level-12 HydroBASINS polygons as white outlines. (D) Extracted elevation profile with gage location denoted by white circle at Distance = 0. (E) Examples of time-averaged (where appropriate) basin characteristics retrieved by rabpro from Google Earth Engine. Data sources are: population (CIESIN, 2017), NDVI (Didan, 2015), topo slope (Amatulli et al., 2020), precipitation (GPM, 2019), soil moisture (ONeill et al., 2018), and temperature (Copernicus, 2017). (F, G) Basin-averaged time-series data fetched by rabpro for the temperature and precipitation datasets in (E).
Figure 1 The core functionality of rabpro demonstrated on the Sigatoka River. (A) Study site with both MERIT and HydroBASINS delineations and river flowline extraction for a hypothetical gage station. Bing VirtualEarth base image. (B) MERIT-Hydro delineation with MERIT-Hydro flowlines underneath. (C) HydroBASINS delineation with level-12 HydroBASINS polygons as white outlines. (D) Extracted elevation profile with gage location denoted by white circle at Distance = 0. (E) Examples of time-averaged (where appropriate) basin characteristics retrieved by rabpro from Google Earth Engine. Data sources are: population (CIESIN, 2017), NDVI (Didan, 2015), topo slope (Amatulli et al., 2020), precipitation (GPM, 2019), soil moisture (ONeill et al., 2018), and temperature (Copernicus, 2017). (F, G) Basin-averaged time-series data fetched by rabpro for the temperature and precipitation datasets in (E).CC-BY · From the PDF
Image 2
CC-BY · From the PDF
Figure 2 rabpro can return statistics for multiple polygons with a single call. Here, dam-associated (Prior et al., 2022) watersheds in Sri Lanka are delineated and zonal statistics are run for water occurrence, temperature, and precipitation.
Figure 2 rabpro can return statistics for multiple polygons with a single call. Here, dam-associated (Prior et al., 2022) watersheds in Sri Lanka are delineated and zonal statistics are run for water occurrence, temperature, and precipitation.CC-BY · From the PDF

Verification

Claims the paper makes

0 Valid · 0 Not valid · 7 Not checked · 12 Own results and interpretations

4 more claims

Create a free account to see all 19 claims and to verify the 14 references still open.

See all claims — free account
  • It may state two separate claims as one. 3
  • Probably not a substantial claim. 7

Create a free account to see these claims.

Citations

Cites

Show all 38 references

Research works printed but not linked: 2

  1. Tarboton, D. G. (2005). Terrain analysis using digital elevation models (TauDEM). Utah State University, Logan, 3012, 2018.
  2. GDAL/OGR contributors. (2020). GDAL/OGR Geospatial Data Abstraction software Library. Open Source Geospatial Foundation. https://gdal.org

Cited by

See all 6

Metadata

Authors
Schwenk, J., Zussman, T., Stachelek, J., & Rowland, J. C.
Affiliations
  • Columbia University (US)
  • Los Alamos National Laboratory (US)
Venue
Journal of Open Source Software
Published
2022-05-31
Volume
7
Issue
73
Pages
4237
ISSN
2475-9066 (ISSN-L)
OpenAlex
W4281651226
Cited by
6
References
38
Citations by year
2026: 1 · 2025: 1 · 2024: 1 · 2023: 3
FWCI
0.37
Type
journal article
Language
en
Open access
Locations
  • The Journal of Open Source Software (publishedVersion, cc-by)
  • OSTI OAI (U.S. Department of Energy Office of Scientific and Technical Information) (submittedVersion)
Funders
  • U.S. Department of Energy (#89233218CNA000001, 9233218CNA000001)
  • Office of Science (89233218CNA000001)
  • National Nuclear Security Administration (9233218CNA000001, 89233218C-NA000001)
  • Biological and Environmental Research
  • Laboratory Directed Research and Development (20210213ER)
  • Los Alamos National Laboratory (89233218CNA 000001, 9233218CNA000001, 20210213ER)
Topics
  • Physical Sciences › Environmental Science › Water Science and Technology › Hydrology and Watershed Management Studies
  • Physical Sciences › Environmental Science › Environmental Engineering › Groundwater and Watershed Analysis
  • Physical Sciences › Environmental Science › Management, Monitoring, Policy and Law › Environmental Monitoring and Data Management
Keywords
watershed delineation, digital elevation model, river slope, Google Earth Engine, cloud computing, hydrological analysis, Python library

About these checks

Registry, retraction, Cites and statistics results are computed, not judged, with one exception: a printed reference that no index lists is read once by a model before it counts as a citation error. Claims are extracted by a model and kept only when their quote appears verbatim in the text; each cited source is then checked, with a model’s help, for whether it says what the claim relies on. Those verdicts can be wrong — read the claim’s quote and the cited source before relying on one.

A language model drew the claims from the paper on 2026-11-18, under version 3 of the claim definition (model deepseek-v4.1-flash, prompt extract-v3).

A second model labelled each claim on 2026-11-18 (model jev-1.13-20260917, definition revision gold-guideline-v0.2).

Statistics and arithmetic are recomputed, not judged.

Confidence bands are shown only for fields calibrated on our annotated test set. None is calibrated yet, so no band is shown.

What counts as a claim ›How we measure confidence ›How we check this ›

Are you an author, or do you see a problem with this page? Request a review

Data sources

Bibliographic data: Semantic Scholar, OpenAlex, Crossref.

Contains information from the Semantic Scholar Academic Graph Datasets, made available under the ODC Attribution License (ODC-BY 1.0).

Semantic Scholar’s data is described in: Kinney, R., et al. (2023). The Semantic Scholar Open Data Platform. arXiv:2301.10140.