Metadata-Version: 2.4
Name: hydromt_wflow
Version: 1.0.2
Summary: HydroMT plugin for wflow.
Author-email: Dirk Eilander <dirk.eilander@deltares.nl>, Hélène Boisgontier <helene.boisgontier@deltares.nl>, Joost Buitink <joost.buitink@deltares.nl>, Brendan Dalmijn <brendan.dalmijn@deltares.nl>, Tjalling de Jong <tjalling.dejong@deltares.nl>, Sam Vente <sam.vente@deltares.nl>, Marnix Kraus <marnix.kraus@deltares.nl>, Luuk Blom <luuk.blom@deltares.nl>
License-Expression: GPL-3.0-or-later
Project-URL: Documentation, http://deltares.github.io/hydromt_wflow/latest/
Project-URL: Source, https://github.com/Deltares/hydromt_wflow
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Hydrology
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: dask
Requires-Dist: geopandas>=0.10
Requires-Dist: hydromt>=1.3.1
Requires-Dist: numpy
Requires-Dist: rasterio<1.5
Requires-Dist: pandas<4
Requires-Dist: pyflwdir>=0.5.7
Requires-Dist: pyproj
Requires-Dist: scipy
Requires-Dist: shapely
Requires-Dist: xarray
Requires-Dist: pooch
Provides-Extra: dist
Requires-Dist: build; extra == "dist"
Requires-Dist: twine; extra == "dist"
Provides-Extra: lint
Requires-Dist: pre-commit; extra == "lint"
Requires-Dist: ruff; extra == "lint"
Provides-Extra: docs
Requires-Dist: nbsphinx; extra == "docs"
Requires-Dist: pydata-sphinx-theme; extra == "docs"
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx_design; extra == "docs"
Requires-Dist: sphinx_autosummary_accessors; extra == "docs"
Requires-Dist: sbom4python; extra == "docs"
Provides-Extra: examples
Requires-Dist: cartopy; extra == "examples"
Requires-Dist: jupyterlab; extra == "examples"
Requires-Dist: nbconvert; extra == "examples"
Requires-Dist: notebook; extra == "examples"
Provides-Extra: extra
Requires-Dist: gwwapi; extra == "extra"
Requires-Dist: hydroengine; extra == "extra"
Requires-Dist: pyet; extra == "extra"
Requires-Dist: wradlib; extra == "extra"
Provides-Extra: test
Requires-Dist: pytest>=2.7.3; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: pytest-mock; extra == "test"
Requires-Dist: pytest-timeout; extra == "test"
Requires-Dist: pytest-benchmark; extra == "test"
Provides-Extra: full
Requires-Dist: hydromt_wflow[examples,extra]; extra == "full"
Provides-Extra: dev
Requires-Dist: hydromt_wflow[dist,docs,lint,test]; extra == "dev"
Provides-Extra: all
Requires-Dist: hydromt_wflow[dev,full]; extra == "all"
Dynamic: license-file

.. _readme:

=======================================
HydroMT-Wflow: Wflow plugin for HydroMT
=======================================

|pypi| |conda_forge| |docs_latest| |docs_stable| |license| |doi| |binder| |sonarqube_coverage| |sonarqube|

What is the HydroMT-Wflow plugin
--------------------------------
HydroMT_ (Hydro Model Tools) is an open-source Python package that facilitates the process of
building and analyzing spatial geoscientific models with a focus on water system models.
It does so by automating the workflow to go from raw data to a complete model instance which
is ready to run and to analyze model results once the simulation has finished.
This plugin provides an implementation of the model API for the Wflow_ model.

Why HydroMT-Wflow?
------------------
Setting up distributed hydrological models typically requires many (manual) steps
to process input data and might therefore be time consuming and hard to reproduce.
Especially improving models based on global-local geospatial datasets, which are
rapidly becoming available at increasingly high resolutions, might be challenging.
HydroMT-Wflow aims to make the Wflow model building and updating processes **fast**, **modular** and **reproducible**
and to facilitate the analysis of the model results.

How to use HydroMT-Wflow?
-------------------------
The HydroMT-Wflow plugin can be used as a **command line** application, which provides commands to *build*,
*update* (including clip) a Wflow model with a single line, or **from python** to exploit its rich interface.
You can learn more about how to use HydroMT-Wflow in its `online documentation. <https://deltares.github.io/hydromt_wflow/latest/getting_started/intro>`_
For a smooth installing experience we recommend installing HydroMT-Wflow and its dependencies
from conda-forge in a clean environment, see `installation guide. <https://deltares.github.io/hydromt_wflow/latest/getting_started/installation>`_

