Skip to content

Examples

AerEO ships with runnable Jupyter notebooks for every supported sensor and workflow. Each notebook uses the Hydra config package in examples/config and the ExtractionJob API: search, build_tasks, and execute.

The thumbnails below are real outputs from the notebooks — grid-aligned patches on the Major TOM grid, with the target AOI overlaid.

Before you run

Most examples perform live catalog searches and data downloads. Make sure you have:

  1. The core package and any sensor-specific plugins listed below.
  2. Credentials for the catalog that requires them.
  3. A few minutes of runtime for the extraction step.

Beginner

Notebook Sensor Plugins Auth What it teaches Preview
01 — Sentinel-2 (nir, red) Open In Colab Sentinel-2 MSI aereo None (Earth Search is public) Load a Hydra job, search STAC, extract a GeoTIFF on the Major TOM grid. Sentinel-2
05 — GOES-19 ABI preview Open In Colab GOES-19 ABI aereo + aereo-search-aws-goes + aereo-read-satpy None Public S3 search and Satpy-based reading/reprojection. GOES-19
step_by_step_raw Open In Colab Sentinel-2 MSI aereo None (Earth Search is public) Same pipeline built entirely from raw Python — no config files or Hydra. Sentinel-2 raw

Processing

Notebook Sensor Plugins Auth What it teaches Preview
01b — Sentinel-2 NDVI Open In Colab Sentinel-2 MSI aereo None (Earth Search is public) Add a processor stage (NDVI) before reprojection. Sentinel-2 NDVI
01c — Sentinel-2 NDWI Open In Colab Sentinel-2 MSI aereo None (Earth Search is public) Add a processor stage (NDWI) before reprojection. Sentinel-2 NDWI
03b — Sentinel-3 NDVI Open In Colab Sentinel-3 OLCI aereo + aereo-read-satpy NASA Earthdata Processor stage with Satpy-based reading. Sentinel-3 NDVI

Sensors

Notebook Sensor Plugins Auth What it teaches Preview
02 — VIIRS Open In Colab VIIRS aereo + aereo-read-satpy NASA Earthdata Search Earthaccess and read with Satpy. VIIRS
03 — Sentinel-3 OLCI Open In Colab Sentinel-3 OLCI aereo + aereo-read-satpy NASA Earthdata Sentinel-3 extraction workflow. Sentinel-3 OLCI
04 — Tessera Open In Colab GeoTessera aereo + aereo-search-tessera + aereo-read-tessera None Tessera tile search and extraction. Tessera
06 — Multiple constellations Open In Colab Sentinel-2 + VIIRS aereo + aereo-read-satpy NASA Earthdata Search and extract multiple sensors with a shared cache. Multi-constellation

Download notebooks

You can also download the raw notebooks directly from GitHub: