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

February 25, 2026 · View on GitHub

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

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

Hydrological analysis library built with xarray

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-ci| 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

.. |prek| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/j178/prek/master/docs/assets/badge-v0.json :target: https://github.com/j178/prek :alt: prek

.. |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