NOAA-OWP / hydrotools

Suite of tools for retrieving USGS NWIS observations and evaluating National Water Model (NWM) data.
Other
54 stars 13 forks source link

Add additional client tools for USGS NWIS services #204

Open jarq6c opened 2 years ago

jarq6c commented 2 years ago

This PR adds multiple additional NWIS services that return USGS metadata about sites (full name, drainage area, etc.), statistics (min, max, median, mean, etc.), streamflow peaks (day of peak and magnitudes), rating curves (stage vs. discharge curves), and National Weather Service Flood Stage categories (action, minor, flood, etc).

These additional data sources are very useful for conducting categorical evaluations using thresholds informed by statistics, peaks, or flood categories. Rating curves are required to translate flood stages to flood flows. Site metadata may be useful for any potential visualization tools, as well as being able to convert streamflow to areal averaged discharge (AKA "runoff" or "discharge per unit area").

@aaraney Let's discuss? Marking this as a draft, for now.

Additions

Removals

Changes

Testing

  1. Basic testing using monkeypatched MockRestClient and MockResponse using local testing data.

Notes

Todos

Checklist

jarq6c commented 3 days ago

Consider refactoring to use https://pypi.org/project/PyRDB/