Worked Examples

Worked examples that use these APIs are published in the USGS Water Mission Area integrated data and tools catalog . Most began as Jupyter notebooks, and each page shows the code alongside its output. The catalog team maintains them; the collection is still growing, so check the date on an example before relying on it.

Browse the full set at water.usgs.gov/catalog/usecases . The examples below are the ones most relevant to the APIs documented on this site.

Network navigation and the hydrologic fabric

• Working with the Hydro Location Inventory and NLDI — indexing a version of the National Inventory of Dams against the NLDI
• Advanced NHDPlus Network Attributes
• What is a “reference hydrologic geospatial fabric”?

See Getting Started with the NLDI and the Hydrologic Fabric service for the reference documentation behind these.

Gridded data, catalogs, and processing

• Environmental Data Retrieval (EDR)
• Water Mission Area STAC Catalog
• Asynchronous Processing via OGC API Processes
• Regridding gridded climate data to NHD HUC12 polygons
• Aggregating gridMET data to NHD flowlines and sample points
• gdptools with CONUS404
• gdptools with the climateR catalog
• Dockerized deployment of data services through pygeoapi

See the Geo Data Portal service for the reference documentation behind these.