GENERAL INFORMATION 

G01. Dataset version 1.1.0 

G02. Name of the dataset: LISFLOOD static and parameter maps for GloFAS

G03. Description of the dataset: gridded input maps (except for the meteorological forcings) that are required to run the spatially distributed hydrological model LISFLOOD at the global scale. Details on the open-source hydrological model LISFLOOD can be found here: https://ec-jrc.github.io/lisflood/. The LISFLOOD static maps for GloFAS have been derived using a variety of different data sources and have a spatial resolution of 3 arcmin (approx. 5.7 km at the Equator). A detailed description of how the maps have been derived can be found here: https://ec-jrc.github.io/lisflood-code/4_Static-Maps-introduction/.Important  note for version 1.0: this version does not yet include the calibrated parameter maps.

G04. Creator of data set: Copernicus Emergency Management Service

G05. DOI of dataset: N/A

G06. PID of dataset: http://data.europa.eu/89h/68050d73-9c06-499c-a441-dc5053cb0c86

G07. Keywords (author defined): floods, global, GloFAS, hydrology, droughts, modeling

G08. Language(s) used in the dataset: English

G09. Last update of the README file: 09.04.2024



DATA DESCRIPTION

D01. Horizontal coverage: Global (-180, 180; -90, 90)

D02. Horizontal resolution:  3 arcmin (0.05 degrees)

D03. Spatial gaps: Oceans and Antartica are not covered by this dataset

D04. Temporal coverage:
     - 90 time-invariant surface fields;
     - 3 surface fields with intra-annual variability (reference year: 2015);
     - 2 surface fields with intra and inter-annual variability (coverage from 1979-01-01 to 2019-12-31);
     - 2 surface fields with inter-annual variability (coverage from 1979-01-01 to 2019-12-31).
 
D05. Temporal resolution:
     - 10 days frequency for the 3 variables with intra-annual variability;
     - monthly frequency for the 2 variables with intra and inter-annual variability;
     - annual frequency for the 2 variables with inter-annual variability.

D06. Number of available surface fields: 97, broadly classified according to the following categories: main (3), catchments morphology and river network (14), land use (7), vegetation properties (18), soil properties (29), lakes  and reservoirs (3), water demand (9), GloFASv4.0_calibrated_parameters (14).

D07. Number of available ancillary data in text format: 12 files providing metadata and information about lakes and reseirvois.

D08. Units: the units of each variable are specified below.

D09. Update frequency: irregular.

D10. Projection: wgs_1984

D11. Data type: 3 arcmin (0.05 degrees) grid



PROJECT INFORMATION

P01. Project information: the dataset "LISFLOOD global static and parameter maps for GloFAS" developed as part of the Global Flood Awareness System of the Copernicus Emergency Management Service.

P02. Project website: https://www.globalfloods.eu/

P03. Project funder: European Union



FILE OVERVIEW

F01. Number of files described by the README-file:
     - 97 surface fields grouped thematically in 8 sub-folders.
     - 12 files in text format included in 1 sub-folder.

F02. Organization of the files into sub-folders.
     The 8 sub-folders are:
     - Main (3 files)
     - Catchment_morphology_and_river_network (14 files)
     - Land_use (7 files)
     - Vegetation_properties (18 files)
     - Soil_properties (29 files)
     - Lakes_Reservoirs_ID_tables (15 files)
     - Water_demand (9 files)
     - GloFASv4.0_calibrated_parameters (14 files)

F03. Naming conventions for file names/explanation of abbreviations: LC = land cover type forest (f), irrigated (i), other (o). S = rice growing season (1,2,3). D = surface (1), middle (2), bottom (3) soil layers.

F04. Description of the files in each subfolder.

F04.1 Folder "Main" (3 surface fields):
     - template_Global_03min.nc (boolean map that identifies the cells included in the global domain, -);
     - pixleng_Global_03min.nc (grid-cell length along the latitude, m);
     - pixarea_Global_03min.nc (grid-cell area, m2).

