pygeohydro.watershed

Accessing watershed boundary-level data through web services.

Module Contents

class pygeohydro.watershed.WBD(layer, outfields='*', crs=4326)

Access Watershed Boundary Dataset (WBD).

Notes

This web service offers Hydrologic Unit (HU) polygon boundaries for the United States, Puerto Rico, and the U.S. Virgin Islands. For more info visit: https://hydro.nationalmap.gov/arcgis/rest/services/wbd/MapServer

Parameters:

• layer (str, optional) – A valid service layer. Valid layers are:

  • wbdline

  • huc2

  • huc4

  • huc6

  • huc8

  • huc10

  • huc12

  • huc14

  • huc16

• outfields (str or list, optional) – Target field name(s), default to “*” i.e., all the fields.

• crs (str, int, or pyproj.CRS, optional) – Target spatial reference, default to EPSG:4326.

pygeohydro.watershed.huc_wb_full(huc_lvl)

Get the full watershed boundary for a given HUC level.

Notes

This function is designed for cases where the full watershed boundary is needed for a given HUC level. If only a subset of the HUCs is needed, then use the pygeohydro.WBD class. The full dataset is downloaded from the National Maps’ WBD staged products.

Parameters:

huc_lvl (int) – HUC level, must be even numbers between 2 and 16.

Returns:

geopandas.GeoDataFrame – The full watershed boundary for the given HUC level.

Return type:

geopandas.GeoDataFrame

pygeohydro.watershed.irrigation_withdrawals()

Get monthly water use for irrigation at HUC12-level for CONUS.

Notes

Dataset is retrieved from https://doi.org/10.5066/P9FDLY8P.