CDEC Rating Tables

[narlesky]

Task

CDEC provides a number of flow-stage rating tables for river guidance points. These are sourced from USGS and 'LOGLOG2FLO'. Provide a Python binding for retrieving these rating tables as a series of paired flow and stage values, as well as relevant metadata. Primary function should follow pattern:

def get_station_rating_table(station):
    """
    content of the docstring
    """
    <...function logic...>
    returns {'data': <the resulting paired data, often a list or dataframe>,
             'info': { <dictionary of the rating table meta data> }}

Steps

• review catalog of rating tables at https://cdec.water.ca.gov/rtables/
• develop function to parse HTML stage rating table
• develop function to extract metadata from page (title, last revision date stamp, river basin, elevation, rating table number, curve, scale offset, other?)
• provide adequate error messaging for invalid station arguments
• develop function to retrieve list of stations with rating curve information
• integrate into collect.dwr.cdec module

Testing Goals

• Ensure function returns expected results for valid CDEC stations

Breaking Changes

None anticipated

Priority

TBD