PyFlowline

A mesh-independent river network generator and topological framework for hydrologic models

PyFlowline is a Python package designed for mesh-independent river network generation and topological operations. It serves as a foundational component for unstructured hydrologic models, allowing river networks to be mapped onto arbitrary meshes (such as MPAS Voronoi meshes, hexagons, triangles, and lat-lon grids) with topologically consistent connectivity.

Installation

You can install PyFlowline via conda-forge:

conda install -c conda-forge pyflowline

Or via pip:

pip install pyflowline

Key Resources

Selected Publications

  • Liao, C., et al. (2023). Topological relationship-based flow direction modeling: Mesh-independent river networks representation. Journal of Advances in Modeling Earth Systems, 15(3), e2022MS003089. DOI: 10.1029/2022MS003089
  • Liao, C., et al. (2023). PyFlowline: a mesh-independent river network generator for hydrologic models. Journal of Open Source Software, 8(82), 4970. DOI: 10.21105/joss.04970

References