coincident.io.download.download_usgs_dem#

coincident.io.download.download_usgs_dem(aoi, project, output_dir='/tmp', save_parquet=True, tnmdataset='Digital Elevation Model (DEM) 1 meter')#

Download USGS 1-meter DEM tiles based on an AOI by querying the TNM API. https://data.usgs.gov/datacatalog/data/USGS:77ae0551-c61e-4979-aedd-d797abdcde0e

Steps:

  1. Reproject the AOI to EPSG:4326.

  2. Extract the first geometry from the exploded AOI.

  3. Convert the geometry to a polygon string.

  4. Query the TNM API and filter results.

  5. Optionally save metadata as geoparquet.

  6. Download each tile with progress tracking.

Parameters:

  • aoi (gpd.GeoDataFrame) – Area of interest geometry.

  • project (str) – Project identifier to filter results.

  • path (str) – Directory path where tiles will be downloaded.

  • save_parquet (bool, optional) – Whether to save metadata as geoparquet (default True).

  • tnmdataset (str, optional) – TNM dataset identifier (default “Digital Elevation Model (DEM) 1 meter”).

  • output_dir (str)

Returns:

Files are downloaded to the specified output path.

Return type:

None