How to cite?
------------
For publications, please cite our work using the DOI provided in the Zenodo badge |doi| that points to the latest release.

How to contribute?
-------------------
If you find any issues in the code or documentation feel free to leave an issue on the `github issue tracker. <https://github.com/Deltares/hydromt_wflow/issues>`_
You can find information about how to contribute to the HydroMT project at our `contributing page. <https://deltares.github.io/hydromt/latest/dev/core_dev/contributing.html>`_

HydroMT seeks active contribution from the (hydro) geoscientific community.
So far, it has been developed and tested with a range of `Deltares <https://www.deltares.nl/en/>`_ models, but
we believe it is applicable to a much wider set of geoscientific models and are
happy to discuss how it can be implemented for your model.

Changelog
----------
See the `full changelog <https://deltares.github.io/hydromt_wflow/latest/changelog.html>`_ for a complete list of changes and release notes.

.. _Hydromt: https://deltares.github.io/hydromt/latest/
.. _Wflow: https://github.com/Deltares/Wflow.jl

.. |sonarqube| image:: https://sonarcloud.io/api/project_badges/measure?project=Deltares_hydromt_wflow&metric=alert_status
    :target: https://sonarcloud.io/summary/new_code?id=Deltares_hydromt_wflow
    :alt: SonarQube status

.. |sonarqube_coverage| image:: https://sonarcloud.io/api/project_badges/measure?project=Deltares_hydromt_wflow&metric=coverage
    :alt: Coverage
    :target: https://sonarcloud.io/summary/new_code?id=Deltares_hydromt_wflow

.. |docs_latest| image:: https://img.shields.io/badge/docs-latest-brightgreen.svg
    :target: https://deltares.github.io/hydromt_wflow/latest
    :alt: Latest developers docs

.. |docs_stable| image:: https://img.shields.io/badge/docs-stable-brightgreen.svg
    :target: https://deltares.github.io/hydromt_wflow/stable
    :alt: Stable docs last release

.. |pypi| image:: https://img.shields.io/pypi/v/hydromt_wflow.svg?style=flat
    :target: https://pypi.org/project/hydromt_wflow/
    :alt: PyPI

.. |conda_forge| image:: https://anaconda.org/conda-forge/hydromt_wflow/badges/version.svg
    :target: https://anaconda.org/conda-forge/hydromt_wflow
    :alt: Conda-Forge

.. |binder| image:: https://mybinder.org/badge_logo.svg
    :target: https://mybinder.org/v2/gh/Deltares/hydromt_wflow/main?urlpath=lab/tree/examples

.. |doi| image:: https://zenodo.org/badge/356210291.svg
    :alt: Zenodo
    :target: https://zenodo.org/badge/latestdoi/356210291

.. |license| image:: https://img.shields.io/github/license/Deltares/hydromt_wflow
    :alt: License
    :target: https://github.com/Deltares/hydromt_wflow/blob/main/LICENSE

Dependencies
------------
HydroMT-Wflow builds on the HydroMT core and relies on several excellent open-source packages for geospatial and scientific computing, including:

- **Core Scientific & Data libraries:** `hydromt`, `xarray`, `numpy`, `pandas`, `scipy`, `numba`, `dask`, `bottleneck`, `cftime`, `gwwapi`, `hydroengine`, `pyflwdir`,
- **Geospatial libraries:** `geopandas`, `shapely`, `rasterio`, `rioxarray`, `pyproj`, `pyogrio`, `cligj`
- **Configuration, Validation & CLI Tools:** `attrs`, `click`, `click-plugins`, `pydantic`, `pydantic-core`, `pyyaml`, `typing-inspection`, `importlib-metadata`
- **File IO, Storage & Networking:** `fsspec`, `netcdf4`, `tomli`, `tomli-w`, `requests`, `universal-pathlib`, `urllib3`, `pooch`, `pyet`, `wradlib`
- **Utilities & Support libraries:** `colorama`, `six`, `packaging`, `platformdirs`, `partd`, `toolz`
- **Other dependencies:** `affine`, `annotated-types`, `certifi`, `charset-normalizer`, `cloudpickle`, `crc32c`, `donfig`, `idna`, `llvmlite`, `locket`, `mercantile`, `numcodecs`, `pystac`, `pyparsing`, `python-dateutil`, `pytz`, `typing-extensions`, `tzdata`, `xmltodict`, `zarr`, `zipp`
- **Examples & Visualization:** `cartopy`, `jupyterlab`, `nbconvert`, `notebook`
