Preprints
https://doi.org/10.5194/gmd-2021-344
https://doi.org/10.5194/gmd-2021-344

Submitted as: development and technical paper 24 Nov 2021

Submitted as: development and technical paper | 24 Nov 2021

Review status: this preprint is currently under review for the journal GMD.

The eWaterCycle platform for Open and FAIR Hydrological collaboration

Rolf Hut1, Niels Drost2, Nick van de Giesen1, Ben van Werkhoven2, Banafsheh Abdollahi1, Jerom Aerts1, Thomas Albers1, Fakhereh Alidoost2, Bouwe Andela2, Jaro Camphuijsen2, Yifat Dzigan2, Ronald van Haren2,a, Eric Hutton3, Peter Kalverla2, Maarten van Meersbergen2, Gijs van den Oord2, Inti Pelupessy2, Stef Smeets2, Stefan Verhoeven2, Martine de Vos2,b, and Berend Weel2 Rolf Hut et al.
  • 1Delft University of Technology, Faculty of Civil Engineering and Geoscience, Delft, Netherlands
  • 2Netherlands eScience Center, Amsterdam, Netherlands
  • 3Institute for Arctic and Alpine Research (INSTAAR), University of Colorado, Boulder, USA
  • acurrently at: Rijkswaterstaat, Utrecht, Netherlands
  • bcurrently at: University Utrecht, Utrecht, Netherlands

Abstract. Hutton (2016) argued that computational hydrology can only be a proper science if the hydrological community makes sure that hydrological model studies are executed and presented in a reproducible manner. We replied that to achieve this, hydrologists shouldn't ‘re-invent the water wheel’ but rather use existing technology from other fields (such as containers and ESMValTool) and open interfaces (such as BMI) to do their computational science (Hut, 2017). With this paper and the associated release of the eWaterCycle platform and software package1 we are putting our money where our mouth is and provide the hydrological community with a ‘FAIR by design’ platform to do our science.

eWaterCycle is a platform that separates the experiment done on the model from the model code. In eWaterCycle hydrological models are accessed through a common interface (BMI) in Python and run inside of software containers. In this way all models are accessed in a similar manner facilitating easy switching of models, model comparison and model coupling. Currently the following models are available through eWaterCycle: PCR-GLOBWB 2.0, wflow, Hype, LISFLOOD, TopoFlex HBV, MARRMoT and WALRUS. While these models are written in different programming languages they can all be run and interacted with from the Jupyter notebook environment within eWaterCycle. Furthermore, the pre-processing of input data for these models has been streamlined by making use of ESMValTool. Forcing for the models available in eWaterCycle from well known datasets such as ERA5 can be generated with a single line of code. To illustrate the type of research that eWaterCycle facilitates this manuscript includes five case studies: from a simple ‘Hello World’ where only a hydrograph is generated to a complex coupling of models in different languages.

In this manuscript we stipulate the design choices made in building eWaterCycle and provide all the technical details to understand and work with the platform. For system administrators who want to install eWaterCycle on their infrastructure we offer a separate installation guide. For computational hydologist who want to work with eWaterCycle we also provide a video explaining the platform from a users point of view.

With the eWaterCycle platform we are providing the hydrological community with a platform to conduct their research fully compatible with the principles of Open Science as well as FAIR science.

1available on Zenodo: doi.org/10.5281/zenodo.5119389

Rolf Hut et al.

Status: open (until 19 Jan 2022)

Comment types: AC – author | RC – referee | CC – community | EC – editor | CEC – chief editor | : Report abuse

Rolf Hut et al.

Model code and software

eWaterCycle tech paper example notebooks Hut et al. https://doi.org/10.5281/zenodo.5543898

eWaterCycle Python package Verhoeven et al. https://doi.org/10.5281/zenodo.5119389

Video supplement

The eWaterCycle platform for Open and FAIR Hydrological collaboration Video Abstract Rolf Hut https://doi.org/10.5281/zenodo.5556432

Rolf Hut et al.

Viewed

Total article views: 202 (including HTML, PDF, and XML)
HTML PDF XML Total BibTeX EndNote
172 27 3 202 2 1
  • HTML: 172
  • PDF: 27
  • XML: 3
  • Total: 202
  • BibTeX: 2
  • EndNote: 1
Views and downloads (calculated since 24 Nov 2021)
Cumulative views and downloads (calculated since 24 Nov 2021)

Viewed (geographical distribution)

Total article views: 201 (including HTML, PDF, and XML) Thereof 201 with geography defined and 0 with unknown origin.
Country # Views %
  • 1
1
 
 
 
 
Latest update: 29 Nov 2021
Download
Short summary
With the eWaterCycle platform we are providing the hydrological community with a platform to conduct their research fully compatible with the principles of Open Science as well as FAIR science. eWatercyle gives easy access to well known hydrological models, big datasets and example experiments. Using eWaterCycle hydrologists can easily compare the results from different models, couple models and do more complex hydrological computational research.