NEWS
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.