xHydro

Effortlessly extract geospatial and watershed data from APIs, calibrate and execute hydrological models, perform optimal interpolation and frequency analysis on hydrological indicators, compute custom hydrological metrics, and analyze climate change impacts on hydrological data.
https://github.com/hydrologie/xhydro

Category: Hydrosphere
Sub Category: Freshwater and Hydrology

Keywords

hydrological-data-analysis hydrology hydrology-statistical

Keywords from Contributors

archiving transformer raven observation measurements optimizer conversion wps projections data-catalog

Last synced: about 19 hours ago
JSON representation

Repository metadata

Hydrological analysis library built with xarray.

README.rst

          ======================================
xHydro |logo| |logo-light| |logo-dark|
======================================

+----------------------------+-----------------------------------------------------+
| Versions                   | |pypi| |versions|                                   |
+----------------------------+-----------------------------------------------------+
| Documentation and Support  | |docs|                                              |
+----------------------------+-----------------------------------------------------+
| Open Source                | |license| |ossf-score|                              |
+----------------------------+-----------------------------------------------------+
| Coding Standards           | |black| |isort| |ruff| |pre-commit|                 |
+----------------------------+-----------------------------------------------------+
| Development Status         | |status| |build| |coveralls|                        |
+----------------------------+-----------------------------------------------------+

Hydrological analysis library built with xarray

* Free software: Apache-2.0
* Documentation: https://xhydro.readthedocs.io/en/latest/
* Version française: https://xhydro.readthedocs.io/fr/latest/

Features
--------

* Easily find and extract geospatial data from the Planetary Computer API and watershed boundaries from the HydroSHEDS API over any area of interest.
* Calibrate and execute Hydrotel and Raven-emulated hydrological models.
* Perform optimal interpolation on hydrological data (daily streamflow and indices).
* Compute hydrological indicators (e.g. n-day peak flow, annual maximum series, low flow, average flow, etc.) over custom date ranges.
* Perform frequency analyses on hydrological indicators using a variety of methods (e.g. Gumbel, GEV, etc.).
* Perform climate change impact analyses of hydrological data.

Credits
-------

This package was created with Cookiecutter_ and the `Ouranosinc/cookiecutter-pypackage`_ project template.

This logo was designed by Élyse Fournier (@elysefounier) and Louise Arnal (@lou-a), with inputs from the `xHydro` team.

.. _Cookiecutter: https://github.com/cookiecutter/cookiecutter
.. _`Ouranosinc/cookiecutter-pypackage`: https://github.com/Ouranosinc/cookiecutter-pypackage

.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
        :target: https://github.com/psf/black
        :alt: Python Black

.. |build| image:: https://github.com/hydrologie/xhydro/actions/workflows/main.yml/badge.svg
        :target: https://github.com/hydrologie/xhydro/actions
        :alt: Build Status

.. |coveralls| image:: https://coveralls.io/repos/github/hydrologie/xhydro/badge.svg
        :target: https://coveralls.io/github/hydrologie/xhydro
        :alt: Coveralls

..
    .. |docs| image:: https://img.shields.io/badge/Docs-GitHub.io-blue
            :target: https://hydrologie.github.io/xhydro/
            :alt: Documentation Status

.. |docs| image:: https://readthedocs.org/projects/xhydro/badge/?version=latest
        :target: https://xhydro.readthedocs.io/en/latest/?version=latest
        :alt: Documentation Status

.. |isort| image:: https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336
        :target: https://pycqa.github.io/isort/
        :alt: Isort

.. |license| image:: https://img.shields.io/pypi/l/xhydro
        :target: https://github.com/hydrologie/xhydro/blob/main/LICENSE
        :alt: License

.. |logo| image:: https://raw.githubusercontent.com/hydrologie/xhydro/main/docs/logos/xhydro-logo-small-light.png
        :target: https://github.com/hydrologie/xhydro
        :alt: xHydro

.. |logo-light| image:: https://raw.githubusercontent.com/hydrologie/xhydro/main/docs/logos/empty.png
        :target: https://github.com/hydrologie/xhydro
        :alt:
        :class: xhydro-logo-small only-light-inline

.. |logo-dark| image:: https://raw.githubusercontent.com/hydrologie/xhydro/main/docs/logos/empty.png
        :target: https://github.com/hydrologie/xhydro
        :alt:
        :class: xhydro-logo-small only-dark-inline

..
    .. |ossf-bp| image:: https://bestpractices.coreinfrastructure.org/projects/9945/badge
            :target: https://bestpractices.coreinfrastructure.org/projects/9945
            :alt: Open Source Security Foundation Best Practices

.. |ossf-score| image:: https://api.securityscorecards.dev/projects/github.com/hydrologie/xhydro/badge
        :target: https://securityscorecards.dev/viewer/?uri=github.com/hydrologie/xhydro
        :alt: OpenSSF Scorecard

.. |pre-commit| image:: https://results.pre-commit.ci/badge/github/hydrologie/xhydro/main.svg
        :target: https://results.pre-commit.ci/latest/github/hydrologie/xhydro/main
        :alt: pre-commit.ci Status

