Hydrography#

easysnowdata.hydro#

Hydrography: basin and watershed boundaries.

Products#

basins: USGS HUC units (WBD REST, Earth Engine), HydroBASINS / BasinATLAS (figshare, HydroSHEDS regional zips, Earth Engine), GRDC major river basins and GRDC / WMO basins.

import easysnowdata as esd

aoi = (-121.94, 46.72, -121.54, 46.99)
esd.hydro.basins.huc(aoi, level=12)
esd.hydro.basins.hydrobasins(aoi, level=5)

easysnowdata.hydro.basins#

Basin and watershed boundaries (§4.7, companion §B.10).

import easysnowdata as esd

aoi = (-121.94, 46.72, -121.54, 46.99)
huc = esd.hydro.basins.huc(aoi, level=12)          # USGS WBD, no credentials
atlas = esd.hydro.basins.hydrobasins(aoi, level=5)  # BasinATLAS attributes
major = esd.hydro.basins.grdc_major(aoi)            # GRDC major river basins
wmo = esd.hydro.basins.grdc_wmo(aoi)                # GRDC / WMO basins

Four products share this module because they answer the same question with different geographies. Every loader returns a geopandas.GeoDataFrame in EPSG:4326 holding the features that intersect the AOI — whole basins, not polygons cut at the AOI edge — with the provenance attrs of §2.5 in .attrs.

The HUC default moved off Earth Engine (§12 Q7): the USGS Watershed Boundary Dataset is public through its own ArcGIS REST service, so HUC boundaries need no credentials at all. Earth Engine stays as source="gee".

`huc`	Hydrologic unit (HUC) boundaries for aoi.
`hydrobasins`	HydroBASINS / BasinATLAS sub-basin boundaries for aoi.
`grdc_major`	The GRDC major river basins of the world that intersect aoi.
`grdc_wmo`	The GRDC / WMO basins and sub-basins that intersect aoi.
`load`	Load one of the basin datasets by catalog id.