From 1abebf0e70dcb385d97fa7f8132cdd33bf8ba560 Mon Sep 17 00:00:00 2001 From: David Blodgett Date: Tue, 24 Dec 2024 12:44:57 -0600 Subject: [PATCH 1/2] initial implementation of nhdplushr service function. fixes #415 --- DESCRIPTION | 2 +- NAMESPACE | 1 + R/arcrest_tools.R | 46 +++++++++++------- R/get_hydro.R | 65 +++++++++++++++++++++++++- man/get_3dhp.Rd | 4 +- man/get_nhdphr.Rd | 80 ++++++++++++++++++++++++++++++++ man/query_usgs_arcrest.Rd | 8 ++-- nhdplusTools.Rproj | 1 + tests/testthat/test_arcrest.R | 8 ++-- tests/testthat/test_get_nhdphr.R | 23 +++++++++ 10 files changed, 212 insertions(+), 26 deletions(-) create mode 100644 man/get_nhdphr.Rd create mode 100644 tests/testthat/test_get_nhdphr.R diff --git a/DESCRIPTION b/DESCRIPTION index a0c93f19..14956775 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,7 +1,7 @@ Package: nhdplusTools Type: Package Title: NHDPlus Tools -Version: 1.3.0 +Version: 1.3.1 Authors@R: c(person(given = "David", family = "Blodgett", role = c("aut", "cre"), diff --git a/NAMESPACE b/NAMESPACE index 44924ca8..537594de 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -32,6 +32,7 @@ export(get_huc) export(get_hydro_location) export(get_levelpaths) export(get_nhdarea) +export(get_nhdphr) export(get_nhdplus) export(get_nhdplushr) export(get_nldi_basin) diff --git a/R/arcrest_tools.R b/R/arcrest_tools.R index 47a6f6bd..407a031a 100644 --- a/R/arcrest_tools.R +++ b/R/arcrest_tools.R @@ -1,15 +1,17 @@ -get_3dhp_service_info <- memoise::memoise(function() { +get_arcrest_service_info <- memoise::memoise(function(service = "3DHP_all") { - # TODO: support more services? - server <- "3DHP_all" + stopifnot(service %in% c("3DHP_all", "NHDPlus_HR")) url_base <- paste0(get("arcrest_root", envir = nhdplusTools_env), - server, + service, "/MapServer/") all_layers <- jsonlite::read_json(paste0(url_base, "?f=json")) - list(url_base = url_base, all_layers = all_layers) + id_name <- "id3dhp" + if(service == "NHDPlus_HR") id_name <- "nhdplusid" + + list(url_base = url_base, all_layers = all_layers, id = id_name) }) @@ -31,9 +33,9 @@ get_3dhp_service_info <- memoise::memoise(function() { #' @param ids character. A set of identifier(s) from the data #' type requested, for 3dhp, this is id3dhp. #' @param type character. Type of feature to return -#' ("hydrolocation", "flowline", "waterbody", "drainage area", "catchment"). -#' If NULL (default) a data.frame of available resources is returned -#' @param where character. An where clause to pass to the server. +#' If NULL (default) a data.frame of available types is returned +#' @param service character chosen from "3DHP_all", "NHDPlus_HR" +#' @param where character An where clause to pass to the server. #' @param t_srs character (PROJ string or EPSG code) or numeric (EPSG code). #' A user specified - target -Spatial Reference System (SRS/CRS) for returned objects. #' Will default to the CRS of the input AOI if provided, and to 4326 for ID requests. @@ -48,12 +50,13 @@ get_3dhp_service_info <- memoise::memoise(function() { #' @importFrom dplyr filter #' @importFrom methods as query_usgs_arcrest <- function(AOI = NULL, ids = NULL, - type = NULL, where = NULL, + type = NULL, service = NULL, + where = NULL, t_srs = NULL, buffer = 0.5, - page_size = 2000){ + page_size = 2000) { - si <- get_3dhp_service_info() + si <- get_arcrest_service_info(service) source <- data.frame(user_call = sapply(si$all_layers$layers, \(x) tolower(x$name)), layer = sapply(si$all_layers$layers, \(x) x$id)) @@ -73,7 +76,8 @@ query_usgs_arcrest <- function(AOI = NULL, ids = NULL, return(NULL) } - if(grepl(paste(sapply(group_layers, \(x) x$name), + if(length(group_layers) > 0 && + grepl(paste(sapply(group_layers, \(x) x$name), collapse = "|"), type, ignore.case = TRUE)) { layer_id <- filter(source, .data$user_call == !!type)$layer @@ -107,8 +111,14 @@ query_usgs_arcrest <- function(AOI = NULL, ids = NULL, if(!is.null(where)) stop("can't specify ids and where") - where <- paste0("id3dhp IN ('", - paste(ids, collapse = "', '"), "')") + if(si$id == "nhdplusid") { + where <- paste0(si$id, " IN (", + paste(ids, collapse = ", "), ")") + } else { + where <- paste0(si$id, " IN ('", + paste(ids, collapse = "', '"), "')") + } + } post_body <- list(where = where, @@ -186,8 +196,12 @@ query_usgs_arcrest <- function(AOI = NULL, ids = NULL, if(inherits(out[[1]], "data.frame")) { out <- bind_rows(unify_types(out)) - out <- check_valid(out[!duplicated(out[["id3dhp"]]), ], - out_prj = t_srs) + if("id3dhp" %in% names(out)) { + out <- check_valid(out[!duplicated(out[["id3dhp"]]), ], + out_prj = t_srs) + } else { + out <- check_valid(out, out_prj = t_srs) + } } else { diff --git a/R/get_hydro.R b/R/get_hydro.R index 5e63a71f..4d9a65d4 100644 --- a/R/get_hydro.R +++ b/R/get_hydro.R @@ -185,6 +185,9 @@ get_nwis <- function(AOI = NULL, t_srs = NULL, buffer = 20000){ #' for source data documentation. #' #' @inherit query_usgs_arcrest details return params +#' @param type character. Type of feature to return. e.g. +#' ("hydrolocation", "flowline", "waterbody", "drainage area", "catchment"). +#' If NULL (default) a data.frame of available types is returned #' @param ids character vector of id3dhp ids or mainstem uris #' @param universalreferenceid character vector of hydrolocation universal #' reference ids such as reachcodes @@ -248,7 +251,67 @@ get_3dhp <- function(AOI = NULL, ids = NULL, type = NULL, ids <- NULL } - query_usgs_arcrest(AOI, ids, type, where, t_srs, buffer, page_size) + query_usgs_arcrest(AOI, ids, type, "3DHP_all", where, t_srs, buffer, page_size) } +#' Get NHDPlusHR Data +#' @description +#' Calls the NHDPlus_HR web service and returns sf data.frames for the selected +#' layers. See https://hydro.nationalmap.gov/arcgis/rest/services/NHDPlus_HR/MapServer +#' for source data documentation. +#' +#' @inherit query_usgs_arcrest details return params +#' +#' @param type character. Type of feature to return e.g. +#' c("networknhdflowline", nonnetworknhdflowline", nhdwaterbody", "nhdpluscatchment"). +#' If NULL (default) a data.frame of available types is returned +#' +#' @param ids character vector of nhdplusid ids +#' +#' @param reachcode character vector of reachcodes +#' NOTE: performance of this query is currently very poor, +#' spatial queries are the primary use of this function. +#' +#' @export +#' @examples +#' \donttest{ +#' AOI <- sf::st_as_sfc(sf::st_bbox(c(xmin = -89.56684, ymin = 42.99816, +#' xmax = -89.24681, ymax = 43.17192), +#' crs = "+proj=longlat +datum=WGS84 +no_defs")) +#' +#' # get flowlines and hydrolocations +#' flowlines <- get_nhdphr(AOI = AOI, type = "networknhdflowline") +#' point <- get_nhdphr(AOI = AOI, type = "nhdpoint") +#' waterbody <- get_nhdphr(AOI = AOI, type = "nhdwaterbody") +#' +#' if(!is.null(waterbody) & !is.null(flowlines) & !is.null(point)) { +#' plot(sf::st_geometry(waterbody), col = "lightblue", border = "lightgrey") +#' plot(sf::st_geometry(flowlines), col = "blue", add = TRUE) +#' plot(sf::st_geometry(point), col = "grey", pch = "+", add = TRUE) } +#' +#' # given universalreferenceid (reachcodes), can query for them but only +#' # for hydrolocations. This is useful for looking up mainstem ids. +#' +#' get_nhdphr(reachcode = "13020101021927", type = "networknhdflowline") +#'} +get_nhdphr <- function(AOI = NULL, ids = NULL, type = NULL, + reachcode = NULL, + t_srs = NULL, buffer = 0.5, + page_size = 2000) { + + if(!is.null(reachcode) && !isTRUE(grepl("nhdplusgage|nhdpoint|networknhdflowline|nonnetworknhdflowline|flowdirection|nhdwaterbody", + type))) { + stop("reachcode not defined for ", type) + } + + where <- NULL + if(!is.null(reachcode)) { + where <- paste(paste0("reachcode IN ('", + paste(reachcode, collapse = "', '"), "')")) + if(!is.null(ids)) stop("can not specify both reachcode and other ids") + } + + query_usgs_arcrest(AOI, ids, type, "NHDPlus_HR", where, t_srs, buffer, page_size) + +} diff --git a/man/get_3dhp.Rd b/man/get_3dhp.Rd index 2653e0fd..95035b63 100644 --- a/man/get_3dhp.Rd +++ b/man/get_3dhp.Rd @@ -21,9 +21,9 @@ in any Spatial Reference System.} \item{ids}{character vector of id3dhp ids or mainstem uris} -\item{type}{character. Type of feature to return +\item{type}{character. Type of feature to return. e.g. ("hydrolocation", "flowline", "waterbody", "drainage area", "catchment"). -If NULL (default) a data.frame of available resources is returned} +If NULL (default) a data.frame of available types is returned} \item{universalreferenceid}{character vector of hydrolocation universal reference ids such as reachcodes} diff --git a/man/get_nhdphr.Rd b/man/get_nhdphr.Rd new file mode 100644 index 00000000..7b450f93 --- /dev/null +++ b/man/get_nhdphr.Rd @@ -0,0 +1,80 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/get_hydro.R +\name{get_nhdphr} +\alias{get_nhdphr} +\title{Get NHDPlusHR Data} +\usage{ +get_nhdphr( + AOI = NULL, + ids = NULL, + type = NULL, + reachcode = NULL, + t_srs = NULL, + buffer = 0.5, + page_size = 2000 +) +} +\arguments{ +\item{AOI}{sf (MULTI)POINT or (MULTI)POLYGON. An 'area of interest' can +be provided as either a location (sf POINT) or area (sf POLYGON) +in any Spatial Reference System.} + +\item{ids}{character vector of nhdplusid ids} + +\item{type}{character. Type of feature to return e.g. +c("networknhdflowline", nonnetworknhdflowline", nhdwaterbody", "nhdpluscatchment"). +If NULL (default) a data.frame of available types is returned} + +\item{reachcode}{character vector of reachcodes +NOTE: performance of this query is currently very poor, +spatial queries are the primary use of this function.} + +\item{t_srs}{character (PROJ string or EPSG code) or numeric (EPSG code). +A user specified - target -Spatial Reference System (SRS/CRS) for returned objects. +Will default to the CRS of the input AOI if provided, and to 4326 for ID requests.} + +\item{buffer}{numeric. The amount (in meters) to buffer a POINT AOI by for an +extended search. Default = 0.5} + +\item{page_size}{numeric default number of features to request at a time. Reducing +may help if 500 errors are experienced.} +} +\value{ +a simple features (sf) object or valid types if no type supplied +} +\description{ +Calls the NHDPlus_HR web service and returns sf data.frames for the selected +layers. See https://hydro.nationalmap.gov/arcgis/rest/services/NHDPlus_HR/MapServer +for source data documentation. +} +\details{ +The returned object(s) will have the same +Spatial Reference System (SRS) as the input AOI. If a individual or set of +IDs are used to query, then the default CRS of EPSG:4269 is +preserved. In all cases, a user-defined SRS can be passed to \code{t_srs} +which will override all previous SRS (either input or default). +All buffer and distance operations are handled internally using in +EPSG:5070 Albers Equal Area projection +} +\examples{ +\donttest{ +AOI <- sf::st_as_sfc(sf::st_bbox(c(xmin = -89.56684, ymin = 42.99816, + xmax = -89.24681, ymax = 43.17192), + crs = "+proj=longlat +datum=WGS84 +no_defs")) + +# get flowlines and hydrolocations +flowlines <- get_nhdphr(AOI = AOI, type = "networknhdflowline") +point <- get_nhdphr(AOI = AOI, type = "nhdpoint") +waterbody <- get_nhdphr(AOI = AOI, type = "nhdwaterbody") + +if(!is.null(waterbody) & !is.null(flowlines) & !is.null(point)) { +plot(sf::st_geometry(waterbody), col = "lightblue", border = "lightgrey") +plot(sf::st_geometry(flowlines), col = "blue", add = TRUE) +plot(sf::st_geometry(point), col = "grey", pch = "+", add = TRUE) } + +# given universalreferenceid (reachcodes), can query for them but only +# for hydrolocations. This is useful for looking up mainstem ids. + +get_nhdphr(reachcode = "13020101021927", type = "networknhdflowline") +} +} diff --git a/man/query_usgs_arcrest.Rd b/man/query_usgs_arcrest.Rd index 98d23004..a12046a7 100644 --- a/man/query_usgs_arcrest.Rd +++ b/man/query_usgs_arcrest.Rd @@ -8,6 +8,7 @@ query_usgs_arcrest( AOI = NULL, ids = NULL, type = NULL, + service = NULL, where = NULL, t_srs = NULL, buffer = 0.5, @@ -23,10 +24,11 @@ in any Spatial Reference System.} type requested, for 3dhp, this is id3dhp.} \item{type}{character. Type of feature to return -("hydrolocation", "flowline", "waterbody", "drainage area", "catchment"). -If NULL (default) a data.frame of available resources is returned} +If NULL (default) a data.frame of available types is returned} -\item{where}{character. An where clause to pass to the server.} +\item{service}{character chosen from "3DHP_all", "NHDPlus_HR"} + +\item{where}{character An where clause to pass to the server.} \item{t_srs}{character (PROJ string or EPSG code) or numeric (EPSG code). A user specified - target -Spatial Reference System (SRS/CRS) for returned objects. diff --git a/nhdplusTools.Rproj b/nhdplusTools.Rproj index 29736fb3..35418cc2 100644 --- a/nhdplusTools.Rproj +++ b/nhdplusTools.Rproj @@ -1,4 +1,5 @@ Version: 1.0 +ProjectId: 903deedb-5779-4eeb-a8bc-71f5168cf6f9 RestoreWorkspace: Default SaveWorkspace: Default diff --git a/tests/testthat/test_arcrest.R b/tests/testthat/test_arcrest.R index a078950f..0fcb6b63 100644 --- a/tests/testthat/test_arcrest.R +++ b/tests/testthat/test_arcrest.R @@ -61,12 +61,14 @@ test_that("basic 3dhp service requests", { xmax = -89.4, ymax = 43.1), crs = "+proj=longlat +datum=WGS84 +no_defs")) - expect_message(expect_s3_class(nhdplusTools:::query_usgs_arcrest(AOI), + expect_message(expect_s3_class(nhdplusTools:::query_usgs_arcrest(AOI, service = "3DHP_all"), "data.frame")) - expect_warning(expect_warning(nhdplusTools:::query_usgs_arcrest(AOI, type = "hydrolocation"))) + expect_warning(expect_warning(nhdplusTools:::query_usgs_arcrest(AOI, service = "3DHP_all", + type = "hydrolocation"))) - test_data <- nhdplusTools:::query_usgs_arcrest(AOI, type = "reach code, external connection") + test_data <- nhdplusTools:::query_usgs_arcrest(AOI, , service = "3DHP_all", + type = "reach code, external connection") expect_s3_class(test_data, "sf") }) diff --git a/tests/testthat/test_get_nhdphr.R b/tests/testthat/test_get_nhdphr.R new file mode 100644 index 00000000..33e31950 --- /dev/null +++ b/tests/testthat/test_get_nhdphr.R @@ -0,0 +1,23 @@ +test_that("get_nhdphr", { + + skip_on_cran() + + expect_error(get_nhdphr(reachcode = "01234", type = "test"), + "not defined") + + expect_error(get_nhdphr(reachcode = "01234", type = "networknhdflowline", + ids = "1"), + "can not specify both") + + f <- get_nhdphr(ids = "50001000103671", + type = "networknhdflowline") + + expect_equal(f$nhdplusid, 50001000103671) + + expect_s3_class(f, "sf") + + skip("performance") + f2 <- get_nhdphr(reachcode = f$reachcode, + type = "networknhdflowline") + +}) From 3f1b142c5171ae6e6a8e0c575b7d28335f251bcf Mon Sep 17 00:00:00 2001 From: David Blodgett Date: Tue, 24 Dec 2024 13:15:04 -0600 Subject: [PATCH 2/2] pkgdown and news --- NEWS.md | 5 + _pkgdown.yml | 1 + docs/404.html | 2 +- docs/DISCLAIMER.html | 2 +- docs/LICENSE.html | 2 +- docs/articles/index.html | 2 +- docs/authors.html | 2 +- docs/index.html | 2 +- docs/news/index.html | 8 +- docs/reference/get_3dhp.html | 6 +- docs/reference/get_nhdphr-1.png | Bin 0 -> 122035 bytes docs/reference/get_nhdphr.html | 349 +++++++++++++++++++++++++ docs/reference/index.html | 6 +- docs/reference/query_usgs_arcrest.html | 12 +- docs/sitemap.xml | 1 + 15 files changed, 384 insertions(+), 16 deletions(-) create mode 100644 docs/reference/get_nhdphr-1.png create mode 100644 docs/reference/get_nhdphr.html diff --git a/NEWS.md b/NEWS.md index 073b528c..0d6b9e2b 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,3 +1,8 @@ +nhdplusTools 1.3.1 +========== + +- added a web service client for the NHDPlusHR argis server `get_nhdphr()`. #415 + nhdplusTools 1.3.0 ========== diff --git a/_pkgdown.yml b/_pkgdown.yml index e2f57821..bc0b5164 100644 --- a/_pkgdown.yml +++ b/_pkgdown.yml @@ -6,6 +6,7 @@ reference: Functions that help get access data. (all U.S. context) - contents: - '`get_3dhp`' + - '`get_nhdphr`' - '`discover_geoconnex_reference`' - '`get_geoconnex_reference`' - '`download_nhdplushr`' diff --git a/docs/404.html b/docs/404.html index 9efb8e6e..a76f130b 100644 --- a/docs/404.html +++ b/docs/404.html @@ -39,7 +39,7 @@ nhdplusTools - 1.3.0 + 1.3.1 diff --git a/docs/DISCLAIMER.html b/docs/DISCLAIMER.html index 1c3ddcad..7d122bf2 100644 --- a/docs/DISCLAIMER.html +++ b/docs/DISCLAIMER.html @@ -17,7 +17,7 @@ nhdplusTools - 1.3.0 + 1.3.1 diff --git a/docs/LICENSE.html b/docs/LICENSE.html index 5bd3c7db..64639c67 100644 --- a/docs/LICENSE.html +++ b/docs/LICENSE.html @@ -17,7 +17,7 @@ nhdplusTools - 1.3.0 + 1.3.1 diff --git a/docs/articles/index.html b/docs/articles/index.html index c6652b5e..377c4c72 100644 --- a/docs/articles/index.html +++ b/docs/articles/index.html @@ -17,7 +17,7 @@ nhdplusTools - 1.3.0 + 1.3.1 diff --git a/docs/authors.html b/docs/authors.html index 30ddf960..26013f81 100644 --- a/docs/authors.html +++ b/docs/authors.html @@ -17,7 +17,7 @@ nhdplusTools - 1.3.0 + 1.3.1 diff --git a/docs/index.html b/docs/index.html index 88c2d696..09cc271a 100644 --- a/docs/index.html +++ b/docs/index.html @@ -40,7 +40,7 @@ nhdplusTools - 1.3.0 + 1.3.1 diff --git a/docs/news/index.html b/docs/news/index.html index 63926d52..6a073e15 100644 --- a/docs/news/index.html +++ b/docs/news/index.html @@ -17,7 +17,7 @@ nhdplusTools - 1.3.0 + 1.3.1 @@ -73,7 +73,11 @@

