ESA EarthCARE Satellite Examples¶

These examples configure queries and downloads from the ESA MAAP STAC API for the EarthCARE mission.

EarthCARE: ATLID Atmospheric Lidar¶

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

Downloads EarthCARE Level 1B and Level 2A Lidar profiles for an AERONET Region of Interest:

# ==============================================================================
# ESA EarthCARE — Atmospheric Lidar (ATLID)
# ==============================================================================

source: earthcare

# Collections (ESA MAAP collection IDs)
collections:
  - "EARTHCARE_ATLID_L1B"
  - "EARTHCARE_ATLID_L2A"

# Product Types: 'ATL_NOM_1B', 'ATL_AER_2A', 'ATL_TC__2A', 'ATL_EBD_2A'
product_types:
  - "ATL_NOM_1B"
  - "ATL_AER_2A"
  - "ATL_TC__2A"

start_time: "2024-09-01T00:00:00Z"
end_time: "2024-09-02T23:59:59Z"

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

max_workers: 2
overwrite_cache: false

EarthCARE: CPR Cloud Profiling Radar¶

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

Downloads CPR radar reflectivity profiles (L1B/L2A) and joint ATLID-CPR-MSI synergy products:

# ==============================================================================
# ESA EarthCARE — Cloud Profiling Radar (CPR) & Multi-Instrument Synergy
# ==============================================================================

source: earthcare

collections:
  - "EARTHCARE_CPR_L1B"
  - "EARTHCARE_CPR_L2A"
  - "EARTHCARE_AC_L2A"                 # Joint ATLID + CPR synergy products

product_types:
  - "CPR_NOM_1B"                       # CPR Level 1B calibrated reflectivity
  - "CPR_CLD_2A"                       # CPR Level 2A cloud mask & microphysics
  - "AC__TC__2A"                       # Synergy Target Classification (ATLID+CPR)

start_time: "2024-09-01T00:00:00Z"
end_time: "2024-09-02T23:59:59Z"

bounding_box: [-10.0, 35.0, 5.0, 45.0]

limit: 5
overwrite_cache: false

EarthCARE: MSI Multi-Spectral Imager¶

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

Downloads MSI Top-of-Atmosphere Radiance & Reflectance Level 1C data:

# ==============================================================================
# ESA EarthCARE — Multi-Spectral Imager (MSI) Level 1C / Level 2A
# ==============================================================================

source: earthcare

collections:
  - EARTHCARE_MSI_L1C

product_types:
  - MSI_RGR_1C                         # MSI Top-of-Atmosphere Radiance & Reflectance

start_time: "2025-04-08T00:00:00Z"
end_time: "2025-04-08T23:59:59Z"

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

is_download: true
overwrite_cache: false