NASA Satellites Examples¶

These examples configure automated downloads from NASA Earthdata / CMR for MODIS and PACE satellite instruments.

MODIS: Terra Aerosol (MOD04_L2)¶

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

Queries NASA CMR for Terra MODIS MOD04_L2 aerosol optical depth products (10km / 3km) centered on the Granada AERONET station with 4-thread parallel downloads:

# ==============================================================================
# NASA MODIS — Terra Level-2 Atmospheric Aerosol (MOD04_L2)
# ==============================================================================

source: modis

# Satellite platform: 'Terra', 'Aqua', or 'Combined'
satellite: Terra

# Product type (e.g. 'MOD04_L2', 'MOD06_L2', 'MOD05_L2', 'MOD021KM')
product_type: MOD04_L2

# MODIS Collection Version (default '61' for Collection 6.1)
collection_version: "61"

# Day/Night orbit filter: 'DAY', 'NIGHT', or 'BOTH'
day_night_flag: DAY

# Observation time range (ISO 8601 UTC)
start_time: "2024-07-01T10:00:00Z"
end_time: "2024-07-01T14:00:00Z"

# Spatial Region of Interest (Grid) resolved from AERONET station
grid:
  site: "Granada"                      # Automatically resolved from aeronet_locations_v3.txt
  size_yx: [100, 100]
  resolution_m: 10000.0
  projection: "latlon"

limit: 2
max_workers: 4                         # Number of concurrent download worker threads

only_granules_list: false
return_s3_paths: false
overwrite_cache: false

MODIS: MAIAC 1km Land AOD (MCD19A2)¶

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

Combined Terra+Aqua joint inversion for high-resolution 1 km daily Aerosol Optical Depth:

# ==============================================================================
# NASA MODIS — MAIAC Land Aerosol Optical Depth 1km Gridded Daily (MCD19A2)
# ==============================================================================

source: modis

satellite: Combined
product_type: MCD19A2
collection_version: "61"

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

grid:
  site: "Granada"
  size_yx: [100, 100]
  resolution_m: 1000.0
  projection: "latlon"

limit: 3
only_granules_list: false
return_s3_paths: false
overwrite_cache: false

MODIS: Albedo & BRDF (MCD43)¶

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

Combined daily 16-day surface albedo (MCD43A3 500m or MCD43C3 0.05° Climate Modeling Grid):

# ==============================================================================
# NASA MODIS — BRDF & Albedo Products (MCD43A1, MCD43A3, MCD43C1, MCD43C3)
# ==============================================================================

source: modis

satellite: Combined
product_type: MCD43A3                  # Or 'ALBEDO_500M', 'BRDF_500M', 'ALBEDO_CMG'
collection_version: "61"

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

grid:
  site: "Granada"
  size_yx: [100, 100]
  resolution_m: 500.0
  projection: "latlon"

limit: 3
only_granules_list: false
return_s3_paths: false
overwrite_cache: false

MODIS: Aqua 1km Calibrated Radiances (MYD021KM)¶

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

# ==============================================================================
# NASA MODIS — Aqua Level-1B Calibrated Radiances (MYD021KM & MYD03)
# ==============================================================================

source: modis

satellite: Aqua
product_type: MYD021KM
day_night_flag: DAY

start_time: "2024-06-15T12:00:00Z"
end_time: "2024-06-15T15:00:00Z"

grid:
  site: "El_Arenosillo"
  size_yx: [100, 100]
  resolution_m: 1000.0
  projection: "latlon"

limit: 2
only_granules_list: false
return_s3_paths: false
overwrite_cache: false

PACE: OCI Hyperspectral L1C¶

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

Queries Ocean Color Instrument (OCI) hyperspectral Top-Of-Atmosphere Level-1C science data:

# ==============================================================================
# NASA PACE — OCI (Ocean Color Instrument) Hyperspectral Top-of-Atmosphere & L2
# ==============================================================================

source: pace

instrument: OCI
product_type: L1C

start_time: "2024-06-01T10:00:00Z"
end_time: "2024-06-01T14:00:00Z"

grid:
  center_lat_lon: [36.5, -4.5]        # Malaga / Mediterranean Coast, Spain
  size_yx: [100, 100]
  resolution_m: 1000.0
  projection: "latlon"

limit: 2
max_workers: 4                         # Number of concurrent download worker threads
only_granules_list: false
return_s3_paths: false
overwrite_cache: false

PACE: HARP2 Polarimeter L1C¶

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

# ==============================================================================
# NASA PACE — HARP2 (Hyper-Angular Rainbow Polarimeter-2) L1C / L2
# ==============================================================================

source: pace

instrument: HARP2
product_type: L1C

start_time: "2025-01-01T00:00:00Z"
end_time: "2025-01-01T06:00:00Z"

grid:
  site: "Granada"
  size_yx: [100, 100]
  resolution_m: 5000.0
  projection: "latlon"

limit: 2
only_granules_list: false
return_s3_paths: false
overwrite_cache: false

PACE: SPEXone Polarimeter L1C¶

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

# ==============================================================================
# NASA PACE — SPEXone (Spectro-Polarimeter for Planetary Exploration one)
# ==============================================================================

source: pace

instrument: SPEXone
product_type: L1C

start_time: "2024-09-01T00:00:00Z"
end_time: "2024-09-01T12:00:00Z"

grid:
  site: "El_Arenosillo"
  size_yx: [50, 50]
  resolution_m: 2500.0
  projection: "latlon"

limit: 2
only_granules_list: false
return_s3_paths: false
overwrite_cache: false