Taps into APIs to get river gauge data and metadata. Two public API's are used. The first is the National Weather Service's National Water Prediction System (NWPS), and the second is the US Geological Survey's National Water Information System (NWIS). Note that data in NWPS is only for the last 30 days, so NWIS is also used to get historical data.
- NWPS API Documentation: https://api.water.noaa.gov/nwps/v1/docs/#/Gauges/Gauges_ListGauges
- NWIS API Documentation: https://waterservices.usgs.gov/
First off, the entire codebase works in Python 3. In addition to base Python, you will need the following packages installed:
- dataretrieval-python (aquire data from nwis)
- pandas and numpy (to slice and dice the data)
- matplotlib and cartopy (to plot the data)
The "easiest" way is to install these is by installing anaconda, and then applying conda-forge. Afterward, then you can install the above packages.