Skip to contents

Per-trajectory turning-rate summary for a Tracks

Source: R/track_metrics.R
track_turning.Rd

Summarises each trajectory's [angular_velocity()] (signed turning rate, counter-clockwise positive) by the chosen statistic.

Usage

track_turning(
  ts,
  stat = c("mean_abs", "mean", "max_abs", "median_abs"),
  units = c("radians", "degrees"),
  x_col = ts@cols$x,
  y_col = ts@cols$y
)

Arguments

ts

A `Tracks`.

stat

`"mean_abs"` (default) the typical turning magnitude; `"mean"` the signed net bias (opposite turns cancel); `"max_abs"` the sharpest turn; `"median_abs"` a robust turning magnitude.

units

`"radians"` per second (default) or `"degrees"` per second.

x_col, y_col

Names of the coordinate columns. Default to the `Tracks`'s recorded x/y columns.

Value

A `data.frame` with one row per trajectory: the id column and a numeric `turning` column (`NA` for tracks with fewer than three points).

See also

[angular_velocity()], [track_velocity()], [track_speed()]