calculate_huc: Calculate HUC covariates

In amadeus: Accessing and Analyzing Large-Scale Environmental Data

Calculate HUC covariates

Description

Extract HUC IDs at point locations. Returns a data.frame object containing locs_id and HUC IDs.

Usage

calculate_huc(from, locs, locs_id = "site_id", geom = FALSE, ...)

Arguments

from	SpatVector(1). Output from process_huc().
locs	data.frame. character to file path, SpatVector, or sf object.
locs_id	character(1). Column within locations CSV file containing identifier for each unique coordinate location.
geom	FALSE/"sf"/"terra".. Should the function return with geometry? Default is FALSE, options with geometry are "sf" or "terra". The coordinate reference system of the sf or SpatVector is that of from.
...	Placeholders.

Value

a data.frame or SpatVector object

Author(s)

Insang Song

See Also

process_huc()

Examples

## NOTE: Example is wrapped in `\dontrun{}` as function requires a large
##       amount of data which is not included in the package.
## Not run: 
loc <- data.frame(id = "001", lon = -78.90, lat = 35.97)
calculate_huc(
  from = huc, # derived from process_huc() example
  locs = loc,
  locs_id = "id",
  geom = FALSE
)

## End(Not run)

amadeus documentation built on Jan. 27, 2026, 1:07 a.m.