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 raven observation transforms measur conversion wps optimize projection token

Last synced: about 2 hours ago
JSON representation

Repository metadata

Hydrological analysis library built with xarray.

• Host: GitHub
• URL: https://github.com/hydrologie/xhydro
• Owner: hydrologie
• License: apache-2.0
• Created: 2023-05-05T13:54:21.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-07-25T18:50:37.000Z (6 days ago)
• Last Synced: 2025-07-25T22:18:09.089Z (6 days ago)
• Topics: hydrological-data-analysis, hydrology, hydrology-statistical
• Language: Python
• Homepage: https://xhydro.readthedocs.io
• Size: 40 MB
• Stars: 45
• Watchers: 4
• Forks: 5
• Open Issues: 11
• Releases: 9
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Authors: AUTHORS.rst
  • Zenodo: .zenodo.json

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

• Name: hydrologie
• Login: hydrologie
• Email:
• Kind: organization
• Description:
• Website:
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/64544854?v=4
• Repositories: 1
• Last ynced at: 2023-05-01T21:32:30.784Z
• Profile URL: https://github.com/hydrologie

---

GitHub Events

Total

• Create event: 89
• Release event: 1
• Issues event: 26
• Watch event: 25
• Delete event: 86
• Member event: 4
• Issue comment event: 107
• Push event: 465
• Pull request review event: 160
• Pull request review comment event: 119
• Pull request event: 164
• Fork event: 1

Last Year

• Create event: 89
• Release event: 1
• Issues event: 26
• Watch event: 25
• Delete event: 86
• Member event: 4
• Issue comment event: 107
• Push event: 465
• Pull request review event: 160
• Pull request review comment event: 119
• Pull request event: 164
• Fork event: 1

---

Committers metadata

Last synced: 6 days ago

Name	Email	Commits
Zeitsperre	1****e	384
RondeauG	r****l@o****a	370
TC-FF	t****o@o****m	137
ospinajulian	o****s@o****m	124
dependabot[bot]	4****]	110
pre-commit-ci[bot]	6****]	82
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
Thomas-Charles Fortier Filion	f****s@m****a	27
Francis Gravel	f****l@g****m	21
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
Gabriel Rondeau	r****u@h****a	1

Committer domains:

• ouranos.ca: 3
• polymtl.ca: 2
• halia.ouranos.ca: 1
• relay.firefox.com: 1
• mdo.hydro.qc.ca: 1
• hydrologie.com: 1
• etsmtl.ca: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

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

---

---

---

Package metadata

• Total packages: 3
• Total downloads:
  • pypi: 161 last-month
• Total dependent packages: 0 (may contain duplicates)
• Total dependent repositories: 0 (may contain duplicates)
• Total versions: 37
• Total maintainers: 3

Score: 11.958431462615565