easysnowdata.hydro.basins.huc#

easysnowdata.hydro.basins.huc(aoi: Any = None, *, level: int | str = 8, source: str | None = None, columns: Any = None, where: str | None = None, page_size: int = 200, geometry_precision: int = 6, timeout: float = 120) GeoDataFrame[source]#

Hydrologic unit (HUC) boundaries for aoi.

Parameters:
  • aoi – Any form easysnowdata.aoi.parse_aoi() accepts; None asks for the whole United States, which only the coarse levels can answer.

  • level – 2, 4, 6, 8 (default), 10, 12, 14 or 16 — the number of HUC digits. Strings ("02") are accepted.

  • source"usgs-wbd" (default, the public ArcGIS REST service, no credentials) or "gee".

  • columns – Attributes to keep. None keeps the columns the old get_huc_geometries returned; "all" keeps everything.

  • where – Extra SQL filter for the REST service ("states LIKE '%WA%'").

  • page_size – REST paging controls. The service times out on large pages, so it is paged in blocks of page_size features with coordinates rounded to geometry_precision decimals.

  • geometry_precision – REST paging controls. The service times out on large pages, so it is paged in blocks of page_size features with coordinates rounded to geometry_precision decimals.

  • timeout – REST paging controls. The service times out on large pages, so it is paged in blocks of page_size features with coordinates rounded to geometry_precision decimals.

Returns:

geopandas.GeoDataFrame – The hydrologic units intersecting the AOI, in EPSG:4326.