fwa_watershed_at_measure: Freshwater Atlas Watershed at Downstream Route Measure

In poissonconsulting/fwapgr: Client for BC Freshwater Atlas fwapg API

Freshwater Atlas Watershed at Downstream Route Measure

Description

Gets a polygon of the watershed at a specified river metre.

Usage

fwa_watershed_at_measure(
  blue_line_key,
  downstream_route_measure = 0,
  bbox = NULL,
  properties = NULL,
  transform = NULL,
  epsg = 4326,
  nocache = getOption("fwa.nocache", FALSE)
)

Arguments

blue_line_key	A positive whole number of the stream blue line key.
downstream_route_measure	A positive number of the river metre.
bbox	A vector of four numbers indicating bounding box to limit output features to, e.g. c(minLon, minLat, maxLon, maxLat).
properties	A vector of strings of the column names to include. If NULL (default), all columns are retained.
transform	A character vector with the name of the valid transform function followed by the parameter values (e.g. c("ST_Simplify", 100))
epsg	A positive whole number of the epsg to transform features to.
nocache	A flag specifying whether or not to cache results.

Details

The function selects and aggregate all the fundamental watershed polygons upstream of the fundamental watershed in which the point lies.

Depending on where the point is in the fundamental watershed one of four things can happen to the fundamental watershed.

1. If the point is < 50 m upstream from the bottom of the fundamental watershed then the fundamental watershed is included in the aggregation (recorded as KEEP in the refine_method property).

2. Else if the point is < 100m downstream from the top of the fundamental watershed then the fundamental watershed is not included in the aggregation (recorded as DROP in the refine_method property).

3. Else if the point is on a polygonal river/canal the fundamental watershed is cut across the banks of the river before being included in the aggregation (recorded as CUT in the refine_method property).

4. Otherwise something else happens (recorded as DEM in the refine_method property).

Value

An sf object.

See Also

API documentation

Other functions: fwa_index_point(), fwa_locate_along(), fwa_locate_along_interval(), fwa_watershed_hex(), fwa_watershed_stream(), hydroshed()

Examples

fwa_watershed_at_measure(356308001, downstream_route_measure = 10000)

poissonconsulting/fwapgr documentation built on Nov. 3, 2024, 2:06 p.m.