DOI: 10.5281/zenodo.8121208
title: ben-ge-8k: BigEarthNet Extended with Geographical and Environmental Data

description: <strong>ben-ge-8k: BigEarthNet Extended with Geographical and Environmental Data</strong><br> M. Mommert, N. Kesseli, J. Hanna, L. Scheibenreif, D. Borth, B. Demir, "ben-ge: Extending BigEarthNet with Geographical and Environmental Data", IEEE International Geoscience and Remote Sensing Symposium, Pasadena, USA, 2023. ben-ge-8k is a small-scale multimodal dataset for Earth observation that is a subset of the ben-ge dataset (https://github.com/HSG-AIML/ben-ge), which in turn serves as an extension to the BigEarthNet dataset. ben-ge complements the Sentinel-1/2 data contained in BigEarthNet by providing additional data modalities: * elevation data extracted from the Copernicus Digital Elevation Model GLO-30;<br> * land-use/land-cover data extracted from ESA Worldcover;<br> * climate zone information extracted from Beck et al. 2018;<br> * environmental data concurrent with the Sentinel-1/2 observations from the ERA-5 global reanalysis;<br> * a seasonal encoding. ben-ge-8k contains 8000 patches out of 590,326 patches in the full ben-ge dataset. These 8000 patches were sampled in such a way that for each of the 8 most common ESA WorldCover land-use/land-cover classes (tree cover, shrubland, grassland, cropland, built-up, bare/sparse vegetation, permanent water bodies, herbaceous wetland), we sampled 1000 patches randomly and used the fractional coverage of this class as a weight in the sampling process. As a result, these classes are slightly more balanced in ben-ge-8k than in the full dataset. <br> <strong>Data Modalities and Products</strong> <br> <strong>Meta Data</strong> Relevant meta data for the ben-ge-8k dataset are compiled in the file ben-ge-8k_meta.csv. This file resides on the root level of this archive and contains the following data for each patch:<br> * patch_id: the Sentinel-2 patch id, which plays a central role for cross-referencing different data modalities for individual patches;<br> * patch_id_s1: the Sentinel-1 patch id for this specific patch;<br> * timestamp_s2: the timestamp for the Sentinel-2 observation;<br> * timestamp_s1: the timestamp for the Sentinel-1 observation;<br> * season_s2: the seasonal encoding (see below) for the time of the Sentinel-2 observation;<br> * season_s1: the seasonal encoding (see below) for the time of the Sentinel-1 observation;<br> * lon: longitude (WGS-84) of the center of the patch [degrees];<br> * lat: latitude (WGS-84) of the center of the patch [degrees];<br> * climatezone: integer value indicating the climate zone based on Beck et al. 2018 (see below for details). <br> <strong>Digital Elevation Model (Copernicus DEM GLO-30)</strong> DEM data are contained in the dem/ directory of this archive. Topographic maps are generated based on the global Copernicus Digital Elevation Model (GLO-30) (https://spacedata.copernicus.eu/collections/copernicus-digital-elevation-model). Relevant GLO-30 map tiles from the 2021 data release were downloaded through AWS (https://registry.opendata.aws/copernicus-dem/), reprojected into the coordinate frame of the corresponding Sentinel-1/2 patches and interpolated with bilinear resampling to 10 m resolution on the ground. Elevation data are provided in a separate geotiff file for each patch. The naming convention for these files uses the Sentinel-2 patch_id to which we append _dem.tif. Each file contains a single band with 16-bit integer values that refer to the elevation of that pixel over sea level. <br> <strong>Land-use/Land-cover Data (ESA WorldCover)</strong> Land-use/land-cover data are contained in the esaworldcover/ directory of this archive. Land-use/land-cover map tiles matching the Sentinel-1/2 patches were extracted from ESA WorldCover (https://esa-worldcover.org). Relevant tiles were downloaded and reprojected into the coordinate frame of the corresponding Sentinel-1/2 patches. WorldCover data are available both as maps and as class fractions that are aggregated over each patch. Land-use/land-cover map data are provided in a separate geotiff file for each patch. The naming convention for these files uses the Sentinel-2 patch_id to which we append _esaworldcover.tif. Each file contains a single band with 8-bit integer values that map to land-use/land-cover definitions provided by the ESA WorldCover Product User Manual (https://esa-worldcover.s3.eu-central-1.amazonaws.com/v200/2021/docs/WorldCover_PUM_V2.0.pdf) (page 15). The file ben-ge-8k_esaworldcover.csv contains the fractions by which each of the different classes cover the corresponding patch. This product may be useful to generate single-label or multi-label targets for different classification setups. <br> <strong>Environmental Data (ERA-5)</strong> Weather data are contained in the ben-ge-8k_era-5.csv file. Weather data at the time of observation (temperature at 2 m above the ground, relative humidity, wind vectors at 10 m above the ground) are extracted from the ERA-5 global reanalysis (https://cds.climate.copernicus.eu/cdsapp#!/dataset/reanalysis-era5-pressure-levels) for the pressure level at the mean elevation of the observed scene and the time of observation (separately queried for Sentinel-1/2 observations). Environmental data are available in the file ben-ge-8k_era-5.csv. For each patch, identified through the Sentinel-2 patch_id or the corresponding Sentinel-1 patch id patch_id_s1, the file contains the following parameters:<br> * atmpressure_level: atmospheric pressure level at which parameters have been queried [mbar]<br> * temperature_s2: temperature 2m above ground at the time of the Sentinel-2 observation [K]<br> * temperature_s1: temperature 2m above ground at the time of the Sentinel-1 observation [K]<br> * wind-u_s2: eastward component of the wind, at a height of 10 meters above the surface of the Earth at the time of the Sentinel-2 observation [m/s]<br> * wind-u_s1: eastward component of the wind, at a height of 10 meters above the surface of the Earth at the time of the Sentinel-1 observation [m/s]<br> * wind-v_s2: northward component of the wind, at a height of 10 meters above the surface of the Earth at the time of the Sentinel-2 observation [m/s]<br> * wind-v_s1: northward component of the wind, at a height of 10 meters above the surface of the Earth at the time of the Sentinel-2 observation [m/s]<br> * relhumidity_s2: relative humidity at the time of the Sentinel-2 observation [%]<br> * relhumidity_s1: relative humidity at the time of the Sentinel-1 observation [%] as extracted from the ERA-5 global reanalysis (https://cds.climate.copernicus.eu/cdsapp#!/dataset/reanalysis-era5-pressure-levels) for the patch location. Please see the corresponding documentation for details. <br> <strong>Seasonal Encoding</strong><br> To capture the season at the time of observation, we apply a non-linear encoding that scale the date of the observation into the interval [0, 1], referring to [winter, summer] solstice. For any given date, we derive the fractional year and shift it by 9 days such that 21 June has the fractional year 0.5 and 22 December has the fractional year 0 or 1. To account for this ambiguity and the periodicity of the seasons, we modulate the fractional year with a sine function such that 21 June leads to a seasonal encoding of 1 and 22 December leads to a seasonal encoding of 0. Seasonal encodings are provided by the column season in the ben-ge-8k_meta.csv file. Season values cover the interval [0,1] as a continuous variable where 1 refers to summer solstice and 0 refers to winter solstice. <br> <strong>Climate zone classification (Beck et al. 2018)</strong> Patch-based climate zone classifications, based on the Köppen-Geiger scheme, were extracted from Beck et al. (2018) (https://www.nature.com/articles/sdata2018214), utilizing their present-day 1-km resolution map. Due to geographical focus of BigEarthNet on Europe, only 11 out of 27 different classes are present in this dataset. Please note that patches that are fully covered by surface water have no climate zone class assigned to them (class label equals zero in this case). Labels are encoded as discrete integer values that follow the schema introduced by Beck et al. 2018 in their legend.txt file that is included here: https://doi.org/10.6084/m9.figshare.6396959. Climate zone classification labels are provided by the column climatezone in the ben-ge-8k_meta.csv file. <br> <strong>File and directory structure</strong> This archive contains the following directory and file structure: |<br> |--- README (this file)<br> |--- ben-ge-8k_meta.csv (ben-ge-8k meta data)<br> |--- ben-ge-8k_era-5.csv (ben-ge-8k environmental data)<br> |--- ben-ge-8k_esaworldcover.csv (patch-wise ben-ge-8k land-use/land-cover data)<br> |--- dem/ (digital elevation model data)<br> | |--- S2A_MSIL2A_20171208T093351_3_82_dem.tif<br> | ...<br> |--- esaworldcover/ (land-use/land-cover data)<br> | |--- S2B_MSIL2A_20170914T93030_26_83_esaworldcover.tif<br> | ...<br> |--- sentinel-1/ (Sentinel-1 SAR data)<br> | |--- S1A_IW_GRDH_1SDV_20180219T063851_29UPV_70_43/<br> | |--- S1A_IW_GRDH_1SDV_20180219T063851_29UPV_70_43_labels_metadata.json (BigEarthNet label file)<br> | |--- S1A_IW_GRDH_1SDV_20180219T063851_29UPV_70_43_VH.tif (BigEarthNet/Sentinel-1 VH polarization data)<br> | |--- S1A_IW_GRDH_1SDV_20180219T063851_29UPV_70_43_VV.tif (BigEarthNet/Sentinel-1 VV polarization data)<br> | ...<br> |--- sentinel-2/ (Sentinel-2 multispectral data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83/<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B01.tif (BigEarthNet/Sentinel-2 Band 1 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B02.tif (BigEarthNet/Sentinel-2 Band 2 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B03.tif (BigEarthNet/Sentinel-2 Band 3 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B04.tif (BigEarthNet/Sentinel-2 Band 4 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B05.tif (BigEarthNet/Sentinel-2 Band 5 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B06.tif (BigEarthNet/Sentinel-2 Band 6 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B07.tif (BigEarthNet/Sentinel-2 Band 7 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B08.tif (BigEarthNet/Sentinel-2 Band 8 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B09.tif (BigEarthNet/Sentinel-2 Band 9 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B11.tif (BigEarthNet/Sentinel-2 Band 11 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B12.tif (BigEarthNet/Sentinel-2 Band 12 data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_B8A.tif (BigEarthNet/Sentinel-2 Band 8A data)<br> | |--- S2B_MSIL2A_20170818T112109_31_83_labels_metadata.json (BigEarthNet label file)<br> | ...<br> |--- splits/<br> |--- ben-ge-8k_test.csv (index file for test split, 10%)<br> |--- ben-ge-8k_validation.csv (index file for validation split, 10%)<br> |--- ben-ge-8k_train.csv (index file for training splits, 80%) Once unpacked, ben-ge-8k requires 4.2 GB of space. <br> <strong>More Information</strong> For more information, please refer to https://github.com/HSG-AIML/ben-ge. <br> <strong>Citing ben-ge-8k</strong><br> If you use data contained in this archive, please cite the following two papers: M. Mommert, N. Kesseli, J. Hanna, L. Scheibenreif, D. Borth, B. Demir, "ben-ge: Extending BigEarthNet with Geographical and Environmental Data", IEEE International Geoscience and Remote Sensing Symposium, Pasadena, USA, 2023. G. Sumbul, A. d. Wall, T. Kreuziger, F. Marcelino, H. Costa, P. Benevides, M. Caetano, B. Demir, V. Markl, "BigEarthNet-MM: A Large Scale Multi-Modal Multi-Label Benchmark Archive for Remote Sensing Image Classification and Retrieval", IEEE Geoscience and Remote Sensing Magazine, 2021, doi: 10.1109/MGRS.2021.3089174.