Skip to content

v0.2.0 — NetworkX river networks and GRASS modernization

Choose a tag to compare

@awickert awickert released this 25 Jun 14:46

First release since 2017. It modernizes the toolkit for current GRASS GIS and
adds NetworkX-based river-network analysis, developed in collaboration with
Fergus McNab (GFZ Potsdam) and presented at AGU 2025:

Wickert, A. D., and F. McNab (2025), Simulating Geomorphic Evolution Through
River Networks, EP23D-1702, AGU Fall Meeting, New Orleans, LA, USA.

The API is still pre-1.0 and may change.

Added

  • v.stream.networkx — a new module that builds a NetworkX
    directed graph of a river network, samples elevation and flow accumulation
    along each segment, computes cumulative distance upstream of the outlet by a
    breadth-first sweep, and optionally exports the graph as JSON. Ships with a
    Makefile and HTML manual page so it installs as a GRASS addon.
  • examples/clean_coarsen_network.py — a post-processing ("stage 2") script
    that despikes, smooths, and coarsens a v.stream.networkx JSON export for use
    as input to a downstream long-profile model such as GRLP.
  • LICENSE (GNU GPL v3 or later), CITATION.cff, a project README, and
    this CHANGELOG.

Changed

  • v.stream.profiler reworked and modernized for current GRASS GIS; adopts
    Pandas; produces river long profiles and slope–accumulation (e.g., slope–area)
    outputs.
  • v.stream.network updated for current GRASS GIS; GRASS+NumPy raster reads
    modernized to a single step; tostream enforced as integer; the off-map
    outlet segment is coded as 0.

Removed

  • Legacy scripts outside the fluvial-profiler scope (PRMS/MODFLOW/GSFLOW grid and
    parameter builders, an older standalone network extractor, and assorted one-off
    utilities). Standalone, multicore, and other Python-2 development scripts were
    moved to archive/.

Full changelog: v0.1.0...v0.2.0