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:
objectProvider 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:
objectComplete bounded catalogue result and every page’s provenance.
- Parameters:
products (tuple[TerrainProduct, ...])
requests (tuple[RequestRecord, ...])
total (int)
- products: tuple[TerrainProduct, ...]#
- requests: tuple[RequestRecord, ...]#
- total: int#
- class energy_data_retrieval.sources.usgs_3dep.client.USGS3DEPClient(http)[source]#
Bases:
objectDiscover 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:
- download_product(directory, product, *, expected_sha256=None)[source]#
- Parameters:
directory (Path)
product (TerrainProduct)
expected_sha256 (str | None)
- Return type:
tuple[Path, RequestRecord]