User Guide

This guide provides examples of using some of TEEHR’s core features.

Fetching and Loading Data

TEEHR provides tools for fetching and loading hydrologic data into an efficient storage format (parquet). It currently supports both operational and retrospective National Water Model data as well as USGS streamflow data. Support for the Office of Water Prediction’s Nextgen data is also in development.

NWM Operational Point Data

NWM Operational Gridded Data

NWM Retrospective Point Data

NWM Retrospective Gridded Data

USGS Streamflow Data

Model Evaluation and Visualization with TEEHR

Once the timeseries data conforms to the data model, we can take advantage of TEEHR’s capabilities for quantifying and understanding model performance. The following example notebooks demonstrate how to use TEEHR to join timeseries and evaluate model performance through calculation of various metrics.

While mapping and plotting functionality is not yet available in TEEHR, we provide several examples of visualizing model output using the holoviews library.

Note: These notebooks were developed for the 2024 CIROH Developer’s Conference and can be also found here: RTIInternational/teehr-devcon24-workshop

Building a Simple TEEHR Dataset

Building a Joined Database

Evaluating and Visualizing Model Output, Ex. 1

Evaluating and Visualizing Model Output, Ex. 2