Skip to content

uw-cryo/stac-3dep-1m

Repository files navigation

stac-3dep-1m

Static STAC Catalog + STAC GeoParquet for 100,000+ public 3DEP 1m seamless LiDAR DEMs from here (https://prd-tnm.s3.amazonaws.com/index.html?prefix=StagedProducts/Elevation/1m)

This repository contains scripts to create a static STAC catalog of 3DEP 1m DEMs hosted on AWS. It creates Static STAC Item JSON generated by a TiTiler STAC endpoint for each 1m TIFF, and at the end saves a single STAC GeoParquet file with all the Items.

Coverage as of March 2026 (plus Hawaii & Puerto Rico), 115523 GeoTiffs:

Catalog visualization

STAC Browser

stac-map

  • Render the STAC GeoParquet with stac-map:

full STAC-Geoparquet catalog:

https://developmentseed.org/stac-map/?href=https://raw.githubusercontent.com/scottyhq/files/refs/heads/main/catalog.parquet

☝️ Note: stac-map does not work with release assets (which dynamically redirect), it needs 'raw.githubusercontent' so in order to not clutter up this repository with large binary files, we put ~20MB STAC-geoparquet files in a separate repo: https://github.com/scottyhq/files

full STAC JSON catalog:

https://developmentseed.org/stac-map/?href=https://raw.githubusercontent.com/uw-cryo/stac-3dep-1m/refs/heads/main/catalog/catalog.json

single collection STAC json:

https://developmentseed.org/stac-map/?href=https://raw.githubusercontent.com/uw-cryo/stac-3dep-1m/refs/heads/main/catalog/WA_KingCounty_2021_B21/collection.json

Versioning

3DEP 1m data is updated over time, so we will update this catalog periodically as new data is added. STAC-geoparquet files are added as release assets rather than commited directly to the repository to keep track of changes, you can use a specific version of the catalog by pointing at a specific release: https://github.com/uw-cryo/stac-3dep-1m/releases/download/v0.2/catalog.parquet

Or use 'latest' to always point to the most recent release: https://github.com/uw-cryo/stac-3dep-1m/releases/latest/download/catalog.parquet

Or you can browse the static catalog using a specific tag (e.g. v0.2) in the GitHub url: https://raw.githubusercontent.com/uw-cryo/stac-3dep-1m/refs/tags/v0.2/catalog/catalog.json

Note: 'main' rather than 'latest' points to the latest version of the catalog: https://raw.githubusercontent.com/uw-cryo/stac-3dep-1m/refs/heads/main/catalog/catalog.json

Catalog usage

We created this catalog to test out using GDAL's GTI driver, there are some exploratory notebooks using GDAL, geopandas, and rustacpy/DuckDB in the notebooks folder.

This catalog is also used for high performance sampling of the 1m DEMs with SlideRule Earth Raster Sampling - see https://docs.slideruleearth.io/user_guide/raster_sampling.html

Catalog creation

Single collection / workunit

pixi run create-stac --project  WA_KingCounty_2021_B21 --overwrite

Loop over all workunits

pixi run create-all

Create STAC GeoParquet from static STAC catalog

ulimit -n 500000
pixi run catalog2geoparquet

See NOTES.md for more details on the creation process and some of the challenges we ran into.

References