coincident.io.xarray.load_usgs_dem#

coincident.io.xarray.load_usgs_dem(aoi, project, tnmdataset='Digital Elevation Model (DEM) 1 meter', res=1, clip=False, clip_box=True)[source]#

Load and merge USGS 1-meter DEM tiles based on an AOI by querying the TNM API.

Parameters:

  • aoi (GeoDataFrame) – Area of interest geometry to query against

  • project (str) – Project identifier to filter results

  • tnmdataset (str) – TNM dataset identifier

  • res (int) – Resolution factor to coarsen DEM by

  • clip (bool) – Use AOI to crop extent and apply valid data mask

  • clip_box (bool) – Use AOI bounding box to crop extent

Return type:

DataArray

Returns:

The merged (and optionally clipped) DEM mosaic.