easysnowdata.hydro.basins.hydrobasins#

easysnowdata.hydro.basins.hydrobasins(aoi: Any = None, *, level: int = 5, source: str | None = None, region: str | None = None, columns: list[str] | None = None, **kwargs: Any) → GeoDataFrame[source]#

HydroBASINS / BasinATLAS sub-basin boundaries for aoi.

Parameters:

  • aoi – Any form easysnowdata.aoi.parse_aoi() accepts.

  • level – Pfafstetter level 1-12; higher is finer.

  • source – "figshare-basinatlas" (default; one 2.7 GB global geodatabase with the BasinATLAS attributes, read with mask pushdown), "hydrosheds" (per-region zips, much smaller, geometry only) or "gee".

  • region – HydroSHEDS route only: one of HYDROSHEDS_REGIONS. Inferred from the AOI when omitted.

  • columns – Attributes to keep (BasinATLAS ships several hundred).

  • **kwargs – Passed to geopandas.read_file.

Returns:

geopandas.GeoDataFrame – The sub-basins intersecting the AOI, in EPSG:4326.