Delineate a river corridor on a spatial network. — delineate

The corridor edges on the two river banks are drawn on the provided spatial network starting from an initial guess of the corridor (based e.g. on the river valley).

Usage

delineate_corridor(
  network,
  river,
  corridor_init = 1000,
  max_width = 3000,
  max_iterations = 10,
  capping_method = "shortest-path"
)

Arguments

network

The spatial network to be used for the delineation

river

A (MULTI)LINESTRING simple feature geometry representing the river centerline

corridor_init

How to estimate the initial guess of the river corridor. It can take the following values:

numeric or integer: use a buffer region of the given size (in meters) around the river centerline
An sf::sf or sf::sfc object: use the given input geometry

max_width

(Approximate) maximum width of the corridor. The spatial network is trimmed by a buffer region of this size around the river

max_iterations

Maximum number of iterations employed to refine the corridor edges (see corridor_edge()).

capping_method

The method employed to connect the corridor edge end points (i.e. to "cap" the corridor). See cap_corridor() for the available methods

Value

A simple feature geometry representing the river corridor

Examples

if (FALSE) { # interactive()
bucharest_osm <- get_osm_example_data()
network <- rbind(bucharest_osm$streets, bucharest_osm$railways) |>
  as_network()
delineate_corridor(network, bucharest_osm$river_centerline)
}