Changelog

Source: NEWS.md

flowcam 0.1.0.9000

Testing new features and improvements

• set_usgs_api_key() replaces set_nims_key(), which is now deprecated.
• New get_site_streamflow() retrieves instantaneous or daily discharge (or any USGS parameter) for a gage site, making it easy to pair visual camera conditions with measured flow data.
• find_gage_cameras() now correctly returns drainage_area and altitude columns (the previous names drain_area_va and alt_va were stale legacy column names that caused these fields to silently drop).

Expanded dataRetrieval integration

• New get_site_data_availability() returns the full list of parameter codes and periods of record available at a gage — a useful first step before calling get_site_streamflow().
• New get_flow_statistics() retrieves historical day-of-year percentile curves (type = "daily_normals") or annual/monthly period-of-record summaries (type = "period_summary"), providing context for interpreting what a camera is showing relative to historical norms.
• New get_site_field_measurements() retrieves manual discharge measurements made by USGS hydrographers, which can be compared directly against camera imagery taken at the same time.
• New get_network_cameras() uses the USGS Network Linked Data Index (NLDI) to find cameras on the same stream network, upstream and/or downstream of a given site.
• get_site_streamflow() now accepts multiple parameter_code values in a single call; all requested parameters are returned in one tibble.
• get_site_streamflow() gains a water_year argument: when TRUE, a water_year integer column (Oct 1 – Sep 30) is appended to the result.
• find_gage_cameras() gains an include_availability argument (default TRUE) that appends a data_types list-column with available time series from get_site_data_availability().

Bug fixes and improvements

• build_image_url() now errors immediately when camera_row has more than one row, rather than silently using the first row.
• find_cameras() now warns when a lat or lng value cannot be coerced to numeric, instead of producing a silent NA.
• get_flow_statistics() now warns when percentile or sample_count values cannot be coerced to integer, instead of silently producing NA.
• get_site_field_measurements(), get_site_streamflow(), and get_flow_statistics() now validate that parameter_code values are five-digit character strings (e.g. "00060"), matching the existing validation in get_site_streamflow().
• get_site_data_availability() and get_site_field_measurements() now share the same parameter_code validation as the other dataRetrieval functions.
• get_timelapse_url() now returns NULL invisibly (instead of an unusable URL) when timelapse is not enabled for a camera, while still issuing a warning.
• make_gif() / make_video() now warn when local image files have unparseable timestamps and will be excluded from time filtering.

flowcam 0.1.0

Initial release

• Query USGS NIMS API camera metadata with find_cameras() and find_gage_cameras().
• List available images for a camera with list_images().
• Build and retrieve timelapse image URLs with build_image_url() and get_timelapse_url().
• Download images to disk with download_images().
• Assemble animated GIFs from downloaded frames with make_gif().
• Assemble MP4 videos from downloaded frames with make_video() (requires the av package).
• API key management via set_usgs_api_key() and the API_USGS_PAT environment variable.