Learn R Programming

gwavr

The goal of gwavr (Gee-waver) is to Get Water Attributes Visually in R (gwavr). This allows the user to point and click on areas within the United States and get back hydrological data, e.g. flowlines, catchments, basin boundaries, comids, etc. Most of the heavy lifting is done by the {nhdplusTools} (much thanks) as well as the {leaflet} extensions and all this package does is wrap them into a app. Enjoy!

Installation

You can install gwavr from CRAN:

install.packages('gwavr')

To install the development version of the gwavr package, you can install directly from GitHub:

# install.packages("devtools")
devtools::install_github("joshualerickson/gwavr")

Contributions

Contributions are welcome!

Current Functionality

There are a handful of functions right now that can help with getting water data visually: get_nhdplus_interactively(), get_nldi_interactively(), get_basin_interactively(), get_streamnetwork_interactively(), get_usgs_iv_interactively(), get_usgs_dv_interactively(), get_noaatlas_interactively(). Please read the manual for more information on how to use these functions.

Example

This is a basic example which shows you how to solve a common problem: getting water data without knowing the exact lat, lon via a shiny application.

library(gwavr)
## basic example code

nhdplus_data <- get_nhdplus_interactively()

## or for NLDI

nldi_data <- get_nldi_interactively()

Video

Copy Link

Version

Install

install.packages('gwavr')

Monthly Downloads

265

Version

0.3.3

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Joshua Erickson

Last Published

December 15th, 2025

Functions in gwavr (0.3.3)

rename_geometry

Rename Geometry Column
get_noaatlas_png

Get National Oceanic and Atmospheric Administration (NOAA) Atlas 14 Graphics
get_usgs_dv_interactively

Get United States Geologic Survey (USGS) Daily Flow Values Interactively
get_stream_network_interactively

Get Stream Network Interactively
get_usgs_iv_interactively

Get United States Geologic Survey (USGS) Instantaneous Flow Values Interactively
usgsinstModUI

Shiny Module UI for United States Geologic Survey (USGS) instantaneous values
streamnetworkMod

Shiny Module Server for stream networks
get_noaatlas

Get National Oceanic and Atmospheric Administration (NOAA) Atlas 14
get_nhdplus_interactively

Get NHDPlus Interactively
basinModUI

Shiny Module UI for basin generation
convert_sf_geocollection

Convert GEOMETRYCOLLECTION to POLYGONS
get_noaatlas_interactively

Get National Oceanic and Atmospheric Administration (NOAA) Atlas 14 Interactively
basinMod

Shiny Module Server for basin generation
get_basin_interactively

Get Watershed Basin Interactively
base_map

Base Map
add_select_script

Selecting for Leaflet
noaatlasMod

Shiny Module Server for National Oceanic and Atmospheric Administration (NOAA) Atlas 14
noaatlasModUI

Shiny Module UI for National Oceanic and Atmospheric Administration (NOAA) Atlas 14
get_nldi_interactively

Get Hydro Network-Linked Data Index (NLDI) Interactively
nhdplusModUI

Shiny Module UI for nhdplus
usgsdvModUI

Shiny Module UI for United States Geologic Survey (USGS) daily values
usgsinstMod

Shiny Module Server for United States Geologic Survey (USGS) instantaneous values
nhdplusMod

Shiny Module Server for nhdplus
streamnetworkModUI

Shiny Module UI for stream network generation
usgsdvMod

Shiny Module Server for United States Geologic Survey (USGS) daily values