Changelog

- + +
+
+
  • improve performance of discover_nhdplus_id(). #417
  • update urls for NLDI and Geoserver to use api.water.usgs.gov
  • no longer check ring direction in get_nhdplushr() to avoid very slow run time on some polygon layers. #411
  • diff --git a/docs/reference/get_3dhp.html b/docs/reference/get_3dhp.html index 764a633a..98cdddc8 100644 --- a/docs/reference/get_3dhp.html +++ b/docs/reference/get_3dhp.html @@ -19,7 +19,7 @@ nhdplusTools - 1.3.0 + 1.3.1
@@ -108,9 +108,9 @@

Arguments

type
-

character. Type of feature to return +

character. Type of feature to return. e.g. ("hydrolocation", "flowline", "waterbody", "drainage area", "catchment"). -If NULL (default) a data.frame of available resources is returned

+If NULL (default) a data.frame of available types is returned

universalreferenceid
diff --git a/docs/reference/get_nhdphr-1.png b/docs/reference/get_nhdphr-1.png new file mode 100644 index 0000000000000000000000000000000000000000..ca2ba34bb85614effe439be7fa7272dd6274a296 GIT binary patch literal 122035 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%0A0^D?El$>%oeccEd#+TNAAPF?C) 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 literal 0 HcmV?d00001 diff --git a/docs/reference/get_nhdphr.html b/docs/reference/get_nhdphr.html new file mode 100644 index 00000000..4c92d1f3 --- /dev/null +++ b/docs/reference/get_nhdphr.html @@ -0,0 +1,349 @@ + +Get NHDPlusHR Data — get_nhdphr • nhdplusTools + + + + + + + + + + + diff --git a/docs/reference/index.html b/docs/reference/index.html index fcfd464c..2c19ac74 100644 --- a/docs/reference/index.html +++ b/docs/reference/index.html @@ -17,7 +17,7 @@ nhdplusTools - 1.3.0 + 1.3.1 @@ -79,6 +79,10 @@

