A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

Recent Releases of nhdplusTools

nhdplusTools - Denali

nhdplusTools 1.3.1

  • added a web service client for the NHDPlusHR arcgis server get_nhdphr(). #415
  • removed deprecated discover_nldi_characteristics() and get_nldi_characteristics()

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs 2 months ago

nhdplusTools - memoise bug fix

This release fixes an issue with the cran build affecting web service caches.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs 11 months ago

nhdplusTools - v1.2.0

nhdplusTools 1.2.0

This release introduces a new data source: https://reference.geoconnex.us and a vignette providing a broad overview of data access with nhdplusTools.

  • Fixed bug with use of memoise cache #365
  • Added vignette("get_data_overview") for WaterSciCon24
  • Added get_geoconnex_reference() and discover_geoconnex_reference()

What's Changed

Full Changelog: https://github.com/DOI-USGS/nhdplusTools/compare/v1.1.0...v1.2.0

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs 11 months ago

nhdplusTools - v1.1.0

nhdplusTools 1.1.0

This release has a significant consolidation of code to work with web services.
It incorporates an ArcGIS REST service for the first time. It has very few
backward compatibility issues with previous versions and introduces new functions
and behavior.

A key change in behavior is the introduction of caching with the memoise package.
See #366, pull request #364, and documentation in nhdplusTools_cache_settings()
for more.

  • fixed nhd and nhdplushr urls #368
  • fix issue with nhdplusTools_data_dir() #365
  • fixed bug with large nhdplus downloads with empty tiles. #361
  • Added 3DHP_all service client. #363
  • Removed deprecated function get_huc12 and get_huc8
  • Updated documentation of get_huc() and other web service functions.
  • added nhdplusTools_cache_settings() to control use of a memoise cache. #366
  • fix minor bug related to binding nhdplushr data together. #380

https://doi-usgs.github.io/nhdplusTools/news/index.html#nhdplustools-110

What's Changed

Full Changelog: https://github.com/DOI-USGS/nhdplusTools/compare/v1.0.0...v1.1.0

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs 12 months ago

nhdplusTools - v1.0.0 Hydroloom

nhdplusTools 1.0.0

https://cran.r-project.org/package=nhdplusTools

nhdplusTools has been split into two packages. A new package hydroloom is now available. It contains all nhdplusTools functionality not related to specific dataset schemas. See this issue for details.

hydroloom

v1.0.0 should be backward compatible with v0.7 but deprecation warnings have been added and one previously deprecated function has been removed.

This release evolves nhdplusTools to use hydroloom as a core dependency. nhdplusTools now depends on hydroloom for all network navigation and indexing functionality that is not specific to the nhdplus data model or specific to a US-context.

Specific functions imported from hydroloom include:

  • hy
  • accumulate_downstream
  • add_levelpaths
  • add_pathlength
  • add_pfafstetter
  • add_streamlevel
  • add_streamorder
  • add_toids
  • disambiguate_indexes
  • fix_flowdir
  • get_hydro_location
  • get_node
  • get_partial_length
  • index_points_to_lines
  • index_points_to_waterbodies
  • make_fromids
  • make_index_ids
  • navigate_connected_paths
  • navigate_hydro_network
  • rename_geometry
  • rescale_measures
  • sort_network
  • st_compatibalize

See the hydroloom reference list for details about these functions.

With these functions migrated to hydroloom, a number of nhdplusTools functions are now deprecated in favor of the hyroloom implementation.

  • make_node_topology()
  • get_pfaf()
  • get_path_members()
  • get_path_lengths()
  • get_levelpaths()
  • get_terminal()
  • make_node_topology()

In v1.0.0, the download_nhd() function was added.

In v1.0.0, the stage_national_data (previously deprecated) function was removed.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 1 year ago

nhdplusTools - CRAN test fix

0.6.2 is a minor release to fix a breaking test on CRAN. See #334

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs about 2 years ago

nhdplusTools - DOI-USGS Update

This release alters URLS in the project to use the new repository URL.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 2 years ago

nhdplusTools - Updates for latest dataRetrieval

nhdplusTools 0.6.0

  • minor change to behavior of navigate_nldi the "origin" will always be named
    as such rather than the named 1-element list being dropped to a data.frame.
    https://github.com/DOI-USGS/dataRetrieval/issues/623
  • Address scalability issue with web service downloads. #308
  • Add ability to add node topology back to a edge list topology. #302

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 2 years ago

nhdplusTools - CRAN check fix and official VAA data release.

Data release with updated NHDPlusV2 network attributes now available at:

Blodgett, D.L., 2022, Updated CONUS river network attributes based on the E2NHDPlusV2 and NWMv2.1 networks: U.S. Geological Survey data release, https://doi.org/10.5066/P9W79I7Q.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 2 years ago

nhdplusTools - nhdplusTools v0.5.6

  • Update URL for NHDPlusV2 download
  • make geometry validity checks more robust

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 2 years ago

nhdplusTools - v0.5.5

v0.5.5 includes one bug fix regarding the precision handling in flowline indexing and some minor changes for CRAN checks that use web services.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs almost 3 years ago

nhdplusTools - v0.5.3

v0.5.3 is primarily bug fixes and enhancements.

One notable addition is the addition of the rpu_boundaries and vpu_boundaries datasets which provide simplified polygons around the RPU and VPU subset domains of the nhdplusV2 dataset.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs almost 3 years ago

nhdplusTools - nhdplusTools 0.5.2

Mike Johnson is now recognized as an author of nhdplusTools.

New citation:

> citation("nhdplusTools")

To cite nhdplusTools in publications, please use:

  Blodgett, D., Johnson, J.M., 2022, nhdplusTools: Tools for Accessing and
  Working with the NHDPlus, https://doi.org/10.5066/P97AS8JD

