This report card communicates the Riverscape Context Tool’s compliance with the Riverscape Consortium’s published tool standards.
Report Card Summary
Tool | Riverscapes Context Tool |
Version | 1.2.2 |
Date | 2021-11-22 |
Assessment Team | Bailey, Wheaton & Gilbert |
Current Assessment | ![]() |
Target Status | ![]() |
Riverscapes Compliance | ![]() |
Assessment Rationale | The tool can be used to aggregate data anywhere the nationally available datasets used to drive many riverscapes tools are available, and produces riverscapes projects that are compatible with RAVE. These projects are also being uploaded to the riverscapes warehouse. The tool needs documentation, but qualifies for Production Grade. |
Report Card Details
This tool’s discrimination evaluation by the Riverscapes Consortium is:
Evaluation Key: None or Not Applicable: • Minimal or In Progress: • Functional: • Fully Developed:
Criteria | Value | Evaluation | Comments and/or Recommendations |
---|---|---|---|
Tool Interface(s) | : CLI = Command Line Interface | ||
Scale | Catchment scale | This tool is designed to aggregate data at the HUC catchment scale. Most commonly we run this at HUC 8 scale, but HUC 10 and HUC 12 runs have been run. HUC 6 runs are possible but get to be large projects and custom boundaries are possible. | |
Language(s) and Dependencies | Python | Package dependencies are open source | |
Vetted in Peer-Reviewed Literature | Yes | Not applicable. The datasets the tool gathers are vetted, nationally available datasets. | |
Source Code Documentation | Available at Github repository | Source code is clearly organized and documented | |
Open Source | open-source with GNU General Public License v 3.0 | ||
User Documentation | Documentation is in progress | Documentation is in progress but has not been published to the website | |
Easy User Interface | Tool is accessed via command prompt | The tool is primarily run by North Arrow Research analysts. For a user to run this version of the tool themselves would require advanced understanding (programming capability) and significant documentation on the process. A “web-store” was piloted where users could request a HUC 8, 10 or 12 and get a run produced in cloud for them and uploaded to warehouse. That works and is available by request, but will be added to Warehouse 2.0. | |
Scalability | batch-processing | Tool is typically batch processed at the HUC 8 level. If less layers are included, it can be run at larger scales. | |
Produces Riverscapes Projects ![]() |
Yes | Produces Riverscapes Projects that are fully-compatible with RAVE |
Tool Output Utility
Criteria | Value | Evaluation | Comments |
---|---|---|---|
RAVE- Compliant Riverscapes Projects ![]() |
Yes | ||
RAVE Business Logic Defined | Yes | ||
Riverscapes Projects hosted in public-facing Riverscapes Warehouse(s) ![]() |
Yes. Current Riverscape Context projects are being housed in the Riverscapes Warehouse. | There is data in the warehouse, but is provisional and wider access to the warehouse is forthcoming | |
Riverscapes Projects connected to Web-Maps | Yes | Current projects are viewable in WebRAVE through the Riverscapes Warehouse | |
Riverscapes Projects connected to Field Apps ![]() |
No | These can be used as basemaps or context layers with QField. |
Developer Intent
… The Riverscapes Context was one of our first production grade tools. It has worked extremely well and has now been successfully run on 2/3 of the 2800 HUC 8s in the United States and those projects are freely availalbe. In due course, a sponsor will pay to have it run for the rest of the US.
Future enhancements under consideration include:
- Updating RS_Conext to use geopackages instead of shapefiles for some of the vector feature classes it “wraps up”. The tool has tended not to change from the parent format of vectors (typically awful shapefiles with all their sidecar files), but it does change rasters into GeoTIFFs. There are many advantages to geopackages over shapefiles for vector data. If this is done, it will likely be with one geopackage for each data type source (e.g. one for NHD and one for Land Ownership).
- Continue to add new layers that are useful to users for context or as inputs to other production grade models. A running list is here
- Expand functionality so it can work for any user provided custom polygon extent (provided that underlyng context datasets exist for that area)
- Expand functionality to other countries (initially those that have consistent, good cartographic standards) and eventually to global datasets
The Riverscapes Consortium’s Technical Committee provides report cards for tools either deemed as “riverscapes-compliant”
or “pending riverscapes-compliance”
.