F04.2 Folder "Catchment_morphology_and_river_network" (14 surface fields):
     - ldd_repaired.nc (local drainage direction, units:  - );
     - elv_Global_03min.nc (elevation, m.a.s.l.);
     - elvstd_Global_03min.nc (standard deviation of elevation, m);
     - gradient_Global_03min.nc (slope gradient assigned to upstream cell, m/m);
     - upArea_repaired.nc (accumulated area of all upstream hydrologically connected pixels, m2);
     - chan_Global_03min.nc (boolean map that identifies the channel grid-cells, -);
     - chanbnkf_Global_03min.nc (channel bankfull depth, m);
     - chanflpn_Global_03min.nc (width of the floodplain, m);
     - changrad_Global_03min.nc (channel longitudinal gradient, m/m);
     - chanlength_Global_03min.nc (channel length within a pixel, m);
     - chanman_Global_03min.nc (channel Manning's roughness coefficient, m^(1/3)s^(-1));
     - chans_Global_03min.nc (channel side slope, m/m);
     - chanbw_Global_03min.nc (channel bottom width, m):
     - outlets_Global_03min_JRC5440final.nc (identifiers of outlet points, as indicated in GloFAS reporting points layer, -).

F04.3 Folder "Land_use" (7 surface fields):
     - fracforest_Global_03min.nc (fraction of forest for each grid-cell, -);
     - fracirrigated_Global_03min.nc (fraction of irrigated crops [except rice] for each grid-cell, -);
     - fracrice_Global_03min.nc (fraction of rice crops for each grid-cell, -);
     - fracsealed_Global_03min.nc (fraction of urban area for each grid-cell, -);
     - fracwater_Global_03min.nc (fraction of inland water for each grid-cell, -);
     - fracother_Global_03min.nc (fraction of other land cover for each grid-cell, -);
     - lusemask_Global_03min.nc (boolean map: pixels with value 1 are included the modelled domain, -).


F04.4 Folder "Vegetation_properties" (18 surface fields):
     USED ACRONYMS:  LC (land cover) = f (forest), i (irrigated), o (other). S(season) = 1,2,3.
     - cropcoef_LC_Global_03min.nc (crop coefficient for land cover LC, averaged by time and ecosystem type, -);
     - cropgrpn_LC_Global_03min.nc (crop group number for land cover LC, averaged by time and ecosystem type, -);
     - riceplantingdayS_Global_03min.nc (map with calendar day of the start of the rice planting for season S, -);
     - riceharvestdayS_Global_03min.nc (map with calendar day number of the start date of the rice harvest for season S, -);
     - mannings_LC_Global_03min.nc (Manning's roughness coefficient for land cover LC, m^(1/3)s^(-1);
     - laiLC.nc (10-day average Leaf Area Index for land cover LC, where LC fraction per grid-cell is larger or equal to 0.7, m2/m2).

F04.5 Folder "Soil_properties" (29 surface fields):
     USED ACRONYMS: LC (land cover) = f (forest), i (irrigated), o (other). D (soil layer) = 1 (surface), 2(middle), 3 (bottom).
     - genuaD_LC_Global_03min.nc (Van Genuchten parameter alpha for soil layer D and land cover LC, cm^-1);
     - ksatD_LC_Global_03min.nc (saturated hydraulic conductivity for soil layer D and land cover LC, mm/day);
     - lambdaD_LC_Global_03min.nc (pore size index for soil layer D and land cover LC, -);
     - soildepthD_LC_Global_03min.nc (thickness of soil layer D for land cover LC, mm);
     - thetasD_LC_Global_03min.nc (saturated volumetric soil moisture content of soil layer D for land cover LC, m3/m3);
     - thetarD_Global_03min.nc (residual volumetric soil moisture content of soil layer D, m3/m3).

F04.6 Folder "Lakes_Reservoirs_ID_tables" (15 files: 3 surface fields, 12 text files):
     - lakemask_Global_03min.nc (boolean map of the footprint of lakes, -, values: 0 or 1);
     - 20220802_lakes_Global_03min.nc (lakes outflow location: lakes ID number as shown in the lookup table);
     - GLOFAS_HRES_lakes_metadata.csv (lakes lookup table);
     - 20220802_reservoirs_Global_03min.nc (reservoirs outflow location: reservoirs ID number as shown in the lookup table);
     - GLOFAS_HRES_reservoirs_metadata.csv (reservoirs lookup table);
     - lakea_463_RW_F.txt (lakes parameter, m/s);
     - lakearea_463.txt (lakes surface area, m2);
     - lakeavinflow_463.txt (lakes net inflow, m3/s);
     - rstor_687.txt (reservoirs storage capacity, m3);
     - rnlim_687_67th.txt (reservoirs normal storage limit, -);
     - rflim_687_97th (reservoirs flood storage limit, -);
     - rclim_687.txt (reservoirs conservative storage limit, -);
     - rnormq_687_50th.txt (reservoirs normal outflow, m3/s);
     - rndq_687_97th.txt (reservoirs non-damaging outflow, m3/s);
     - rminq_687_5th.txt (reservoirs minimum outflow, m3/s).

F04.7 Folder "Water_demand" (9 surface fields), 1 map per month from 01/01/1979 to 31/12/2019, mm/day:
     - dom.nc (Water demand per pixel for domestic use);
     - ene.nc (Water demand per pixel for energy use);
     - ind.nc (Water demand per pixel for industrial use);
     - liv.nc (Water demand per pixel for livestock use)
     - gwbodies_Global_03min.nc (boolean map indicating exploitable groundwater resources, -);
     - fracgwused_Global_03min.nc (groundwater used fraction of a pixel, -);
     - energyconsumptiveuse_Global_03min.nc (consumptive use for energy water use, defined as 1-Recycling Ratio, -);
     - fracncused_Global_03min.nc (fraction of water demand allocated to non-conventional sources, e.g. desalination plants, -);
     - waterregion_calpoints_regionalizedcatchments_GloFASv40.nc (identifiers of the areas icluding the locations of water demand and abstraction, -. This map is consistent with the calibration points, as exaplained here https://ec-jrc.github.io/lisflood-model/2_18_stdLISFLOOD_water-use/).

F04.8 Folder "GloFASv4.0_calibrated_parameters" (14 surface fields): calibrated parameters for GloFASv4.0. Please refer to https://confluence.ecmwf.int/display/CEMS/GloFAS+v4.0 for a complete documentation about calibration methodology, data, and results.
     - SnowMeltCoef_GloFASv40.nc (snow melt rate in degree day model equation, mm/(C day));
     - b_Xinanjiang_GloFASv40.nc (exponent in Xinanjiang equation for infiltration capacity of the soil, -);
     - PowerPrefFlow_GloFASv40.nc (exponent in the empirical function describing the preferential flow, i.e. flow that bypasses the soil matrix and drains directly to the groundwater, -);
     - UpperZoneTimeConstant_GloFASv40.nc (time constant for upper groundwater zone, days);
     - GwPercValue_GloFASv40.nc (maximum percolation rate from upper to lower groundwater zone, mm/day);
     - LowerZoneTimeConstant_GloFASv40.nc (time constant for lower groundwater zone, days);
     - LZThreshold_GloFASv40.nc (threshold to stop outflow from lower groundwater zone to the channel, mm);
     - GwLoss_GloFASv40.nc (maximum loss out of lower groundwater zone expressed as a fraction of lower zone outflow, mm/day);
     - QSplitMult_GloFASv40.nc (multiplier to adjust discharge triggering floodplain flow, -);
     - CalChanMan1_GloFASv40.nc (multiplier for Manning's roughness coefficient for riverbed, -);
     - CalChanMan2_GloFASv40.nc (multiplier for Manning's roughness coefficient for floodplains, -);
     - adjust_Normal_Flood_GloFASv40.nc (multiplier to adjust reservoir normal filling: balance between lower and upper limit of reservoir filling, -);
     - ReservoirRnormqMult_GloFASv40.nc (multiplier to adjust normal reservoir outflow, -);
     - LakeMultiplier_GloFASv40.nc (multiplier to adjust lake outflow, -).

F05. File formats: netCDF (CF-1.6 compliant)

F06. Software necessary to open the file: any software that opens netCDF, e.g. ArcGIS, QGIS, Panoply, Python, R, etc.



STORAGE INFORMATION

S01. Where are the data stored?: https://jeodpp.jrc.ec.europa.eu/ftp/jrc-opendata/CEMS-GLOFAS/



METHODOLOGICAL INFORMATION

M01. Date (beginning-end) of data collection and generation: 2019-2020 (version 1.0)

M02. Aim for which the dataset was prepared: to provide the open-source hydrological model LISFLOOD used in GloFAS with up-to-date information on the morphological, land cover and use, soil, and water use features of catchments worldwide. This information is necessary to set-up the open-source hydrological model LISFLOOD (https://ec-jrc.github.io/lisflood/)

M03. Data collection details are explained here https://ec-jrc.github.io/lisflood-code/4_Static-Maps-introduction/

M04. Information about data processing methods: see reference publication R01 and https://ec-jrc.github.io/lisflood-code/4_Static-Maps-introduction/

M05. Quality assurance procedures: see reference publication R01

M06. Information about limitations of the dataset, information that ensures correct interpretation of the dataset: see reference publication R01



DATA ACCESS AND SHARING

A01. Citation for the dataset: Margarita Choulga; Hylke Beck; Francesca Moschini; Cinzia Mazzetti; Juliana Disperati; Stefania Grimaldi; Peter Salamon; Christel Prudhomme (2023): LISFLOOD static and parameter maps for GloFAS. European Commission, Joint Research Centre (JRC) [Dataset] PID: http://data.europa.eu/89h/68050d73-9c06-499c-a441-dc5053cb0c86

A02. License information, restrictions on use: European Commission reuse notice ( https://data.jrc.ec.europa.eu/licence/com_reuse ) , no limitations

A03. Copyright statement: https://jeodpp.jrc.ec.europa.eu/ftp/jrc-opendata/CEMS-EFAS/copyright.txt

A04. User support service: contact person outlined in the JRC Data Catalogue OR contact info@globalfloods.eu



RELATIONSHIPS

R01. Choulga, M., Moschini, F., Mazzetti, C., Grimaldi, S., Disperati, J., Beck, H., Salamon, P., and Prudhomme, C.: Technical note: Surface fields for global environmental modelling, EGUsphere [preprint], https://doi.org/10.5194/egusphere-2023-1306, 2023.

R02. This dataset was prepared using a variety of other datasets: the external datasets used to prepare each file is listed here https://ec-jrc.github.io/lisflood-code/4_Static-Maps-introduction/.

R03. Lakes and reservoirs data and parameterization: Zuzanna Zajac, Beatriz Revilla-Romero, Peter Salamon, Peter Burek, Feyera A. Hirpa, Hylke Beck, The impact of lake and reservoir parameterization on global streamflow simulation, Journal of Hydrology, Volume 548, 2017, Pages 552-568, ISSN 0022-1694, https://doi.org/10.1016/j.jhydrol.2017.03.022.