coincident.io.download.fetch_noaa_lpc_tiles#

coincident.io.download.fetch_noaa_lpc_tiles(aoi, dataset_id, output_dir=None)#

Fetch NOAA DEM tile geometries as a GeoDataFrame (in EPSG:4326), optionally writing to disk as a GeoJSON.

This function processes NOAA DEM LAZ files, extracts tile geometries based on filename patterns, filters them by intersection with the provided AOI, and returns a GeoDataFrame in EPSG:4326.

NOTE: regex was necessary here for client-side spatial filtering, otherwise you’d have to make network requests to thousands of laz files

Steps:

  1. Estimate the appropriate UTM CRS for spatial filtering.

  2. Query the NOAA dataset for LAZ files.

  3. Extract easting and northing from filenames using regex.

  4. Determine tile dimensions by analyzing neighboring tiles.

  5. Construct tile geometries and filter by AOI intersection.

  6. Assemble into a GeoDataFrame and reproject to EPSG:4326.

  7. If output_dir is provided, save the GeoDataFrame as noaa_dem_tiles.geojson.

Parameters:

  • aoi (gpd.GeoDataFrame) – AOI geometries.

  • dataset_id (str) – NOAA dataset identifier.

  • output_dir (Optional[str]) – Directory to write noaa_dem_tiles.geojson. If None, nothing is written.

Returns:

Tile extent polygons in lon/lat.

Return type:

gpd.GeoDataFrame