coincident.io.xarray.load_noaa_dem#

coincident.io.xarray.load_noaa_dem(aoi, dataset_id, res=1, clip=True)[source]#

Process NOAA coastal lidar DEM data from S3 based on a dataset identifier and an AOI. Returns an xarray DataArray with elevation values clipped to the AOI without downloading files locally.

Parameters:

  • aoi (GeoDataFrame) – Area of interest geometry (assumed to be in EPSG:4326 or any other CRS that will be reprojected).

  • dataset_id (str | int) – NOAA dataset identifier (e.g., “8431” or “6260”).

  • res (int) – Resolution factor. If greater than 1, the data will be coarsened by this factor.

  • clip (bool) – Whether to clip the output mosaic to the AOI.

Return type:

DataArray

Returns:

An xarray DataArray containing DEM values clipped to the AOI.

Notes

  • This function queries only the raster headers from S3 to retrieve bounds information quickly.

  • The header metadata is processed concurrently to reduce I/O latency.

  • Tiles are spatially filtered against the AOI and merged into a mosaic using xarray.