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:
- OpenEO
- raster-to-stac
- DownscaleML
- openeo-pg-parser-networkx
- openeo-processes-dask
- HydroMT-Sfincs
- ItwinAI
- OSCAR
- Hython
- InterLink
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
There are three main components in the HyDroForM use case:
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
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:
- Update the configuration file of HydroMT
- Run HydroMT using the configuration file
- Convert the output Wflow configuration file to lowercase letters
- Wrap the outputs into STAC collections
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
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
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
This project is licensed under the Apache 2.0 - see the LICENSE file for details.