BRAT

Riverscapes Report Card

BRAT is one of several tools developed by the Riverscapes Consortium. This report card communicates BRAT’s compliance with the Riverscape Consortium’s published tool standards.

Report Card Summary

Tool BRAT - Beaver Restoration Assessment Tool
Version 3.1.00
Date 2020-03-18
Assessment Team Bailey & Wheaton
Current Assessment operational Operational Grade
Target Status commercial Commercial Grade
Riverscapes Compliance Pending Pending
Assessment Rationale BRAT has been applied extensively throughout the Western US and in the UK. It has been used extensively to inform policy and planning and state-wide, regional and watershed extents, but also to inform restoration planning and design at the reach-scale. Others have applied the model, but for the most part it has been implemented by the USU ETAL team. It is well deserving of an Operational Grade.

reports_TRL_BRAT

Report Card Details

This tool’s discrimnation evaluation by the Riverscapes Consortium’s is:

Evaluation Key: None or Not Applicable: • Minimal or In Progress: • Functional: • Fully Developed:

Criteria Value Evaluation Comments and/or Recommendations
Tool Interface(s) : ArcPy Toolbox in ArcGIS Tool is a series of steps (wizard-driven) that is very specific to freely available US data.
Scale Network (reach scale resolution, watershed extent) This tool has been applied across entire states, regions and watersheds, resolving detail down to 250 m to 300 m length reaches of riverscape.
Language(s) and Dependencies Python with ArcPy Dependencies are well documented. ArcPy, NumPy_mkl and
scikit-fuzzy dependencies.
Vetted in Peer-Reviewed Literature Yes. Macfarlane et al. (2015) The existing capacity model is vetted, and the historical capacity model is well described. The version in the publication is 2.0, but the capacity model is basically the same in 3.0. Many of the risk, beaver management, conservation and restoration concepts have not yet been vetted in scholarly literature but have been applied, tested and vetted by many scientists and managers across the US and UK.
Source Code Documentation Source code is clearly organized and documented  
Open Source open-source with GNU General Public License v 3.0 Open source code, but code requires ArcGIS licenses to run.
User Documentation Installation, Tutorials with videos, and implementation tips Documentation is comprehensive, but could be streamlined, contains many out of date components (e.g. applies to V 2.0). It would be helpful to separate tutorials from a command reference. Also it would be helpful to have conceptual references.
Easy User Interface Tool is primarily accessed via ArcToolbox custom tools or command prompt. For a power ArcGIS user that is familiar with geoprocessing and really understands the model, they can make this work. However, the user experience is fragile, not very flexible and this is not an easy-to-use tool for end user. Most “users” or consumers of BRAT, do not run pyBRAT, but instead think of the “tool” as the outputs of the model.
Scalability Tool can be batched, and development team made major strides in implementing batch-processing (typically applied to HUC-8s). The scalability is functional, but requires lots of custom scripting, has unnecessary hard-coding built in, and requires extensive manual pre-processing and preparation of data.
Produces Riverscapes Projects Tool is outputing to disk data in a Rivescapes Project. Unfortunately, 3.1.00 is not producing Riverscapes Projects that are fully-compatible or registered with RAVE

Tool Output Utility

Criteria Value Evaluation Comments
RAVE- Compliant Riverscapes Projects ? Produces Riverscapes Project, but not RAVE-compliant Refactoring needed and add Project Type registration with program.xml in Program Repo and include all datasets and parameters in project file.
RAVE Business Logic Defined? Not for 3.1.00, but example exists for BETA sqlBRAT that is functional Simple to remedy. Projects do currently have ArcGIS layer packages following project structure and entirely symbolized.
Riverscapes Projects hosted in public-facing Riverscapes Warehouse(s) No. Data is primarily on USU Box Servers and some on DataBasin.org. Users are pointed to where publicly available data exists from here. The data is very, very difficult to find from the inconsistent and incomplete data pages. Warehousing is the goal, but in the meantime this could be made easier.
Riverscapes Projects connected to Web-Maps Not consistently. A proof of concept exist for Idaho BRAT, but has not been cartographically curated. Similarly, a DataBasin entry exists for Utah BRAT All old data sets should be made Web Map accessible and clear about what version they were produced from and what years they correspond to (i.e. Riverscapes Project metadata)
Riverscapes Projects connected to Field Apps Not publicly. Some simple Arc Data Collector field apps have been used, but they are not reliable, scalable or deployable to external audiences. Workflows and forms are well tested and vetted. This needs funding to develop as commercial, professional-grade reliable web app.

Developer Intent

The BRAT devleopment team are actively seeking funding to build a Commercial-Grade version of BRAT, which would:

  • Have an inviting web-map interface so non GIS-users can discover BRAT runs and explore them and interrogate them.
  • Making it easy for GIS users to download BRAT for use in RAVE with Riverscapes Projects
  • Encourage more user-interaction with BRAT outputs and crowd-sourcing of information to create ownership of outputs
    • Allow users to visualize dynamic outputs of BRAT through time
    • Allow users to upload their own BRAT projects
    • Allow users to provide their own inputs locally (@ a reach) and produce local realizations.
    • Allow users to upload (or make) their own beaver dam and activity observations
    • Allow discovery of past BRAT runs in Warehouse
    • Present transparent ranking of level of BRAT model curation or dataset rank and facilitate community commenting
    • Facilitate users paying modest prices (i.e. commercial) to have new runs or more carefully curated (validated, resolved, etc.) for a specific watershed and then share them with broader community

reports_TRL_BRAT

The development team at this point has already produced a beta version of a Production-Grade version of BRAT (sqlBRAT with no release yet), which will be necessary to support the Commercial-Grade product.

If you share this vision, get in touch with the developers to support/fund the effort.

The Riverscapes Consortium’s Techncial Committee provides report cards for tools either deemed as “riverscapes-compliant or “pending riverscapes-compliance.