Nature Conservancy releases upgraded Functional Flows Calculator with gauge map, alternate methods and API

SACRAMENTO, Calif. — The Nature Conservancy on Oct. 5 demonstrated a redesigned Functional Flows Calculator that the organization said standardizes quantification of the California environmental flows framework’s functional‑flow metrics, adds visualization tools and offers an API and downloadable code for batch processing.

Bronwyn Stanford, a scientist at The Nature Conservancy, showed the updated tool to the Environmental Flows Work Group. “The functional flows calculator quantifies each of the functional flow metrics for each year for an input time series,” Stanford said, describing how the calculator uses daily flows to produce year‑by‑year metrics and a summary alteration assessment.

What’s new: Stanford said the tool now includes a searchable map of USGS and CDEC gauges, metadata describing gauge records and whether the gauge is a least‑impaired reference, nine hydrologic stream classes used by the project team, additional dry‑season metrics, and an alternate calculation method tailored for flashy or highly altered rivers. The tool compares observational series to predicted natural functional flows and produces an alteration visualization showing which functional components (fall pulse, elevated wet‑season baseflow, wet‑season peak flows, spring recession and dry‑season baseflow) appear altered.

Technical access: Stanford said the calculator offers an API, R and Python code snippets for programmatic use, and a fully downloadable Python code base for users who need batch processing or local runs; the downloadable code provides the calculator’s functionality without the web visualizations, she said. The tool also includes documentation, a science and methodology page and an expanding FAQ.

Why this matters: The functional flows calculator operationalizes the California environmental flows (CEF) framework metrics, enabling managers, researchers and regulators to quantify year‑by‑year functional flow characteristics, to screen for alteration against modeled natural ranges and to export metric tables for downstream analysis. Stanford noted an earlier version of the calculator and said the update draws on seven years of application and feedback.

Questions and next steps: Work‑group members asked about stream‑class conventions and comparability with unimpaired flow products; Stanford said the calculator’s hydrologic stream classes were developed for the CEF work and that the tool’s comparison to predicted natural flows is by water‑year type rather than a direct year‑for‑year unimpaired flow reconstruction. She encouraged users to try the API and provide feedback; the team plans to continue populating the FAQ and to support users as adoption grows.

Ending: The Nature Conservancy is releasing the upgrade now and will accept user feedback; the calculator’s code, API and documentation are publicly available for practitioners who want to run metrics for gauges, upload their own daily‑flow series or perform batch analyses.