Supported data sources#
earthlens exposes every provider through one facade, EarthLens(data_source="<key>", ...). The table below lists
the providers that are integrated today, the string key(s) each one accepts, the natural output it produces, and
the optional dependency (extra) you need to install for it.
Install a backend's optional dependency with:
pip install earthlens[<extra>] # e.g. earthlens[ecmwf]
pip install earthlens[all] # every backend's SDK
Backends with no extra (CHC, GDACS, FIRMS, OpenAQ, AirNow, Sensor.Community, GHSL) need only the core install — they use anonymous FTP or plain HTTP.
Integrated providers#
| Provider | data_source key(s) |
Output | Auth | Extra | Docs |
|---|---|---|---|---|---|
| Climate Hazards Center (CHIRPS / CHIRTS / SPI / SPEI / WBGT / …) | chc, chirps |
raster | anonymous FTP | — | CHC |
| AWS Open Data (ERA5 / Sentinel-2 / Copernicus DEM / ESA WorldCover) | amazon-s3 |
raster | unsigned AWS (public buckets) | s3 |
Amazon S3 |
| ECMWF Climate Data Store | ecmwf |
raster | ~/.cdsapirc token |
ecmwf |
ECMWF |
| Google Earth Engine | gee, google-earth-engine |
raster | service account | gee |
GEE |
| Copernicus Marine (CMEMS) | cmems |
raster | Copernicus Marine login | cmems |
CMEMS |
| FDSN seismic events (USGS / EMSC / INGV / …) | fdsn |
vector | none | fdsn |
FDSN |
| GDACS disaster alerts | gdacs |
vector | none | — | GDACS |
| OpenAQ air quality (global aggregator) | openaq |
tabular | API key (X-API-Key) |
— | OpenAQ |
| AirNow air quality (US / Canada EPA) | airnow |
tabular | API key (API_KEY) |
— | AirNow |
| EEA air quality (Europe) | eea-aq |
tabular | none (public) | eea_aq |
EEA |
| Sensor.Community air quality (crowdsourced) | sensor-community |
tabular | none (public) | — | Sensor.Community |
| Tropycal tropical-cyclone tracks | tropycal |
vector (tabular for SHIPS) | none | tropycal |
Tropycal |
| STAC — Planetary Computer / CDSE / Earth Search | stac, cdse |
raster | per-endpoint (anonymous / MPC SAS / CDSE S3) | stac |
STAC |
NASA Earthdata (9 EOSDIS DAACs via earthaccess) |
earthdata |
per-dataset (raster / vector / tabular) | EDL login or bearer token | earthdata |
Earthdata |
| Open NWP forecasts (NOAA NODD / ECMWF Open Data / DWD via Herbie) | nwp |
raster | none (open buckets) | nwp |
NWP |
| NEXRAD Level-II radar (real-time chunk feed) | radar, nexrad |
vector | none (anonymous S3) | radar |
NEXRAD radar |
| openEO server-side processing (defaults to CDSE) | openeo |
raster | CDSE OIDC (interactive or client-credentials) | openeo |
openEO |
NOAA National Water Model (noaa-nwm-pds) |
nwm, national-water-model |
per-product (chrtout tabular / ldasout raster) |
unsigned AWS (public bucket) | nwm |
NWM |
| Humanitarian Data Exchange (UN OCHA, CKAN) | hdx |
mixed | none (public) | hdx |
HDX |
| NASA FIRMS active fire detections | firms |
vector | FIRMS_MAP_KEY |
— | FIRMS |
| EUMETSAT Data Store | eumetsat |
per-dataset (raster default) | consumer key / secret | eumetsat |
EUMETSAT |
| Sentinel Hub server-side render (CDSE) | sentinel-hub, sentinelhub |
mixed (raster / tabular per plane) | OAuth client id / secret | sentinel-hub |
Sentinel Hub |
| Overture Maps vector basemap | overture |
vector | none (public) | overture |
Overture |
| USGS Water — NWIS / Water Data | usgs-water, usgs-nwis, nwis |
tabular | none | usgs-water |
USGS Water |
| JRC Global Human Settlement Layer | ghsl, ghs, human-settlement |
raster | none (open HTTPS) | — | GHSL |
| WorldPop population data hub | worldpop, world-pop |
mixed (rasters + age/sex tables) | none (CC-BY-4.0) | worldpop (optional) |
WorldPop |
| Alaska Satellite Facility (SAR search + InSAR baselines) | asf, alaska-satellite-facility, insar |
vector | NASA Earthdata Login (reuses earthdata) |
asf |
ASF |
| JAXA Earth-observation archive (jaxa-earth STAC/COG + G-Portal SFTP) | jaxa, jaxa-earth, g-portal |
raster | none (jaxa-earth) / G-Portal SFTP credentials | jaxa |
JAXA |
| GBIF species occurrences | gbif |
vector | none (anonymous) | gbif |
GBIF |
| OBIS marine occurrences | obis |
vector | none (anonymous) | obis |
OBIS |
| Protected Planet (WDPA) protected areas | wdpa, protected-planet |
vector | API token (?token=) |
— | WDPA |
| IUCN Red List assessments | iucn, redlist |
tabular | Bearer token | — | IUCN |
| Generic ERDDAP servers (NOAA CoastWatch / Coral Reef Watch / NCEI / …) | erddap, ioos |
per-dataset (raster griddap / tabular tabledap) | none (public servers) | erddap |
ERDDAP |
| Bathymetry DEMs (GEBCO 2020 / NOAA ETOPO1 ice + bedrock) | bathymetry, gebco, etopo |
raster | none (open ERDDAP) | — | Bathymetry |
| Argo float ocean profiles | argo, argo-floats, argopy |
tabular | none (open data) | argo |
Argo |
| Administrative boundaries (geoBoundaries / CGAZ / Natural Earth / TIGER) | admin, admin-boundaries, geoboundaries, natural-earth, tiger |
vector | none (public) | — | Administrative boundaries |
| ISRIC SoilGrids 2.0 soil properties (250 m, OGC WCS) | soilgrids, isric |
raster | none (public, CC-BY 4.0) | — | SoilGrids |
| Drought indicators (USDM / Copernicus EDO + GDO / CSIC SPEIbase) | drought, usdm, edo, gdo |
per-dataset (vector USDM polygons / raster EDO+GDO+SPEIbase) | none | — | Drought |
Output is the backend's OUTPUT_KIND — raster writes GeoTIFF/COG/NetCDF, vector writes geometry tables
(GeoJSON / GeoPackage), tabular writes plain tables (CSV / Parquet), and mixed (HDX, Sentinel Hub, WorldPop)
covers backends whose products vary by request. It also governs aggregate=: the temporal aggregator is
accepted for raster backends and rejected for vector / tabular ones; the mixed backends reject it
because their products are returned as-is.