energy_data_retrieval.sources.usgs_3dep.client#

USGS National Map discovery and downloads of project-based 1 m terrain.

class energy_data_retrieval.sources.usgs_3dep.client.TerrainProduct(source_id, title, download_url, size_bytes, metadata)[source]#

Bases: object

Provider product metadata retained verbatim; publication is not acquisition.

Parameters:
  • source_id (str)

  • title (str)

  • download_url (str)

  • size_bytes (int)

  • metadata (dict[str, JSONValue])

source_id: str#
title: str#
download_url: str#
size_bytes: int#
metadata: dict[str, JSONValue]#
class energy_data_retrieval.sources.usgs_3dep.client.TerrainSearch(products, requests, total)[source]#

Bases: object

Complete bounded catalogue result and every page’s provenance.

Parameters:
products: tuple[TerrainProduct, ...]#
requests: tuple[RequestRecord, ...]#
total: int#
class energy_data_retrieval.sources.usgs_3dep.client.USGS3DEPClient(http)[source]#

Bases: object

Discover all matching project tiles before choosing one explicitly.

There is no global or complete US 1 m coverage claim. Overlapping projects can differ in survey date, extent, datum and nodata. This connector selects the project-based 1 m dataset, not the newer seamless 1 m product. Configure a sufficient bounded download budget for the selected file’s advertised size.

Parameters:

http (HTTPClient)

search(bounds_wgs84, *, maximum_items=1000, page_size=100)[source]#
Parameters:
  • bounds_wgs84 (Bounds)

  • maximum_items (int)

  • page_size (int)

Return type:

TerrainSearch

download_product(directory, product, *, expected_sha256=None)[source]#
Parameters:
  • directory (Path)

  • product (TerrainProduct)

  • expected_sha256 (str | None)

Return type:

tuple[Path, RequestRecord]