Add support for ERA5 tiem series from xcube-cds

CHANGES.md

@@ -1,7 +1,10 @@
-## Changes in 0.3.1 (under development)
+## Changes in 0.3.1
 
-* Use `xcube_resampling.gridmapping.GridMapping.regular_from_bbox` to create regular grid-
-  mapping instance from configuration.
+* Use `xcube_resampling.gridmapping.GridMapping.regular_from_bbox` to create regular
+  grid-mapping instance from configuration.
+* Added support for ERA5 time series extraction via the [xcube-cds](github.com/xcube-dev/xcube-cds)
+  data store plugin.
+* Improved documentation by adding a new Data Availability page.
 
 ## Changes in 0.3.0
 

docs/data.md

@@ -0,0 +1,48 @@
+# Data Availability
+
+xcube provides unified access to a wide range of Earth System datasets through its
+**Data Store framework**, exposed via
+[xcube data store plugins](https://xcube.readthedocs.io/en/latest/dataaccess.html#data-store-framework).
+These plugins can be seamlessly integrated into the Multi-Source Data Store.
+
+
+### Public Data Sources
+
+The following data store plugins provide direct access to major Earth observation
+and research data providers.
+
+| Logo | Data Source | Example | Plugin Repository |
+|------|------------|---------|-------------------|
+| ![CDS](assets/cds_logo.png){width="150" .logo-icon-table} | **[Copernicus Climate Data Store (CDS)](https://cds.climate.copernicus.eu/)** | `new_data_store("cds")` | [GitHub](https://github.com/xcube-dev/xcube-cds) |
+| ![CMEMS](assets/cmems_logo.png){width="150" .logo-icon-table} | **[Copernicus Marine Service (CMEMS)](https://marine.copernicus.eu/)** | `new_data_store("cmems")` | [GitHub](https://github.com/xcube-dev/xcube-cmems) |
+| ![CLMS](https://land.copernicus.eu/static/media/ccl-icon-land-text-2.e04af716.svg){width="150" .logo-icon-table} | **[Copernicus Land Monitoring Service (CLMS)](https://land.copernicus.eu/en/dataset-catalog)** | `new_data_store("clms")` | [GitHub](https://github.com/xcube-dev/xcube-clms) |
+| ![EOPF](https://zarr.eopf.copernicus.eu/wp-content/uploads/2026/02/EOPF-on-bright.png){width="150" .logo-icon-table} | **[EOPF Sentinel Zarr Samples](https://zarr.eopf.copernicus.eu/)** | `new_data_store("eopf-zarr")` | [GitHub](https://github.com/EOPF-Sample-Service/xcube-eopf) |
+| ![ESA CCI](https://brand.esa.int/files/2020/05/ESA_logo_2020_Deep-scaled.jpg){width="150" .logo-icon-table} | **[ESA CCI](https://climate.esa.int/en/data/#/dashboard)** | `new_data_store("cciodp")`<br/>`new_data_store("ccizarr")` | [GitHub](https://github.com/xcube-dev/xcube-cci) |
+| ![ESA SMOS](https://www.esa.int/eologos/images/smos.jpg){width="150" .logo-icon-table} | **[ESA SMOS](https://earth.esa.int/eogateway/missions/smos)** | `new_data_store("smos")` | [GitHub](https://github.com/xcube-dev/xcube-smos) |
+| ![ICOS Data Portal](assets/logo_icos.png){width="150" .logo-icon-table} | **[ICOS Data Portal](https://www.icos-cp.eu/data-services)** | `new_data_store("icosdp")` | [GitHub](https://github.com/xcube-dev/xcube-icosdp) |
+| ![GEDI](https://gedi.umd.edu/wp-content/uploads/2020/10/GEDI_16_10.jpg){width="150" .logo-icon-table} | **[Global Ecosystem Dynamics Investigation (GEDI)](https://gedi.umd.edu/)** | `new_data_store("gedi")` | [GitHub](https://github.com/xcube-dev/xcube-gedi) |
+| ![Sentinel Hub](https://www.sentinel-hub.com/img/press/sentinel_hub_by_planet_logo_big.png){width="150" .logo-icon-table} | **[Sentinel Hub](https://www.sentinel-hub.com/)** | `new_data_store("sentinelhub")` | [GitHub](https://github.com/xcube-dev/xcube-sh) |
+| ![STAC](https://stacspec.org/public/images-original/STAC-04.png){width="150" .logo-icon-table} | **[SpatioTemporal Asset Catalog (STAC)](https://stacspec.org/en/about/datasets/)** | `new_data_store("stac")`| [GitHub](https://github.com/xcube-dev/xcube-stac) |
+| ![Zenodo](https://about.zenodo.org/static/img/logos/zenodo-black-border.svg){width="150" .logo-icon-table} | **[Zenodo](https://zenodo.org/)** | `new_data_store("zenodo")` | [GitHub](https://github.com/xcube-dev/xcube-zenodo) |
+
+Each plugin repository contains usage examples and documentation specific to the
+respective data provider.
+
+### Bring Your Own Data
+
+In addition to public data services, xcube allows you to integrate your own datasets
+into the same framework. The built-in [filesystem-based data stores](https://xcube.readthedocs.io/en/latest/dataaccess.html#filesystem-based-data-stores)
+enable access to:
+
+- Local datasets via `"file"`
+- Private S3 buckets via `"s3"`
+
+This allows you to seamlessly combine external services and private datasets within
+the xcube Multi-Source Data Store.
+
+### Learn More
+
+To configure and explore available datasets:
+
+- See the [Setup Configuration YAML example](examples/setup_config.ipynb)
+- Explore the [Python API documentation](api.md)

docs/examples/example4/scs4_modify_dataset.py

@@ -1,4 +1,3 @@
-import numpy as np
 import xarray as xr
 
 

examples/example1/scs1_config.yml

@@ -1,6 +1,6 @@
 datasets:
 - identifier: AU-Dry_sen2
-  store: stac-cdse
+  store: stac-pc
   data_id: sentinel-2-l2a
   open_params:
     time_range: &id001
@@ -25,26 +25,25 @@ datasets:
     - B11
     - B12
     - SCL
-- identifier: AU-Dry_era5land
+- identifier: AU-Dry_era5
   store: cds
-  data_id: reanalysis-era5-land
+  data_id: reanalysis-era5-single-levels-timeseries
   open_params:
     variable_names:
     - 2m_temperature
-    - total_precipitation
+    - 2m_dewpoint_temperature
     time_range: *id001
-    point:
+    location:
     - 132.3706
     - -15.2588
-    spatial_res: 0.1
 - identifier: AU-Dry_ccibiomass
   store: esa_cci
   grid_mapping: AU-Dry_sen2
   data_id: esacci.BIOMASS.yr.L4.AGB.multi-sensor.multi-platform.MERGED.5-0.100m
   open_params:
     time_range: *id001
 - identifier: AU-How_sen2
-  store: stac-cdse
+  store: stac-pc
   data_id: sentinel-2-l2a
   open_params:
     time_range: *id001
@@ -67,18 +66,17 @@ datasets:
     - B11
     - B12
     - SCL
-- identifier: AU-How_era5land
+- identifier: AU-How_era5
   store: cds
-  data_id: reanalysis-era5-land
+  data_id: reanalysis-era5-single-levels-timeseries
   open_params:
     variable_names:
     - 2m_temperature
-    - total_precipitation
+    - 2m_dewpoint_temperature
     time_range: *id001
-    point:
+    location:
     - 131.1523
     - -12.4943
-    spatial_res: 0.1
 - identifier: AU-How_ccibiomass
   store: esa_cci
   grid_mapping: AU-How_sen2
@@ -92,11 +90,8 @@ data_stores:
     root: data
 - identifier: esa_cci
   store_id: cciodp
-- identifier: stac-cdse
-  store_id: stac-cdse-ardc
-  store_params:
-    key: <CDSE_S3_key>
-    secret: <CDSE_S3_secret>
+- identifier: stac-pc
+  store_id: stac-pc-ardc
 - identifier: cds
   store_id: cds
   store_params: