coincident.io.xarray.load_noaa_dem#

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

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 (geopandas.GeoDataFrame) – Area of interest geometry (assumed to be in EPSG:4326 or any other CRS that will be reprojected).

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

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

  • clip (bool, optional) – Whether to clip the output mosaic to the AOI. Defaults to True.

Returns:

An xarray DataArray containing DEM values clipped to the AOI.

Return type:

xarray.DataArray

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.