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

raven birdhouse pavics wps earth-system-model

Last synced: about 9 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 (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-10-23T21:11:49.000Z (2 months ago)
• Last Synced: 2025-10-28T19:47:39.236Z (about 2 months ago)
• Topics: hydrological-data-analysis, hydrology, hydrology-statistical
• Language: Python
• Homepage: https://xhydro.readthedocs.io
• Size: 40.6 MB
• Stars: 55
• Watchers: 4
• Forks: 5
• Open Issues: 10
• Releases: 11
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md
  • Authors: AUTHORS.rst
  • Zenodo: .zenodo.json

README.rst

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

+----------------------------+-----------------------------------------------------+
| Versions                   | |pypi| |conda|                                      |
+----------------------------+-----------------------------------------------------+
| Documentation and Support  | |docs| |versions|                                   |
+----------------------------+-----------------------------------------------------+
| Open Source                | |license| |ossf-score|                              |
+----------------------------+-----------------------------------------------------+
| Coding Standards           | |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

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

.. |conda| image:: https://img.shields.io/conda/vn/conda-forge/xhydro.svg
        :target: https://anaconda.org/conda-forge/xhydro
        :alt: Conda-forge Build Version

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

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

.. |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: 105
• Release event: 3
• Issues event: 27
• Watch event: 31
• Delete event: 104
• Member event: 4
• Issue comment event: 118
• Push event: 557
• Pull request review event: 187
• Pull request review comment event: 125
• Pull request event: 192
• Fork event: 1

Last Year

• Create event: 99
• Release event: 3
• Issues event: 26
• Watch event: 27
• Delete event: 99
• Member event: 3
• Issue comment event: 113
• Push event: 500
• Pull request review comment event: 121
• Pull request review event: 177
• Pull request event: 181
• Fork event: 1

---

Committers metadata

Last synced: about 2 months ago

Name	Email	Commits
Zeitsperre	1****e	421
RondeauG	r****l@o****a	421
TC-FF	t****o@o****m	162
ospinajulian	o****s@o****m	154
dependabot[bot]	4****]	121
pre-commit-ci[bot]	6****]	89
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	28
Gabriel Rondeau	r****u@h****a	26
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	3
elysefournier	4****r	2
update-github-actions[bot]	b****]@o****a	1

Committer domains:

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

---

Issue and Pull Request metadata

Last synced: 2 months ago

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

---

---

---

Package metadata

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

Score: 12.893704645402009