README for dataset: 4DHydro Benchmark Dataset wflow_sbm

##############################
# Contact information
##############################
Authors: Imhoff, R.O. & A.H. Weerts
Affiliation: Operational Water Management & Early Warning, Department of Inland Water Systems, Deltares, Delft, The Netherlands

Corresponding author: Imhoff, R. (Ruben)
Ruben.Imhoff@deltares.nl

Corresponding author: Weerts, A. (Albrecht)
Albrecht.Weerts@deltares.nl

##############################
# General dataset information
##############################
This readme.txt file describes the contents of the data package associated with the 4DHydro project (https://www.ufz.de/index.php?en=50452) working package 2. 4DHydro working package 2 is dedicated to provided a set of land-surface and hydrological model community reference outputs. The community reference outputs are a set of hydrological simulation outputs from various land-surface and hydrological models from previous studies. Therefore, these outputs represent the current state-of-the-art in hydrological modeling (i.e. before the improvements made in this project) and are used as a baseline reference for the rest of the project.

This datapackage contains the outputs for the wflow_sbm hydrological model (van Verseveld et al., 2022; https://www.deltares.nl/en/software-and-data/products/wflow), which was developed at Deltares, for the test period 1990 - 2021 for the 4DHydro benchmark regions Europe, Rhine, Po and Tugela. The output consists of the model variables discharge, soil moisture and evapotranspiration for these regions (for region Europe only discharge). See https://opensciencedata.4dhydro.eu/ for a STAC catalog with links to outputs from other models. Outputs are formatted according to the 4dHydro working package 2 storage protocol.

For more information about the model derivation and setup, we refer the reader to the references below. 


##############################
# File type
##############################
netCDF-4 (.nc), and stored as a zipped file per region (Europe, Rhine, Po and Tugela), variable (soil moisture, discharge and evapotranspiration) and month.
Note that the NetCDF-4 files also contain their own meta-information, which can be accessed using, for example, ncdump (www.bic.mni.mcgill.ca/users/sean/Docs/netcdf/guide.txn_79.html).


##############################
# Data specific information
##############################
Data type: Float
Dimensions: time, latitude, longitude
Spatial resolution: 1 km (30 arcseconds)
Temporal resolution: daily
Temporal coverage: 1990 - 2021
Projection: WGS84

Folder Structure
================
Each subfolder contains the data for a different region extent (Europe, Rhine, Po and Tugela). 

wflowsbm_era5_europe_30sec
- Number of rows: 6360
- Number of columns: 4800
- Extent in lat-lon: 86, -11 [ULC]; 86, 29 [URC]; 33, -11 [LLC]; 33, 29 [LRC]
wflowsbm_era5_rhine_30sec
- Number of rows: 840
- Number of columns: 1200
- Extent in lat-lon: 53, 3 [ULC]; 53, 13 [URC]; 46, 3 [LLC]; 46, 13 [LRC]
wflowsbm_era5_po_30sec
- Number of rows: 480
- Number of columns: 840
- Extent in lat-lon: 47, 6 [ULC]; 47, 13 [URC]; 13, 6 [LLC]; 43, 13 [LRC]
wflowsbm_era5_tugela_30sec
- Number of rows: 480
- Number of columns: 360
- Extent in lat-lon: -26, 28 [ULC]; -26, 31 [URC]; -30, 28 [LLC]; -30, 31 [LRC]

Folder contents
===============
The folders contain the wflow_sbm model outputs (discharge, evapotranspiration and soil moisture). For the region Europe only discharge has been stored. Furhtermore, all folders contain the simulation mask for the river catchment and the catchment upstream area for each cell.

Variables and units: 
====================
Output variables were abbreviated in the outputs.

name	description					units
q		discharge					m3 s-1
et		evapotranspiration			kg m-2 s-1
sm		soil moisture				volumetric %
mask	catchment mask				0 or 1
uparea	catchment upstream area		m2


##############################
# License
##############################
CC BY-NC 4.0


##############################
# References
##############################
- van Verseveld, W. J., Weerts, A. H., Visser, M., Buitink, J., Imhoff, R. O., Boisgontier, H., Bouaziz, L., Eilander, D., Hegnauer, M., ten Velden, C., and Russell, B. (2022). Wflow_sbm v0.6.1, a spatially distributed hydrologic model: from global data to local applications. Geoscientific Model Development Discussions. https://doi.org/10.5194/gmd-2022-182, in review.  
- Imhoff, R. O., van Verseveld, W. J., van Osnabrugge, B., and Weerts, A. H. (2020). Scaling point-scale (pedo) transfer functions to seamless large-domain parameter estimates for high-resolution distributed hydrologic modeling: An example for the Rhine River. Water Resources Research, 56, e2019WR026807. https://doi.org/10.1029/2019WR026807  
- Eilander, D., van Verseveld, W., Yamazaki, D., Weerts, A., Winsemius, H. C., and Ward, P. J. (2021). A hydrography upscaling method for scale-invariant parametrization of distributed hydrological models. Hydrology and Earth System Sciences, 25, 5287–5313, https://doi.org/10.5194/hess-25-5287-2021 
- Eilander, D., Boisgontier, H., Bouaziz, L. J. E., Buitink, J., Couasnon A., Dalmijn, B., Hegnauer, M., de Jong, T., Loos, S., Marth, I., and van Verseveld, W. (2023). HydroMT: Automated and reproducible model building and analysis. Journal of Open Source Software, 8(83), 4897. https://doi.org/10.21105/joss.04897