NEWS

StreamCatTools 0.11.0 (2026-05-14)

Adds new lc_get_watershed function to return a lake watershed as an sf feature for a LakeCat (NHDPlusV2 Waterbody) COMID from an S3-hosted, HUC2-partitioned GeoParquet dataset
Uses optional HUC2 query as well as retries, multi-threading and duckdb to speed up retrieval of spatial data from AWS S3 bucket

Adds new functions sc_get_nni() and lc_get_nni() for ease of access to National Nutrient Inventory data in StreamCat
Adds new functions sc_plot() and lc_plot for plotting nitrogen and phosphorus budgets for watersheds
Adds a new article describing functions for plotting National Nutrient Inventory data in StreamCat

Handles a web service being down in testing using testthat::skip_on_cran()
Converts most vignettes to articles and adds one new Start Here vignette =======

Addresses CRAN error generated by tests that is
Adds tryCatch handling for functions calling web services in order to fail gracefully and not produce errors
Adds documentation to vignettes for two new functions added to the package

Added code coverage to the package
Added two new functions - sc_get_metric_names and lc_get_metric_names to make metric names and descriptions more searchable and slightly updated parameters in both sc_get_params and lc_get_params functions
Both sc_get_data and lc_get_data now accept vectors as well as comma- separated strings for the metric, state, county and region parameters

Updated both sc_get_data and lc_get_data to pass parameters in POST request body rather than header, providing ability to pass lengthy lists of COMIDS to those requests
Fixed a bug in package tests that was causing an error when running testthat

Added functionality in sc_get_data and lc_get_data to accommodate large numbers (e.g. > 700) COMIDs in header for POST request

Overhauled sc_get_data and lc_get_data functions to be able to pull all metrics from StreamCat or LakeCat for an area of interest
Updated sc_get_data and lc_get_data to be able to pass hundreds of COMIDs at a time as a function parameter and not error out in call to server
Updated sc_get_params and lc_get_params to now return variable information, as well as just metric names and full names, and return tables of state and county abbreviations, names and FIPS codes

Overhauled all functions to use the new api.epa.gov endpoints for StreamCat described in swagger documentation
Streamlined sc_get_data and lc_get_data requests with httr2
Adopted functionality in all package functions to use the Oracle ORDs Database REST API rather than previous JAVA REST service

Incorporated POST requests in httr2 requests to deal with many COMIDs in requests
Added documentation to vignette for working with LakeCat data in the package

Fixed sc_get_data to pass COMIDs to function more robustly
Added sc_nlcd helper function to more easily grab NLCD based metrics from StreamCat
Updated package documentation

API is publicly released and the package works now for everyone (not just those inside EPA network)