.. |pypi| image:: https://img.shields.io/pypi/v/xhydro.svg
        :target: https://pypi.python.org/pypi/xhydro
        :alt: PyPI

.. |ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
        :target: https://github.com/astral-sh/ruff
        :alt: Ruff

.. |status| image:: https://www.repostatus.org/badges/latest/active.svg
        :target: https://www.repostatus.org/#active
        :alt: Project Status: Active – The project has reached a stable, usable state and is being actively developed.

.. |versions| image:: https://img.shields.io/pypi/pyversions/xhydro.svg
        :target: https://pypi.python.org/pypi/xhydro
        :alt: Supported Python Versions

        

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 3 days ago

Total Commits: 1,430
Total Committers: 16
Avg Commits per committer: 89.375
Development Distribution Score (DDS): 0.734

Commits in past year: 738
Committers in past year: 13
Avg Commits per committer in past year: 56.769
Development Distribution Score (DDS) in past year: 0.715

Name Email Commits
Zeitsperre 1****e 381
RondeauG r****l@o****a 369
TC-FF t****o@o****m 137
ospinajulian o****s@o****m 118
dependabot[bot] 4****] 105
pre-commit-ci[bot] 6****] 81
richardarsenault r****t@e****a 62
sebastienlanglois s****s@p****a 52
Kamil Maarite k****e@p****a 44
bumpversion[bot] b****]@h****m 35
Francis Gravel f****l@g****m 21
Thomas-Charles Fortier Filion f****s@m****a 9
Essi Parent 9****f@r****m 7
lou-a l****l@h****r 6
Rondeau-Genesse g****1@o****a 2
update-github-actions[bot] b****]@o****a 1

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 40
Total pull requests: 282
Average time to close issues: about 2 months
Average time to close pull requests: 10 days
Total issue authors: 10
Total pull request authors: 12
Average comments per issue: 1.63
Average comments per pull request: 1.32
Merged pull request: 247
Bot issues: 0
Bot pull requests: 151

Past year issues: 20
Past year pull requests: 155
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 10 days
Past year issue authors: 6
Past year pull request authors: 10
Past year average comments per issue: 0.95
Past year average comments per pull request: 1.21
Past year merged pull request: 130
Past year bot issues: 0
Past year bot pull requests: 86

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

Top Issue Authors

  • RondeauG (21)
  • sebastienlanglois (4)
  • TC-FF (4)
  • Zeitsperre (3)
  • EdouardMailhot (2)
  • ospinajulian (2)
  • Sci-pio (1)
  • essicolo (1)
  • juliettelavoie (1)
  • richardarsenault (1)

Top Pull Request Authors

  • dependabot[bot] (135)
  • RondeauG (51)
  • Zeitsperre (40)
  • TC-FF (19)
  • pre-commit-ci[bot] (16)
  • richardarsenault (5)
  • ospinajulian (5)
  • sebastienlanglois (5)
  • lou-a (3)
  • Sci-pio (1)
  • essicolo (1)
  • Mayetea (1)

Top Issue Labels

  • enhancement (18)
  • bug (14)
  • documentation (5)
  • help wanted (1)
  • question (1)
  • dependencies (1)
  • notebooks (1)

Top Pull Request Labels

  • approved (181)
  • CI (157)
  • dependencies (138)
  • github_actions (80)
  • python (55)
  • docs (42)
  • notebooks (41)
  • documentation (16)
  • enhancement (11)
  • bug (4)
  • good first issue (1)
  • wontfix (1)

Package metadata

proxy.golang.org: github.com/hydrologie/xhydro

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/hydrologie/xhydro#section-documentation
  • Licenses: apache-2.0
  • Latest release: v0.5.0 (published about 2 months ago)
  • Last Synced: 2025-06-11T17:32:01.718Z (2 days ago)
  • Versions: 25
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
pypi.org: xhydro-temp

Hydrological analysis library built with xarray.

  • Homepage: https://xhydro.readthedocs.io/
  • Documentation: https://xhydro-temp.readthedocs.io/
  • Licenses: Apache Software License
  • Latest release: 0.3.8.dev4 (published 11 months ago)
  • Last Synced: 2025-06-11T17:32:01.962Z (2 days ago)
  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 19 Last month
  • Rankings:
    • Dependent packages count: 10.685%
    • Average: 35.429%
    • Dependent repos count: 60.172%
  • Maintainers (1)
pypi.org: xhydro

Hydrological analysis library built with xarray.

  • Homepage: https://xhydro.readthedocs.io/
  • Documentation: https://xhydro.readthedocs.io/
  • Licenses: Apache Software License
  • Latest release: 0.5.0 (published about 2 months ago)
  • Last Synced: 2025-06-11T17:32:02.403Z (2 days ago)
  • Versions: 9
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 145 Last month
  • Rankings:
    • Dependent packages count: 7.49%
    • Average: 38.649%
    • Dependent repos count: 69.808%
  • Maintainers (2)

Score: 11.87956658122081