Skip to content

NEWS.md

Latest commit

 

History

History
66 lines (57 loc) · 3.52 KB

NEWS.md

File metadata and controls

66 lines (57 loc) · 3.52 KB

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.