DataSources.md

June 2, 2026 ยท View on GitHub

Data Sources

This document lists the built-in data sources in rslearn. Each data source links to a detailed page with configuration options and available bands. See Dataset Configuration for how to use these in a dataset config file.

General-Purpose

Data SourceDescription
local_files.LocalFilesIngest from local raster or vector files

Remote Sensing Images

Sentinel-2

Data SourceProviderNotes
planetary_computer.Sentinel2Microsoft Planetary ComputerL2A COGs, direct materialization
aws_open_data.Sentinel2AWS (Element 84)L1C and L2A
aws_sentinel2_element84.Sentinel2AWS (Element 84)L2A COGs, direct materialization
copernicus.Sentinel2ESA Copernicus OData APIL1C and L2A
earthdaily.Sentinel2L2AEarthDailyPC-compatible L2A (sentinel-2-l2a), same band names as planetary_computer.Sentinel2
earthdaily.Sentinel2C1L2AEarthDailyCollection 1 L2A (sentinel-2-c1-l2a), scale/offset reflectance
earthdaily.Sentinel2EDACloudMaskEarthDailySentinel-2 EDA cloud mask (sentinel-2-eda-cloud-mask), categorical cloud-mask band
gcp_public_data.Sentinel2Google Cloud StorageL1C and L2A scenes

Sentinel-1

Data SourceProviderNotes
planetary_computer.Sentinel1Microsoft Planetary Computerterrain-corrected COGs, direct materialization
aws_sentinel1.Sentinel1AWS (Sinergise)GRD IW DV
copernicus.Sentinel1ESA Copernicus OData APIIW GRDH

Landsat

Data SourceProviderNotes
gcp_landsat.LandsatGoogle Cloud StorageCollection 2 L1/L2 all missions, requester-pays, direct materialization
aws_landsat.LandsatOliTirsAWS (USGS)Level-1, all bands
planetary_computer.LandsatC2L2Microsoft Planetary ComputerCollection 2 Level-2, direct materialization
usgs_landsat.LandsatOliTirsUSGS M2M APIRequires M2M access

HLS (Harmonized Landsat Sentinel-2)

Data SourceProviderNotes
planetary_computer.Hls2S30Microsoft Planetary ComputerHLS v2 Sentinel-2 (30m)
planetary_computer.Hls2L30Microsoft Planetary ComputerHLS v2 Landsat (30m)
nasa_hls.Hls2NASA LP DAACCombined semantic-band HLS v2.0 time-series across Sentinel and Landsat
nasa_hls.Hls2S30NASA LP DAACHLSS30 v2.0, direct materialization via protected S3
nasa_hls.Hls2L30NASA LP DAACHLSL30 v2.0, direct materialization via protected S3

NAIP

Data SourceProviderNotes
aws_open_data.NaipAWS (Esri)Requester pays, requires AWS credentials
planetary_computer.NaipMicrosoft Planetary ComputerDirect materialization

Other

Data SourceProviderNotes
copernicus.CopernicusESA Copernicus OData APIGeneric product access
google_earth_engine.GEEGoogle Earth EngineGeneric ee.ImageCollection access
aws_google_satellite_embedding_v1.GoogleSatelliteEmbeddingV1AWS Open DataGoogle Satellite Embedding v1
google_earth_engine.GoogleSatelliteEmbeddingsGoogle Earth EngineGoogle Satellite Embedding v1, requires GEE credentials
planetary_computer.PlanetaryComputerMicrosoft Planetary ComputerGeneric collection access
planetary_computer.Sentinel3SlstrLSTMicrosoft Planetary ComputerLand Surface Temperature, requires ingestion
earthdaily.BiophysicalEarthDailyLAI/FAPAR/FCOVER, requires EarthDaily credentials
xyz_tiles.XyzTilesAny XYZ tile serverWeb slippy tiles

Experimental

These data sources are still experimental and may have incomplete functionality.

  • rslearn.data_sources.planet.Planet
  • rslearn.data_sources.planet_basemap.PlanetBasemap

Other Raster Data

Elevation

Data SourceDescription
hf_srtm.SRTMSRTM elevation (~30-90m), served from Hugging Face
planetary_computer.CopDemGlo30Copernicus DEM GLO-30 (30m)

Climate / Weather

Data SourceDescription
climate_data_store.ERA5LandERA5 Land from Copernicus CDS (base class, monthly means, hourly)
chelsa.CHELSADailyCHELSA daily global climate rasters
earthdatahub.ERA5LandDailyUTCv1ERA5-Land daily UTC from EarthDataHub

Land Cover / Crop

Data SourceDescription
worldcover.WorldCoverESA WorldCover 2021 (10m)
worldcereal.WorldCerealESA WorldCereal 2021 crop map
usda_cdl.CDLUSDA Cropland Data Layer (US only)

Soil

Data SourceDescription
soilgrids.SoilGridsISRIC SoilGrids via WCS (~250m)
soildb.SoilDBOpenLandMap SoilDB (30m)

Population

Data SourceDescription
worldpop.WorldPopWorldPop Constrained 2020 (100m)

Vector Data

Data SourceDescription
openstreetmap.OpenStreetMapOpenStreetMap features from PBF files
eurocrops.EuroCropsEuroCrops v11 agricultural parcels