easysnowdata.hydroclimatology.get_grdc_wmo_basins#

easysnowdata.hydroclimatology.get_grdc_wmo_basins(bbox_input: GeoDataFrame | tuple | BaseGeometry | None = None, **kwargs) → GeoDataFrame[source]#

Deprecated since version 0.1.0: easysnowdata.hydroclimatology.get_grdc_wmo_basins is deprecated since easysnowdata 0.1.0 and will be removed in 0.3.0. Use easysnowdata.hydro.basins.grdc_wmo instead. Basins that intersect the AOI are returned whole, not cut at its edge.

Retrieves WMO Basins and Sub-Basins dataset.

Deprecated since version 0.1.0: Use easysnowdata.hydro.basins.grdc_wmo(). It returns the intersecting basins whole instead of clipping them to the AOI.

Parameters:

bbox_input (geopandas.GeoDataFrame, tuple, or Shapely Geometry, optional) – The bounding box for spatial subsetting. If None, the entire global dataset is returned.
**kwargs – Additional keyword arguments passed to easysnowdata.hydro.basins.grdc_wmo() (and on to geopandas.read_file).

Returns:

geopandas.GeoDataFrame – A GeoDataFrame containing the WMO Basins and Sub-Basins with associated attributes.

Notes

The GRDC archive is downloaded once into the easysnowdata cache directory (~/.cache/easysnowdata/grdc on Linux; override with EASYSNOWDATA_CACHE_DIR) and re-used on later calls.

Data citation: GRDC (2020): WMO Basins and Sub-Basins / Global Runoff Data Centre, GRDC. 3rd, rev. ext. ed. Koblenz, Germany: Federal Institute of Hydrology (BfG).