# --------------------------------------------
# CITATION file created with {cffr} R package
# See also: https://docs.ropensci.org/cffr/
# --------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "flowcam" in publications use:'
type: software
license: AGPL-3.0-or-later
title: 'flowcam: Download and Animate USGS Stream-Gage Camera Images'
version: 0.1.0.9000
doi: 10.32614/CRAN.package.flowcam
identifiers:
- type: url
  value: https://connorb.r-universe.dev/flowcam
abstract: A tidy interface to the U.S. Geological Survey (USGS) National Imagery Management
  System (NIMS) API (<https://api.waterdata.usgs.gov/docs/nims/overview/>), which
  stores and serves images collected by stream-gage cameras at monitoring locations
  across the United States. Provides functions to discover cameras by NWIS site number
  or camera ID, list and filter available images by date and time, download images
  at multiple resolutions, and assemble downloaded frames into animated GIFs or MP4
  videos. Integrates with the 'dataRetrieval' package (<https://doi-usgs.github.io/dataRetrieval/>)
  to enrich camera records with watershed metadata (drainage area, hydrologic unit
  code, state, county) and to retrieve co-located streamflow, stage, or water-quality
  time series — enabling direct comparison of visual stream conditions with measured
  observations. API authentication uses the 'API_USGS_PAT' environment variable shared
  with 'dataRetrieval', so a single key covers both packages.
authors:
- family-names: Brown
  given-names: Connor
  email: ConnorBrown1996@gmail.com
  orcid: https://orcid.org/0000-0002-9680-8930
repository: https://connorb.r-universe.dev
repository-code: https://github.com/ConnorB/flowcam
commit: eaee206724ffc7d937310dab9fb65f2af561c7ab
url: https://connorb.github.io/flowcam/
date-released: '2026-05-09'
contact:
- family-names: Brown
  given-names: Connor
  email: ConnorBrown1996@gmail.com
  orcid: https://orcid.org/0000-0002-9680-8930
keywords:
- usgs
- stream gage
- streamgage
- hydrology
- water data
- river cameras
- NIMS
- NWIS
- timelapse
- flood monitoring
- camera images
- rstats