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

The DOI matches its Crossref record; 20 of the 21 references it cites were found in a registry or an index, and 1 are not checked yet; none of the 18 sources its claims cite is checked for support yet.

RivGraph: Automatic extraction and analysis of river and delta channel network topology

Open access
Schwenk, Jon, Hariharan, Jayaram · 2021 · Journal of Open Source Software

Abstract

River networks sustain life and landscapes by carrying and distributing water, sediment, and nutrients throughout ecosystems and communities.At the largest scale, river networks drain continents through tree-like tributary networks.At typically smaller scales, river deltas and braided rivers form loopy, complex distributary river networks via avulsions and bifurcations.In order to model flows through these networks or analyze network structure, the topology, or connectivity, of the network must be resolved.Additionally, morphologic properties of each river channel as well as the direction of flow through the channel inform how fluxes travel through the network's channels.

Checked 2026-11-18 · 1 reference not checked yet

Overview

CoChat Summary

TL;DR

RivGraph is a Python package that converts a user-provided binary mask of a river or delta channel network into an explicit graph representation, resolving channel centerlines as links and junctions as nodes. It additionally solves flow directions without auxiliary data such as a DEM and computes morphologic and topologic properties of the network.

Key findings

  • RivGraph automates extraction and characterization of channel networks from binary masks, producing links (centerlines) and nodes (junctions), and solving flow directions for each link without auxiliary data such as a digital elevation model.
  • It computes morphologic properties including link lengths, widths, sinuosities, branching angles, and braiding indices, and offers a suite of topologic metrics designed specifically for river channel network analysis (Tejedor et al., 2015b).
  • Results can be preserved with georeferencing and exported as ESRI shapefiles, GeoJSONs, and GeoTIFFs, or returned as networkx objects; if the mask is not georeferenced, a "dummy" CRS is applied and physical quantities such as length and width are in units of pixels.
  • The paper reports prior and ongoing applications rather than new empirical results: RivGraph-extracted networks have been used to study water and sediment partitioning at bifurcations (Dong et al., 2020), Arctic delta lake dynamics (Vulis et al., 2020), nitrate removal in the Wax Lake Delta (Knights et al., 2020), and to develop the "entropic braiding index" (eBI, Tejedor et al., 2019).

Methods

  • Design: a Python package organized into modules (classes, directionality, geo_utils, im_utils, io_utils, ln_utils, mask_to_graph, walk, plus delta- and river-specific submodules), with two user-facing classes — a delta class and a (braided) river class — managing georeferencing, path management, and I/O.
  • Input and processing: the user supplies a binary channel mask (from remotely-sensed imagery, simulations, or hand drawings); the workflow skeletonizes the mask, walks the skeleton to resolve links and nodes, prunes dangling and bridging links, computes link width (via a distance transform sampled along the centerline, multiplied by two) and length (sum of Euclidean distances between pixel pairs), and assigns flow directions using separate "recipes" for deltas and rivers.
  • Comparison to related tools: the Orinoco Python package uses a fast marching method rather than RivGraph's skeletonization approach and uses only a shortest-path approach for flow directions, whereas RivGraph exploits many morphologic features (including shortest path); the Lowpath add-on may be of interest if a DEM is available.

Limitations

  • Stated in the paper: the channel mask is the basis for all RivGraph processing, so the user "should consider carefully the features to include and the desired level of smoothing"; because RivGraph respects the mask's connectivity, users may need to preprocess masks (e.g., fill small or unwanted islands, smooth channel boundaries) using the im_utils() functions.
  • Stated in the paper: for the delta class, user-provided shoreline and inlet nodes files are required so the network can be pruned to the shoreline and inlet/outlet nodes identified; the river class instead requires a two-character string denoting the exit sides of the river with respect to the mask.
  • Evident from the text: the paper presents no quantitative validation, accuracy assessment, or benchmark of the extraction or flow-direction algorithms; evaluation is limited to listing prior applications and a qualitative comparison with Orinoco and Lowpath.

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

Integrity signals

Registry

Crossref · 10.21105/joss.02952

Cites

20 of 21 references verified0 citation errors · 0 not checkable

Statistics

Nothing to recompute.

Figures

Figure 1 The core functionality of RivGraph for a delta channel network.
Figure 1 The core functionality of RivGraph for a delta channel network.CC-BY · From the PDF
Image 2
CC-BY · From the PDF
Figure 2 Figure 2. A RivGraph-generated mesh for a mask of the Indus River.
Figure 2 Figure 2. A RivGraph-generated mesh for a mask of the Indus River.CC-BY · From the PDF

Verification

Claims the paper makes

0 Valid · 6 Not valid · 14 Not checked · 28 Own results and interpretations

5 more claims

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

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

Create a free account to see these claims.

Citations

Cites

Show all 21 references

Cited by

See all 43

Metadata

Authors
Schwenk, J., & Hariharan, J.
Affiliations
  • Los Alamos National Laboratory (US)
  • The University of Texas at Austin (US)
Venue
Journal of Open Source Software
Published
2021-03-10
Volume
6
Issue
59
Pages
2952
ISSN
2475-9066 (ISSN-L)
OpenAlex
W3134303177
Cited by
43
References
21
Citations by year
2026: 13 · 2025: 7 · 2024: 6 · 2023: 7 · 2022: 9 · 2021: 1
FWCI
3.38
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
  • National Science Foundation (1719670)
  • U.S. Department of Energy
  • Laboratory Directed Research and Development
  • Los Alamos National Laboratory
Topics
  • Physical Sciences › Earth and Planetary Sciences › Earth-Surface Processes › Hydrology and Sediment Transport Processes
  • Physical Sciences › Earth and Planetary Sciences › Earth-Surface Processes › Geological formations and processes
  • Physical Sciences › Environmental Science › Environmental Engineering › Groundwater and Watershed Analysis
Keywords
river networks, braided rivers, network topology, channel extraction, graph representation, flow direction, avulsion, bifurcation, network connectivity

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

How to cite

Cite CoChat for the checks on this page, and the paper for its own findings.

This page
CoChat. (2026). Citation check: RivGraph: Automatic extraction and analysis of river and delta channel network topology. https://app.cochat.ai/papers/10.21105/joss.02952
The paper
Schwenk, J., & Hariharan, J. (2021). RivGraph: Automatic extraction and analysis of river and delta channel network topology. Journal of Open Source Software. https://doi.org/10.21105/joss.02952

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.