Data Access get_3dhp()

Get 3DHP Data

+ +

get_nhdphr()

+ +

Get NHDPlusHR Data

discover_geoconnex_reference()

diff --git a/docs/reference/query_usgs_arcrest.html b/docs/reference/query_usgs_arcrest.html index 866fbba8..dcd5a3cb 100644 --- a/docs/reference/query_usgs_arcrest.html +++ b/docs/reference/query_usgs_arcrest.html @@ -18,7 +18,7 @@ nhdplusTools - 1.3.0 + 1.3.1 @@ -84,6 +84,7 @@

Query USGS Hydro ESRI Rest Server

AOI = NULL, ids = NULL, type = NULL, + service = NULL, where = NULL, t_srs = NULL, buffer = 0.5, @@ -108,12 +109,15 @@

Arguments

type

character. Type of feature to return -("hydrolocation", "flowline", "waterbody", "drainage area", "catchment"). -If NULL (default) a data.frame of available resources is returned

+If NULL (default) a data.frame of available types is returned

+ + +
service
+

character chosen from "3DHP_all", "NHDPlus_HR"

where
-

character. An where clause to pass to the server.

+

character An where clause to pass to the server.

t_srs
diff --git a/docs/sitemap.xml b/docs/sitemap.xml index 59499b6a..4a15c400 100644 --- a/docs/sitemap.xml +++ b/docs/sitemap.xml @@ -48,6 +48,7 @@ https://doi-usgs.github.io/nhdplusTools/reference/get_huc8.html https://doi-usgs.github.io/nhdplusTools/reference/get_levelpaths.html https://doi-usgs.github.io/nhdplusTools/reference/get_nhdarea.html +https://doi-usgs.github.io/nhdplusTools/reference/get_nhdphr.html https://doi-usgs.github.io/nhdplusTools/reference/get_nhdplus.html https://doi-usgs.github.io/nhdplusTools/reference/get_nhdplushr.html https://doi-usgs.github.io/nhdplusTools/reference/get_nldi_basin.html
+
+ + + +
+
+ + +
+

