Changelog

hydrogeofetch is the renamed successor to nhdplusTools. The package scope has grown beyond NHDPlus, and the new name reflects its broader role as a hydrologic geospatial data access and network tool chain. nhdplusTools will remain on CRAN as a deprecation shim until October 2028.

New features

New get_3dhp_index() addresses (snaps) point features to the 3DHP network using the HydroAdd3D web service, returning the snapped location and elevation, the matched mainstem (as a geoconnex uri), the measure along the mainstem, and associated GNIS attributes.
New add_mainstems() joins geoconnex mainstem identifiers onto a table containing NHDPlusV2 (comid/featureid) or NHDPlusHR (nhdplusid) identifiers, using a cached lookup table from the ref_rivers release. #469
New check_mainstems() checks whether mainstem identifiers have been superseded by a newer reference release; new update_mainstems() re-indexes points with a known mainstem id onto its replacement using hydroloom::index_points_to_lines(). #470

Removed functions (moved to hydroloom)

Network analysis and spatial indexing functions that duplicated hydroloom have been removed. Users should call hydroloom directly. See the hydroloom reference for full documentation, especially the indexing and navigation sections.

get_flowline_index() → hydroloom::index_points_to_lines()
get_waterbody_index() → hydroloom::index_points_to_waterbodies()
disambiguate_flowline_indexes() → hydroloom::disambiguate_indexes()
get_UT(), get_DD() → hydroloom::navigate_hydro_network(x, start, "UT") / "DD"
get_UM(), get_DM() → hydroloom::navigate_hydro_network(x, start, "UM") / "DM" (note: the old wrappers also ran align_nhdplus_names, filtered, and supported sort/include arguments)
navigate_network() — workflow glue; use navigate_nldi() + subset_nhdplus() or hydroloom navigation directly
get_sorted() → hydroloom::sort_network()
get_pathlength() → hydroloom::add_pathlength()
get_streamorder() → hydroloom::add_streamorder()
get_streamlevel() → hydroloom::add_streamlevel()
get_levelpaths() → hydroloom::add_levelpaths()
get_pfaf() → hydroloom::add_pfafstetter()
get_terminal() → hydroloom::sort_network(x, split = TRUE)
calculate_total_drainage_area() → hydroloom::accumulate_downstream(x, "area")
calculate_arbolate_sum() → hydroloom::accumulate_downstream(x, "length")
get_path_members(), get_path_lengths() → hydroloom::navigate_connected_paths()
make_node_topology() → hydroloom::make_node_topology()
add_plus_network_attributes() → use hydroloom’s add_levelpaths(), add_pathlength(), accumulate_downstream() etc. directly

Removed re-exports

These hydroloom functions are no longer re-exported; call hydroloom::fn() directly:

st_compatibalize(), rename_geometry(), get_node(), fix_flowdir(), rescale_measures(), get_hydro_location(), get_partial_length()

Bug fixes

get_3dhp() queries by universalreferenceid are now chunked, avoiding the service gateway timeouts (HTTP 504) that previously caused large reachcode lookups to return NULL. #475
get_catchment_characteristics() no longer surfaces the benign arrow “discarded from R metadata” warnings from the parquet metadata roundtrip. #475

Other changes

prepare_nhdplus() is no longer exported; it remains available internally. #475
Documentation and example fixes throughout, following package review (#475): corrected get_nldi_basin() and get_split_catchment() example plotting, clearer messaging when the experimental get_xs_point() cross-section service is unavailable, broadened README scope language, and vignette setup and typo cleanups.

Dependency changes