coincident.io.download.download_noaa_dem#

coincident.io.download.download_noaa_dem(aoi, dataset_id, output_dir='/tmp', res=1, clip=True)#

Download NOAA coastal lidar DEM data from S3 based on a dataset identifier and an AOI. For each tile that intersects the AOI, the tile is downloaded, optionally coarsened and clipped, then saved as a GeoTIFF file in the specified output directory.

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”).

  • output_dir (str, optional) – Directory to save downloaded output files. Defaults to “/tmp”.

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

  • clip (bool, optional) – Whether to clip each DEM tile to the AOI. Defaults to True.

Returns:

Processed DEM tiles are saved as GeoTIFF files to the specified output directory.

Return type:

None

Notes

The function retrieves only the header information from each file on S3 to determine tile bounds, then filters and processes only those tiles intersecting the AOI. Files are processed concurrently to reduce overall network latency.