Calls the NHDPlus_HR web service and returns sf data.frames for the selected +layers. See https://hydro.nationalmap.gov/arcgis/rest/services/NHDPlus_HR/MapServer +for source data documentation.

+
+ +
+
get_nhdphr(
+  AOI = NULL,
+  ids = NULL,
+  type = NULL,
+  reachcode = NULL,
+  t_srs = NULL,
+  buffer = 0.5,
+  page_size = 2000
+)
+
+ +
+

Arguments

+ + +
AOI
+

sf (MULTI)POINT or (MULTI)POLYGON. An 'area of interest' can +be provided as either a location (sf POINT) or area (sf POLYGON) +in any Spatial Reference System.

+ + +
ids
+

character vector of nhdplusid ids

+ + +
type
+

character. Type of feature to return e.g. +c("networknhdflowline", nonnetworknhdflowline", nhdwaterbody", "nhdpluscatchment"). +If NULL (default) a data.frame of available types is returned

+ + +
reachcode
+

character vector of reachcodes +NOTE: performance of this query is currently very poor, +spatial queries are the primary use of this function.

+ + +
t_srs
+

character (PROJ string or EPSG code) or numeric (EPSG code). +A user specified - target -Spatial Reference System (SRS/CRS) for returned objects. +Will default to the CRS of the input AOI if provided, and to 4326 for ID requests.