New Functions

  • map_nhdplus() works much the same as plot_nhdplus() but creates a leaflet map rather than a static plot.
  • get_nldi_index() is used to call the NLDI web service to retrieve a hydrologic location.

Improvements

  • get_flowline_index() and get_waterbody_index() units and projection handling was altered. Defaults for the search_radius input were changed. Coordinate reference system handling in geoprocessing now relies on the CRS of the provided points rather than the flowlines.
  • get_nldi_basin() now supports precise basin delineation via a logical "split" parameter as well as the option to retrieve un-simplified basin geometry.
  • All network-dependent functions in nhdplusTools now return a warning and NULL if the web servicee is unavailable or fails for other reasons. This is according to CRAN policy.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs about 3 years ago

nhdplusTools - Plotting scalability and CRAN Fixes

This release includes minor updates to plot_nhdplus that improves plots for large basins. Some bug fixes were included in this as well.

Other changes were for CRAN check issues that cropped up in v0.5.0.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs about 3 years ago

nhdplusTools - v0.5.0

https://usgs-r.github.io/nhdplusTools/news/index.html#nhdplustools-050

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs about 3 years ago

nhdplusTools - Back on CRAN

https://usgs-r.github.io/nhdplusTools/news/index.html

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs almost 4 years ago

nhdplusTools - CRAN Release

See news for details. https://usgs-r.github.io/nhdplusTools/news/index.html

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs almost 4 years ago

nhdplusTools - Subset and levelpaths optimizations

This is a minor release with primarily performance improvements and validations for compatibility with ArcPro.

  • subset_nhdplus() now validates geometry and ensures all outputs are in NAD83
  • subset_nhdplus() queries the NHDPlus database rather than loading then filtering
  • get_levelpaths() rewritten for performance. Package now uses data.table.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 4 years ago

nhdplusTools -

  • Added discover_nldi_characteristics() and get_nldi_characteristics()
  • Changed navigate_nldi() to use the new NLDI navigation end point. Distance is now required.
  • Fixed a bug in get_flowline_index() to handle multipart lines.
  • Added flowline_only input to plot_nhdplus() to improve scalability
  • Added streamorder filtering to subset_nhdplus() for download filtering.
  • Default behavior of plot_nhdplus() updated to improve scalability of large downloads.

https://usgs-r.github.io/nhdplusTools/news/index.html

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 4 years ago

nhdplusTools - nhdplusTools 0.3.14

  • Added get_node() to get top and bottom of a flowline.
  • Switched geospatial data dependency to use labs.waterdata.usgs.gov
  • Added subset_rpu() to enable subsetting the NHD by Raster Processing Unit
  • Added get_waterbody_index() to find associations between point locations and waterbodys.
  • Added ability to get multiple matches from get_flowline_index() with max_matches parameter.
  • Added ability to download flowlines in get_flowline_index() rather than requiring data to be loaded locally.

https://usgs-r.github.io/nhdplusTools/news/index.html

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 4 years ago

nhdplusTools - Plotting, NHDPlusHR, and more network attributes.

This release has been published on CRAN and includes numerous improvements since the last CRAN release. See package news for details.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 5 years ago

nhdplusTools - HR URL Update

The URL for NHDPlusHR changed. This release includes a couple other minor things. See news.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 5 years ago

nhdplusTools - Downloaders and minor updates to navigation behavior

This release combines 0.3.9 and 0.3.10 due to commit confusion.

  • Added name alignment function
  • Added ability to sort response of network navigation
  • Added downloader functions for more hydrography datasets
  • Change navigations to exclude requested catchment

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 5 years ago

nhdplusTools - CRAN Network Failure Fixes

nhdplusTools 0.3.8

  • Modified vignettes and examples to avoid web-service calls breaking CRAN build.
  • Added error handling to some web service requests.
  • Added CITATION and NEWS.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 5 years ago

nhdplusTools - Initial CRAN Release

nhdplusTools is now available on CRAN!

install.packages("nhdplusTools")

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 5 years ago

nhdplusTools - Levelpath ID and Documentation

This minor release improves introduces levelpath and hydrosequence to the refactor workflow. LevelPath is not used to determine what the upstream mainstem is in collapsing flowlines in the upstream direction. LevelPath is also carried through the process in a way that it is preserved from the source NHDPlus. It is then used directly in the catchment aggregation functionality.

A number of issues with linguistic consistency were also fixed. Work remains to make sure words like flowline, flowpath, and catchment are used in a consistent and logical way.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 6 years ago

nhdplusTools - Aggregate catchments.

This minor release adds a function that will collapse catchments into aggregate catchments based on a set of outlet catchment identifiers. The pkgdown site was also moved to a "dev" url to make it clear that this package is in heavy development. I expect that to be that to be the case until the next major release when the API and terminology used across the package will be revisited.

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 6 years ago

nhdplusTools - Add Catchment Join and Split Functionality

This minor release adds catchment polygon functionality to go along with the flowline refactor functionality released in v0.3.0. Some bug fixes and package cleanup was also taken care of. This introduces a dependency on the raster.

The attached nhdplusTools_0.3.1.tar.gz contains package source and vignettes. See the package down site for full documentation.

The catchment functionality can perform the kind of transformation shown in this gif.
cat

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 6 years ago

nhdplusTools - Initial Beta Release

This release marks the first beta release that should be considered serially complete. The package and documentation is by no means polished, but is ready for use and feedback from users is needed before knowing what should be next.

Please kick the tires, scale things up, test your favorite use cases, and register feedback in github issues.

Thanks!!!

Natural Resources - Water Supply and Quality - R
Published by dblodgett-usgs over 6 years ago