spatial_edge_measures: Query spatial edge measures

In luukvdmeer/sfnetworks: Tidy Geospatial Networks

Query spatial edge measures

Description

These functions are a collection of edge measures in spatial networks.

Usage

edge_azimuth(degrees = FALSE)

edge_circuity(Inf_as_NaN = FALSE)

edge_length()

edge_displacement()

edge_segment_count()

Arguments

degrees	Should the angle be returned in degrees instead of radians? Defaults to FALSE.
Inf_as_NaN	Should the circuity values of loop edges be stored as NaN instead of Inf? Defaults to FALSE.

Details

Just as with all query functions in tidygraph, spatial edge measures are meant to be called inside tidygraph verbs such as mutate or filter, where the network that is currently being worked on is known and thus not needed as an argument to the function. If you want to use an algorithm outside of the tidygraph framework you can use with_graph to set the context temporarily while the algorithm is being evaluated.

Value

A numeric vector of the same length as the number of edges in the graph.

Functions

• edge_azimuth(): The angle in radians between a straight line from the edge startpoint pointing north, and the straight line from the edge startpoint and the edge endpoint. Calculated with st_geod_azimuth. Requires a geographic CRS.

• edge_circuity(): The ratio of the length of an edge linestring geometry versus the straight-line distance between its boundary nodes, as described in Giacomin & Levinson, 2015. DOI: 10.1068/b130131p.

• edge_length(): The length of an edge linestring geometry as calculated by st_length. If edges are spatially implicit, the straight-line distance between its boundary nodes is computed instead, using st_distance.

• edge_displacement(): The straight-line distance between the two boundary nodes of an edge, as calculated by st_distance.

• edge_segment_count(): The number of segments contained in the linestring geometry of an edge. Segments are those parts of a linestring geometry that do not contain any interior points.

Examples

library(sf, quietly = TRUE)
library(tidygraph, quietly = TRUE)

net = as_sfnetwork(roxel)

net |>
  activate(edges) |>
  mutate(azimuth = edge_azimuth())

net |>
  activate(edges) |>
  mutate(azimuth = edge_azimuth(degrees = TRUE))

net |>
  activate(edges) |>
  mutate(circuity = edge_circuity())

net |>
  activate(edges) |>
  mutate(length = edge_length())

net |>
  activate(edges) |>
  mutate(displacement = edge_displacement())

net |>
  activate(edges) |>
  mutate(n_segs = edge_segment_count())

luukvdmeer/sfnetworks documentation built on Nov. 21, 2024, 4:54 a.m.