Skip to content

Hydrological Drought Forecasting Model with HydroMT and Wflow

License

Notifications You must be signed in to change notification settings

interTwin-eu/HyDroForM

Repository files navigation

InterTwin HyDroForM

HyDroForM

Table of Contents

Introduction

HyDroForM stands for "Hydrological Drought Forecasting Model with HydroMT and Wflow". It is a Digital Twin for Drought Early Warning in the Alps developed as a use case for the InterTwin project. The details of the use case are also available online here.

InterTwin components used in this use case are:

Environment setup

To develop and test locally, use the provided environment.yaml file to create a conda environment:

conda env create -f environment.yaml
conda activate hydroform

TODO: Use case diagram

TODO: System design diagram

Use case components

There are three main components in the HyDroForM use case:

HydroMT

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 analyse model results once the simulation has finished. HydroMT builds on the latest packages in the scientific and geospatial python eco-system including xarray, rasterio, rioxarray, geopandas, scipy and pyflwdir. Source: Deltares HydroMT

Running HydroMT

To run HydroMT from start to finish you can use the validation script which is located in /docker/hydromt/validation.sh. This script will run the HydroMT validation test which includes the following steps:

  1. Update the configuration file of HydroMT
  2. Run HydroMT using the configuration file
  3. Convert the output Wflow configuration file to lowercase letters
  4. Wrap the outputs into STAC collections

Wflow

Wflow is Deltares’ solution for modelling hydrological processes, allowing users to account for precipitation, interception, snow accumulation and melt, evapotranspiration, soil water, surface water and groundwater recharge in a fully distributed environment. Successfully applied worldwide for analyzing flood hazards, drought, climate change impacts and land use changes, wflow is growing to be a leader in hydrology solutions. Wflow is conceived as a framework, within which multiple distributed model concepts are available, which maximizes the use of open earth observation data, making it the hydrological model of choice for data scarce environments. Based on gridded topography, soil, land use and climate data, wflow calculates all hydrological fluxes at any given grid cell in the model at a given time step. Source: Deltares Wflow

Running Wflow

TODO: Surrogate model

OSCAR

OSCAR is an open-source platform to support the event-driven serverless computing model for data-processing applications. It can be automatically deployed on multi-Clouds, and even on low-powered devices, to create highly-parallel event-driven data-processing serverless applications along the computing continuum. These applications execute on customized runtime environments provided by Docker containers that run on elastic Kubernetes clusters. It is also integrated with the SCAR framework, which supports a High Throughput Computing Programming Model to create highly-parallel event-driven data-processing serverless applications that execute on customized runtime environments provided by Docker containers run on AWS Lambda and AWS Batch. OSCAR

Tests

The components of the use case are set up in Docker containers. We have a set of scripts available to build and run the base images. These can be found in the /tests directory and can be run from root directory of the repository.

For example:

./tests/test_hydromt.sh

TODO: Use case demonstration

License

This project is licensed under the Apache 2.0 - see the LICENSE file for details.

About

Hydrological Drought Forecasting Model with HydroMT and Wflow

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •