Copernicus CDSE Satellites Examples¶

These examples configure queries and downloads from the Copernicus Data Space Ecosystem (CDSE) OData catalogue and S3 bucket interface for Sentinel missions.

Sentinel-2: MSI Level 2A¶

Built-in example: cdse/cdse_sentinel2_msi.yaml
Run directly: gathering run example:cdse/cdse_sentinel2_msi.yaml | Copy locally: gathering examples copy cdse/cdse_sentinel2_msi.yaml .

Demonstrates querying Bottom-Of-Atmosphere (BOA) reflectance S2MSI2A with maximum 20% cloud cover filter and 4-worker parallel downloads:

# ==============================================================================
# Copernicus Data Space Ecosystem (CDSE) — Sentinel-2 MSI (Level 2A & Level 1C)
# ==============================================================================

source: cdse

instrument: MSI
product_type: S2MSI2A                  # Level-2A Bottom-Of-Atmosphere reflectance

start_time: "2024-07-01T00:00:00Z"
end_time: "2024-07-05T23:59:59Z"

grid:
  center_lat_lon: [37.164, -3.605]     # Granada
  size_yx: [100, 100]
  resolution_m: 1000.0
  projection: "latlon"

max_cloud_cover: 20.0                  # Filter granules with <= 20% cloud cover
limit: 3
max_workers: 4                         # Concurrent worker threads for parallel downloads
only_granules_list: true
return_s3_paths: true

Sentinel-3: OLCI & SLSTR¶

Built-in example: cdse/cdse_sentinel3_olci.yaml
Run directly: gathering run example:cdse/cdse_sentinel3_olci.yaml | Copy locally: gathering examples copy cdse/cdse_sentinel3_olci.yaml .

Demonstrates querying Sentinel-3 Ocean & Land Colour Instrument (OL_1_EFR___) and Sea & Land Surface Temperature Radiometer (SL_2_LST___):

# ==============================================================================
# Copernicus Data Space Ecosystem (CDSE) — Sentinel-3 OLCI & SLSTR
# ==============================================================================

logging:
  level: INFO

tasks:
  # Task 1: Sentinel-3 OLCI Top of Atmosphere Full Resolution (Non Time Critical - NTC)
  - source: cdse
    instrument: OLCI
    product_type: OL_1_EFR___
    timeliness: NTC                      # Options: 'NTC', 'NRT', 'STC'
    start_time: "2024-07-01T10:00:00Z"
    end_time: "2024-07-01T12:00:00Z"
    grid:
      site: "Granada"                    # AERONET station (resolved from aeronet_locations_v3.txt)
      size_yx: [100, 100]
      resolution_m: 1000.0
      projection: "latlon"
    limit: 2
    return_s3_paths: true
    only_granules_list: true

  # Task 2: Sentinel-3 SLSTR Land Surface Temperature (Near Real Time - NRT)
  - source: cdse
    instrument: SLSTR
    product_type: SL_2_LST___
    timeliness: NRT                      # Near Real Time
    start_time: "2024-07-01T10:00:00Z"
    end_time: "2024-07-01T12:00:00Z"
    grid:
      site: "El_Arenosillo"              # AERONET station (Huelva, Spain)
      size_yx: [100, 100]
      resolution_m: 1000.0
      projection: "latlon"
    limit: 2
    only_granules_list: true

Sentinel-5P: TROPOMI Offline Trace Gases¶

Built-in example: cdse/cdse_sentinel5p_tropomi.yaml
Run directly: gathering run example:cdse/cdse_sentinel5p_tropomi.yaml | Copy locally: gathering examples copy cdse/cdse_sentinel5p_tropomi.yaml .

Demonstrates querying Sentinel-5P TROPOMI Aerosol Layer Height (AER_LH) and trace gases ($NO_2$, $O_3$, $SO_2$, $CH_4$, $CO$, $HCHO$):

# ==============================================================================
# Copernicus Data Space Ecosystem (CDSE) — Sentinel-5P TROPOMI
# ==============================================================================

source: cdse

instrument: TROPOMI
product_type: AER_LH                   # Or 'TROPOMI_NO2', 'TROPOMI_O3', 'TROPOMI_SO2', etc.

# Timeliness / Processing Mode: 'OFFL' (Offline), 'NRT' (Near Real Time), 'RPRO'
timeliness: OFFL

start_time: "2024-06-15T00:00:00Z"
end_time: "2024-06-15T04:00:00Z"

grid:
  site: "El_Arenosillo"                # Automatically resolved from aeronet_locations_v3.txt
  size_yx: [100, 100]
  resolution_m: 1000.0
  projection: "latlon"

limit: 5
overwrite_cache: false