A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

pyflwdir

Fast methods to work with hydro- and topography data in pure Python.
https://github.com/deltares/pyflwdir

Category: Hydrosphere
Sub Category: Freshwater and Hydrology

Keywords

basins d8 hydrography hydrology ldd topography watershed

Keywords from Contributors

hydrodynamics hydrological-modelling

Last synced: about 12 hours ago
JSON representation

Repository metadata

Fast methods to work with hydro- and topography data in pure Python.

README.rst

          #############################################################################
PyFlwDir: Fast methods to work with hydro- and topography data in pure Python
#############################################################################

.. image:: https://codecov.io/gh/Deltares/PyFlwDir/branch/main/graph/badge.svg?token=N4VMHJJAV3
    :target: https://codecov.io/gh/Deltares/PyFlwDir

.. image:: https://img.shields.io/badge/docs-latest-brightgreen.svg
    :target: https://deltares.github.io/pyflwdir/latest
    :alt: Latest docs

.. image:: https://mybinder.org/badge_logo.svg
    :alt: Binder
    :target: https://mybinder.org/v2/gh/Deltares/pyflwdir/main?urlpath=lab/tree/examples

.. image:: https://badge.fury.io/py/PyFlwDir.svg
    :target: https://pypi.org/project/PyFlwDir/
    :alt: Latest PyPI version

.. image:: https://anaconda.org/conda-forge/PyFlwDir/badges/version.svg
    :target: https://anaconda.org/conda-forge/PyFlwDir

.. image:: https://zenodo.org/badge/409871473.svg
   :target: https://zenodo.org/badge/latestdoi/409871473

.. image:: https://img.shields.io/github/license/Deltares/pyflwdir?style=flat
    :alt: License
    :target: https://github.com/Deltares/pyflwdir/blob/main/LICENSE



Intro
-----

PyFlwDir contains a series of methods to work with gridded DEM and flow direction
datasets, which are key to many workflows in many earth sciences.
PyFlwDir supports several flow direction data conventions and can easily be extended to include more.
The package contains some unique methods such as Iterative Hydrography Upscaling (IHU)
method to upscale flow directions from high resolution data to coarser model resolution.

PyFlwDir is in pure python and powered by `numba `_ to keep it fast.


Featured methods
----------------

- flow directions from elevation data using a steepest gradient algorithm
- strahler stream order
- flow direction upscaling
- (sub)basin delineation
- pfafstetter subbasins delineation
- classic stream order
- height above nearest drainage (HAND)
- geomorphic floodplain delineation
- up- and downstream tracing and arithmetics
- hydrologically adjusting elevation
- upstream accumulation
- vectorizing streams
- many more!

.. image:: https://raw.githubusercontent.com/Deltares/pyflwdir/main/docs/_static/pyflwdir.png
  :width: 100%


Installation
------------

See `installation guide `_

Quickstart
----------

See `user guide `_


Reference API
-------------

See `reference API `_


Development and Testing
-----------------------

Welcome to the PyFlwDir project. All contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome.
See `Contributing to PyFlwDir `__ for how we work.

        

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 6 days ago

Total Commits: 423
Total Committers: 4
Avg Commits per committer: 105.75
Development Distribution Score (DDS): 0.019

Commits in past year: 8
Committers in past year: 2
Avg Commits per committer in past year: 4.0
Development Distribution Score (DDS) in past year: 0.125

Name Email Commits
DirkEilander d****r@g****m 415
verseve w****d@g****m 6
vzagorovskiy v****y@g****m 1
Martijn Visser m****r@g****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 35
Total pull requests: 29
Average time to close issues: 7 months
Average time to close pull requests: about 1 month
Total issue authors: 14
Total pull request authors: 4
Average comments per issue: 2.06
Average comments per pull request: 0.31
Merged pull request: 27
Bot issues: 0
Bot pull requests: 0

Past year issues: 11
Past year pull requests: 10
Past year average time to close issues: 5 months
Past year average time to close pull requests: 2 months
Past year issue authors: 6
Past year pull request authors: 3
Past year average comments per issue: 1.91
Past year average comments per pull request: 0.1
Past year merged pull request: 9
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/deltares/pyflwdir

Top Issue Authors

  • DirkEilander (13)
  • AquaPore (4)
  • debpal (3)
  • JasonDalton (2)
  • schoeller (2)
  • Jiangchao3 (2)
  • MauKruisheer (2)
  • vzagorovskiy (1)
  • lotruheawea (1)
  • mn5hk (1)
  • robgpita (1)
  • lj512lj512 (1)
  • forestbat (1)
  • akkana (1)

Top Pull Request Authors

  • DirkEilander (26)
  • vzagorovskiy (1)
  • verseve (1)
  • robgpita (1)

Top Issue Labels

  • enhancement (8)
  • documentation (2)
  • wontfix (2)
  • invalid (1)
  • needs refinement (1)
  • pending upstream release (1)
  • question (1)

Top Pull Request Labels


Package metadata

pypi.org: pyflwdir

Fast methods to work with hydro- and topography data in pure Python.

  • Homepage: https://github.com/Deltares/pyflwdir
  • Documentation: https://deltares.github.io/pyflwdir
  • Licenses: MIT License
  • Latest release: 0.5.10 (published 2 months ago)
  • Last Synced: 2025-04-25T13:30:50.021Z (1 day ago)
  • Versions: 17
  • Dependent Packages: 6
  • Dependent Repositories: 1
  • Downloads: 3,259 Last month
  • Rankings:
    • Dependent packages count: 1.597%
    • Stargazers count: 9.68%
    • Forks count: 10.952%
    • Average: 11.292%
    • Downloads: 12.143%
    • Dependent repos count: 22.088%
  • Maintainers (1)
pypi.org: nldi-flowtools

NLDI Flowtools

  • Homepage: https://code.usgs.gov/wma/nhgf/toolsteam/nldi-flowtools
  • Documentation: https://nldi-flowtools.readthedocs.io
  • Licenses: LICENSE.md
  • Latest release: 0.3.4 (published 2 months ago)
  • Last Synced: 2025-04-25T13:30:49.961Z (1 day ago)
  • Versions: 22
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 684 Last month
  • Rankings:
    • Dependent packages count: 10.103%
    • Average: 17.657%
    • Downloads: 21.261%
    • Dependent repos count: 21.607%
  • Maintainers (1)
conda-forge.org: pyflwdir

  • Homepage: https://github.com/deltares/pyflwdir/
  • Licenses: MIT
  • Latest release: 0.5.6 (published over 2 years ago)
  • Last Synced: 2025-04-25T13:30:57.675Z (1 day ago)
  • Versions: 12
  • Dependent Packages: 3
  • Dependent Repositories: 3
  • Rankings:
    • Dependent packages count: 15.638%
    • Dependent repos count: 17.914%
    • Average: 32.19%
    • Stargazers count: 44.857%
    • Forks count: 50.352%

Dependencies

environment.yml conda
  • affine
  • cartopy
  • descartes
  • geopandas
  • jupyter
  • matplotlib
  • numba >=0.48
  • numpy
  • python >=3.6
  • rasterio
  • scipy
  • setuptools_scm
.github/workflows/docs.yml actions
  • actions/checkout v2 composite
  • conda-incubator/setup-miniconda v2 composite
  • peaceiris/actions-gh-pages v3.8.0 composite
.github/workflows/publish.yml actions
  • actions/checkout v3 composite
  • actions/checkout v2 composite
  • actions/download-artifact v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
  • pypa/gh-action-pypi-publish v1.5.1 composite
.github/workflows/test_cov.yml actions
  • actions/checkout v2 composite
  • codecov/codecov-action v1 composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/tests.yml actions
  • actions/checkout v2 composite
  • conda-incubator/setup-miniconda v2 composite

Score: 14.244752086729404