+ + +
buffer
+

numeric. The amount (in meters) to buffer a POINT AOI by for an +extended search. Default = 0.5

+ + +
page_size
+

numeric default number of features to request at a time. Reducing +may help if 500 errors are experienced.

+ +
+
+

Value

+

a simple features (sf) object or valid types if no type supplied

+
+
+

Details

+

The returned object(s) will have the same +Spatial Reference System (SRS) as the input AOI. If a individual or set of +IDs are used to query, then the default CRS of EPSG:4269 is +preserved. In all cases, a user-defined SRS can be passed to t_srs +which will override all previous SRS (either input or default). +All buffer and distance operations are handled internally using in +EPSG:5070 Albers Equal Area projection

+
+ +
+

Examples

+
# \donttest{
+AOI <- sf::st_as_sfc(sf::st_bbox(c(xmin = -89.56684, ymin = 42.99816,
+                                   xmax = -89.24681, ymax = 43.17192),
+                                 crs = "+proj=longlat +datum=WGS84 +no_defs"))
+
+# get flowlines and hydrolocations
+flowlines <- get_nhdphr(AOI = AOI, type = "networknhdflowline")
+point <- get_nhdphr(AOI = AOI, type = "nhdpoint")
+waterbody <- get_nhdphr(AOI = AOI, type = "nhdwaterbody")
+
+if(!is.null(waterbody) & !is.null(flowlines) & !is.null(point)) {
+plot(sf::st_geometry(waterbody), col = "lightblue", border = "lightgrey")
+plot(sf::st_geometry(flowlines), col = "blue", add = TRUE)
+plot(sf::st_geometry(point), col = "grey", pch = "+", add = TRUE) }
+
+
+# given universalreferenceid (reachcodes), can query for them but only
+# for hydrolocations. This is useful for looking up mainstem ids.
+
+get_nhdphr(reachcode = "13020101021927", type = "networknhdflowline")
+#> Simple feature collection with 10 features and 82 fields
+#> Geometry type: LINESTRING
+#> Dimension:     XY
+#> Bounding box:  xmin: -105.9805 ymin: 36.17496 xmax: -105.9253 ymax: 36.21542
+#> Geodetic CRS:  WGS 84
+#>    permanent_identifier        fdate resolution  gnis_id  gnis_name   lengthkm
+#> 1             120928749 1.502237e+12          2 01385432 Rio Grande 0.12637349
+#> 2             120928746 1.502237e+12          2 01385432 Rio Grande 1.77445619
+#> 3             120928753 1.502237e+12          2 01385432 Rio Grande 0.10023801
+#> 4             120928745 1.502237e+12          2 01385432 Rio Grande 0.64380256
+#> 5             120928744 1.502237e+12          2 01385432 Rio Grande 1.96787731
+#> 6             120928752 1.502237e+12          2 01385432 Rio Grande 0.09364129
+#> 7             120928748 1.502237e+12          2 01385432 Rio Grande 0.35127735
+#> 8             120928754 1.502237e+12          2 01385432 Rio Grande 0.86485354
+#> 9             120928751 1.502237e+12          2 01385432 Rio Grande 0.07149613
+#> 10            120928747 1.502237e+12          2 01385432 Rio Grande 2.12124057
+#>         reachcode flowdir wbarea_permanent_identifier ftype fcode mainpath
+#> 1  13020101021927       1                   120932465   558 55800        0
+#> 2  13020101021927       1                   120932465   558 55800        0
+#> 3  13020101021927       1                   120932465   558 55800        0
+#> 4  13020101021927       1                   120932465   558 55800        0
+#> 5  13020101021927       1                   120932465   558 55800        0
+#> 6  13020101021927       1                   120932465   558 55800        0
+#> 7  13020101021927       1                   120932465   558 55800        0
+#> 8  13020101021927       1                   120932465   558 55800        0
+#> 9  13020101021927       1                   120932465   558 55800        0
+#> 10 13020101021927       1                   120932465   558 55800        0
+#>    innetwork visibilityfilter   nhdplusid vpuid streamleve streamorde
+#> 1          1          5000000 3.50006e+13  1302          4          8
+#> 2          1          5000000 3.50006e+13  1302          4          8
+#> 3          1          5000000 3.50006e+13  1302          4          8
+#> 4          1          5000000 3.50006e+13  1302          4          8
+#> 5          1          5000000 3.50006e+13  1302          4          8
+#> 6          1          5000000 3.50006e+13  1302          4          8
+#> 7          1          5000000 3.50006e+13  1302          4          8
+#> 8          1          5000000 3.50006e+13  1302          4          8
+#> 9          1          5000000 3.50006e+13  1302          4          8
+#> 10         1          5000000 3.50006e+13  1302          4          8
+#>    streamcalc    fromnode      tonode    hydroseq  levelpathi pathlength
+#> 1           8 3.50006e+13 3.50006e+13 3.50006e+13 3.50001e+13   2706.329
+#> 2           8 3.50006e+13 3.50006e+13 3.50006e+13 3.50001e+13   2704.203
+#> 3           8 3.50006e+13 3.50006e+13 3.50006e+13 3.50001e+13   2699.370
+#> 4           8 3.50006e+13 3.50006e+13 3.50006e+13 3.50001e+13   2703.560
+#> 5           8 3.50006e+13 3.50006e+13 3.50006e+13 3.50001e+13   2701.592
+#> 6           8 3.50006e+13 3.50006e+13 3.50006e+13 3.50001e+13   2706.527
+#> 7           8 3.50006e+13 3.50006e+13 3.50006e+13 3.50001e+13   2705.978
+#> 8           8 3.50006e+13 3.50006e+13 3.50006e+13 3.50001e+13   2698.505
+#> 9           8 3.50006e+13 3.50006e+13 3.50006e+13 3.50001e+13   2706.455
+#> 10          8 3.50006e+13 3.50006e+13 3.50006e+13 3.50001e+13   2699.470
+#>     terminalpa arbolatesu divergence startflag terminalfl  uplevelpat
+#> 1  3.50001e+13   33149.18          1         0          0 3.50001e+13
+#> 2  3.50001e+13   33152.93          0         0          0 3.50001e+13
+#> 3  3.50001e+13   33165.89          1         0          0 3.50001e+13
+#> 4  3.50001e+13   33158.34          0         0          0 3.50001e+13
+#> 5  3.50001e+13   33161.50          0         0          0 3.50001e+13
+#> 6  3.50001e+13   33145.15          0         0          0 3.50001e+13
+#> 7  3.50001e+13   33150.69          0         0          0 3.50001e+13
+#> 8  3.50001e+13   33166.75          1         0          0 3.50001e+13
+#> 9  3.50001e+13   33149.05          0         0          0 3.50001e+13
+#> 10 3.50001e+13   33165.79          0         0          0 3.50001e+13
+#>     uphydroseq dnlevel  dnlevelpat  dnhydroseq  dnminorhyd dndraincou frommeas
+#> 1  3.50006e+13       4 3.50001e+13 3.50006e+13 0.00000e+00          1 96.38273
+#> 2  3.50006e+13       4 3.50001e+13 3.50006e+13 0.00000e+00          1 70.06044
+#> 3  3.50006e+13       4 3.50001e+13 3.50006e+13 3.50006e+13          2 10.61793
+#> 4  3.50006e+13       4 3.50001e+13 3.50006e+13 0.00000e+00          1 62.06700
+#> 5  3.50006e+13       4 3.50001e+13 3.50006e+13 0.00000e+00          1 37.84511
+#> 6  3.50006e+13       4 3.50001e+13 3.50006e+13 0.00000e+00          1 98.83942
+#> 7  3.50006e+13       4 3.50001e+13 3.50006e+13 0.00000e+00          1 92.04084
+#> 8  3.50006e+13       4 3.50001e+13 3.50006e+13 0.00000e+00          1  0.00000
+#> 9  3.50006e+13       4 3.50001e+13 3.50006e+13 3.50006e+13          2 97.95167
+#> 10 3.50006e+13       4 3.50001e+13 3.50006e+13 3.50006e+13          2 11.85308
+#>       tomeas rtndiv thinner vpuin vpuout   areasqkm totdasqkm divdasqkm
+#> 1   97.95167      0    <NA>     0      0 0.01670001  15674.28  14789.65
+#> 2   92.04084      1    <NA>     0      0 2.64680001  15678.19  14793.55
+#> 3   11.85308      0    <NA>     0      0 0.08019999  15694.47  14809.84
+#> 4   70.06044      0    <NA>     0      0 1.28390001  15682.44  14797.80
+#> 5   62.06700      0    <NA>     0      0 3.88990000  15687.72  14803.08
+#> 6  100.00000      0    <NA>     0      0 0.03410001  15671.63  14787.00
+#> 7   96.38273      0    <NA>     0      0 0.08129999  15675.28  14790.65
+#> 8   10.61793      0    <NA>     0      0 0.06200002  15694.54  14809.90
+#> 9   98.83942      0    <NA>     0      0 0.01359998  15674.26  14789.63
+#> 10  37.84511      0    <NA>     0      0 4.35159998  15694.39  14809.76
+#>    maxelevraw minelevraw maxelevsmo minelevsmo      slope slopelenkm elevfixed
+#> 1       -9998     177474     177652     177474 0.01408523 0.12637349      <NA>
+#> 2       -9998     177019     177269     177051 0.00122855 1.77445619      <NA>
+#> 3       -9998     175774     175780     175780 0.00001000 0.10023801      <NA>
+#> 4       -9998     176572     177051     176672 0.00588690 0.64380256      <NA>
+#> 5       -9998     176567     176672     176590 0.00041669 1.96787731      <NA>
+#> 6       -9998     177678     177678     177678 0.00001000 0.09364129      <NA>
+#> 7       -9998     177262     177474     177269 0.00583584 0.35127735      <NA>
+#> 8       -9998     175728     175780     175780 0.00001000 0.86485354      <NA>
+#> 9       -9998     177652     177678     177652 0.00363656 0.07149613      <NA>
+#> 10      -9998     175714     176590     175780 0.00381852 2.12124057      <NA>
+#>    hwtype hwnodesqkm statusflag     qama     vama qincrama     qbma     vbma
+#> 1    <NA>       <NA>          A 3714.387 3.536884 0.000243 3714.387 3.536884
+#> 2    <NA>       <NA>          A 3714.445 2.499065 0.039421 3714.445 2.499065
+#> 3    <NA>       <NA>          A 3714.690 1.328012 0.001217 3714.690 1.328012
+#> 4    <NA>       <NA>          A 3714.507 3.118966 0.018690 3714.507 3.118966
+#> 5    <NA>       <NA>          A 3714.584 2.153226 0.056736 3714.584 2.153226
+#> 6    <NA>       <NA>          A 3714.347 1.327770 0.000496 3714.347 1.327770
+#> 7    <NA>       <NA>          A 3714.402 3.114867 0.001184 3714.402 3.114867
+#> 8    <NA>       <NA>          A 3714.691 1.328012 0.000931 3714.691 1.328012
+#> 9    <NA>       <NA>          A 3714.387 2.911523 0.000198 3714.387 2.911523
+#> 10   <NA>       <NA>          A 3714.689 2.932359 0.068250 3714.689 2.932359
+#>    qincrbma     qcma     vcma   qincrcma     qdma     vdma   qincrdma     qema
+#> 1  0.000243 3714.387 3.536884 0.00024300 3714.387 3.536884 0.00024300 1711.386
+#> 2  0.039421 3714.445 2.499065 0.04207118 3714.445 2.499065 0.04207118 1711.444
+#> 3  0.001217 3714.690 1.328012 0.00121700 3714.690 1.328012 0.00121700 1711.690
+#> 4  0.018690 3714.507 3.118966 0.04763696 3714.507 3.118966 0.04763696 1711.506
+#> 5  0.056736 3714.584 2.153226 0.07050796 3714.584 2.153226 0.07050796 1711.583
+#> 6  0.000496 3714.347 1.327770 0.42352419 3714.347 1.327770 0.42352419 1711.347
+#> 7  0.001184 3714.402 3.114867 0.01036309 3714.402 3.114867 0.01036309 1711.401
+#> 8  0.000931 3714.691 1.328012 0.00093100 3714.691 1.328012 0.00093100 1711.691
+#> 9  0.000198 3714.387 2.911523 0.02664062 3714.387 2.911523 0.02664062 1711.386
+#> 10 0.068250 3714.689 2.932359 0.09319502 3714.689 2.932359 0.09319502 1711.688
+#>        vema   qincrema     qfma   qincrfma arqnavma petma qlossma qgadjma
+#> 1  3.340468 0.00024300 1711.386 0.00024300        0     0       0       0
+#> 2  2.365791 0.04207118 1711.444 0.04207118        0     0       0       0
+#> 3  1.265987 0.00121700 1711.690 0.00121700        0     0       0       0
+#> 4  2.947984 0.04763696 1711.506 0.04763696        0     0       0       0
+#> 5  2.040998 0.07050796 1711.583 0.07050796        0     0       0       0
+#> 6  1.265752 0.42352419 1711.347 0.42352419        0     0       0       0
+#> 7  2.944127 0.01036309 1711.401 0.01036309        0     0       0       0
+#> 8  1.265988 0.00093100 1711.691 0.00093100        0     0       0       0
+#> 9  2.753153 0.02664062 1711.386 0.02664062        0     0       0       0
+#> 10 2.772740 0.09319502 1711.688 0.09319502        0     0       0       0
+#>    qgnavma gageadjma avgqadjma gageidma gageqma Shape_Length
+#> 1        0         1         0        0       0    157.84395
+#> 2        0         1         0        0       0   2212.36438
+#> 3        0         1         0        0       0    124.42048
+#> 4        0         1         0        0       0    804.11669
+#> 5        0         1         0        0       0   2441.27200
+#> 6        0         1         0        0       0    116.80600
+#> 7        0         1         0        0       0    437.25416
+#> 8        0         1         0        0       0   1070.42970
+#> 9        0         1         0        0       0     89.30904
+#> 10       0         1         0        0       0   2621.91428
+#>                          geometry
+#> 1  LINESTRING (-105.9271 36.21...
+#> 2  LINESTRING (-105.9317 36.21...
+#> 3  LINESTRING (-105.9782 36.18...
+#> 4  LINESTRING (-105.9499 36.20...
+#> 5  LINESTRING (-105.957 36.209...
+#> 6  LINESTRING (-105.9253 36.21...
+#> 7  LINESTRING (-105.9285 36.21...
+#> 8  LINESTRING (-105.9774 36.18...
+#> 9  LINESTRING (-105.9263 36.21...
+#> 10 LINESTRING (-105.972 36.197...
+# }
+
+
+
+ +
+ + +