easysnowdata.hydroclimatology.get_huc_geometries#

easysnowdata.hydroclimatology.get_huc_geometries(bbox_input: GeoDataFrame | tuple | BaseGeometry | None = None, huc_level: str = '02') → GeoDataFrame[source]#

Deprecated since version 0.1.0: easysnowdata.hydroclimatology.get_huc_geometries is deprecated since easysnowdata 0.1.0 and will be removed in 0.3.0. Use easysnowdata.hydro.basins.huc instead. The new loader defaults to the public USGS WBD REST service, so HUC boundaries no longer need Earth Engine, and the citation is in the data_citation attr.

Retrieves Hydrologic Unit Code (HUC) geometries within a specified bounding box and HUC level.

Deprecated since version 0.1.0: Use easysnowdata.hydro.basins.huc(). Its default source is the USGS Watershed Boundary Dataset REST service (no credentials, newer than the 2017 Earth Engine snapshot); pass source="gee" for the Earth Engine route this function used.

Parameters:

  • bbox_input (geopandas.GeoDataFrame, tuple, or Shapely Geometry, optional) – The bounding box for spatial subsetting. If None, the entire US dataset is returned.

  • huc_level (str, optional) – The HUC level to retrieve geometries for. Valid levels are ‘02’, ‘04’, ‘06’, ‘08’, ‘10’, ‘12’. Default is ‘02’.

Returns:

geopandas.GeoDataFrame – A GeoDataFrame containing the retrieved HUC geometries along with associated attributes such as name, area in square kilometers, states, TNMID, and geometry.

Notes

Data citation: Jones, K.A., Niknami, L.S., Buto, S.G., and Decker, D., 2022, Federal standards and procedures for the national Watershed Boundary Dataset (WBD) (5 ed.): U.S. Geological Survey Techniques and Methods 11-A3, 54 p., https://doi.org/10.3133/tm11A3