nhdplusTools

1.5.0

NHDPlus Tools

8packages depend

30.1Kdownloads / year

80.8%test coverage

8/13checks pass

Overview

About

Maintained by David BlodgettFirst published 2019-08-2538 releasesCRAN page ↗GitHub ↗

Tools for traversing and working with National Hydrography Dataset Plus (NHDPlus) data. All methods implemented in 'nhdplusTools' are available in the NHDPlus documentation available from the US Environmental Protection Agency https://www.epa.gov/waterdata/basic-information.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("nhdplusTools", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("doi-usgs/nhdplusTools")

Development version from doi-usgs/nhdplusTools. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-nhdplustools

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-nhdplusTools

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-nhdplusTools

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

5NOTE8OK

Failing flavors

NOTE r-devel-linux-x86_64-debian-clang
NOTE r-devel-linux-x86_64-debian-gcc
NOTE r-devel-linux-x86_64-fedora-clang
NOTE r-devel-linux-x86_64-fedora-gcc
NOTE r-devel-windows-x86_64

Slowest check: 6.5 min · r-devel-linux-x86_64-fedora-clang

Code health

Yes

Tests · ratio 0.58

80.8%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

NOTE2026-07-16
11 OK · 2 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
OK2026-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-08
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-05-30
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-05-24
11 OK · 0 NOTE · 0 WARNING · 2 ERROR · 0 FAILURE

Show 3 earlier snapshots

OK2026-04-22
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-04-16
13 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 1,462 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 44%
Documented parameters: 99%
Return-value docs: 92%
References docs: 0%

Downloads

30.1K

CRAN downloads in the past year

Rank #2,148 · ~82/day · ~2.5K/mo

Releases R versions

Daily download trend is not available in this view yet.

2.1K30 days

11.1K90 days

30.1K1 year

Compare downloads with other packages →

Also on468 r2u36 autocran30 c2d4u

Repository

GitHub ↗ doi-usgs/nhdplustools

94Stars

37Forks

1Open issues

0Open PRs

34Releases

1,336Commits

13Contributors

License CC0-1.0 · 1,336 commits · Last activity 2026-07-16 · 0% stars, 30d

Stars over time

2025-07-08 · 892026-07-07 · 94

Repository practices

Upstream repositoryBeta

7 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/doi-usgs/nhdplustools on 2026-07-19.

Continuous integration (2)

GitHub ActionsGitLab CI

Reproducibility and dev environment (2)

data-raw/Dockerfile

Docs source (1)

README.Rmd

Lint, format, editor (1)

lintr

Show all practices

Git structural (1)

.gitattributes

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

32 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.1

Imports (22)

hydroloom dataRetrieval dplyr sf units magrittr jsonlite httr xml2 R.utilsutilstidyrmethodsmaptiles mapsf fst arrowtoolszip pbapply memoise digest

LinkingTo (0)

none

Suggests (13)

testthat knitr rmarkdown ggmap ggplot2 lwgeom gifski leaflet httptest future future.apply StreamCatTools terra

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

8direct

0indirect

StreamCatTools elfgen amadeus geospatialsuite hydroloom lakefetch manureshed ncdfgeom

Code & Tests

Code Composition

R 14,426 (66%)Rd 3,883 (18%)Vignettes 3,089 (14%)Other 549 (3%)

Code characteristics

Cyclomatic complexity: 3.0 median / 35 max
Test cases: 178 / 0.58 per code line

Test coverage

Line coverage

81%

Expression

78.3%

Tests / Examples

80.8% / – ex

Functions

181 70 exported

Complexity

5.1 avg / 35 max

Call network

181 nodes / 243 edges

Call graph

Open call graph →

Loading call graph…

Lowest coverage

181 functions

Function	Cyclo	Coverage
get_boundaries exp	3	0%
get_elev_along_path exp	1	0%
get_xs_point exp	1	0%
get_xs_points exp	1	0%
.onLoad	1	0%
check_res	2	0%

People & History

People (5)

Maintainer (1)

David Blodgett

Author, Maintainer

Authors (2)

David Blodgett

Author, Maintainer

Mike Johnson

Author · added in 0.3.10

Contributors (3)

Josh Erickson

Contributor · added in 0.5.0

Lauren Koenig

Contributor · added in 1.0.0

Marc Weber

Contributor · added in 0.5.0

Listed in earlier versions (1)

Michael Johnson

no longer listed · 0.3.9

Package Timeline

38 releases. Pick two to compare their code metrics. R releases are shown for context.

1.5.0Latest
2026-05-26 · current release · diff ↗
R
R 4.6.0 released · 2026-04-24
1.4.2
2026-01-21 · diff ↗
1.4.1
2025-12-05 · diff ↗
1.4.0
2025-11-19 · diff ↗
1.3.2
2025-06-10 · diff ↗
R
R 4.5.0 released · 2025-04-11
1.3.1
2025-02-15 · diff ↗
1.3.0
2024-12-18 · diff ↗
1.2.1
2024-06-05 · diff ↗
1.2.0
2024-05-28 · diff ↗
1.1.0
2024-05-14 · diff ↗
R
R 4.4.0 released · 2024-04-24
1.0.0
2023-10-02 · diff ↗
0.7.1
2023-08-31 · diff ↗
0.7.0
2023-08-29 · diff ↗

Show 32 earlier events

R
R 4.3.0 released · 2023-04-21
0.6.2
2023-03-10 · diff ↗
0.6.1
2022-12-07 · diff ↗
0.6.0
2022-11-28 · diff ↗
0.5.7
2022-09-16 · diff ↗
0.5.6
2022-08-08 · diff ↗
0.5.5
2022-07-20 · diff ↗
0.5.4
2022-07-19 · diff ↗
0.5.3
2022-05-27 · diff ↗
R
R 4.2.0 released · 2022-04-22
0.5.2
2022-04-08 · diff ↗
0.5.1
2022-03-01 · diff ↗
0.5.0
2022-02-22 · diff ↗
0.4.3
2021-08-18 · diff ↗
0.4.2
2021-06-23 · diff ↗
unarchivedReturned to CRAN
2021-06-23
archivedRemoved from CRAN
2021-05-22
policy violation on filespace access (.cache)
R
R 4.1.0 released · 2021-05-18
0.4.1
2021-05-16 · diff ↗
0.4.0
2021-04-02 · diff ↗
0.3.16
2020-11-13 · diff ↗
0.3.15
2020-09-15 · diff ↗
0.3.14
2020-08-03 · diff ↗
R
R 4.0.0 released · 2020-04-24
0.3.13
2020-04-01 · diff ↗
0.3.12
2020-01-11 · diff ↗
0.3.11
2019-11-07 · diff ↗
0.3.10
2019-10-18 · diff ↗
0.3.9
2019-10-16 · diff ↗
0.3.8
2019-08-27 · diff ↗
0.3.7
2019-08-25
R
R 3.6.0 released · 2019-04-26

Package metadata

First published: 2019-08-25
Total releases: 38 / 7 yrs
License: CC0
Minimum R: ≥ 4.1
Bundled data: 1.1 MB / 2 files
Download size: 2.0 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Appears in task views

Hydrological Data and Modeling

Report a problem with this page →