Per-trajectory tortuosity ratio for a Tracks

Computes [path_tortuosity()] for each trajectory in a `Tracks`, ordering each trajectory's points by its time column when one is recorded.

Usage

tortuosity_ratio(ts, x_col = ts@cols$x, y_col = ts@cols$y)

Arguments

ts

A `Tracks`.

x_col, y_col

Names of the coordinate columns to use. Default to the `Tracks`'s recorded x/y columns (the real recorded positions), so the metric reflects the physical path rather than any display transform.

Value

A `data.frame` with one row per trajectory: the `Tracks`'s id column and a numeric `tortuosity` column (`>= 1`, possibly `Inf`).

See also

[path_tortuosity()], [straightness_index()]

Examples

head(tortuosity_ratio(cpunctatus))
#>         trial_id tortuosity
#> 10_1_1    10_1_1   1.390284
#> 10_10_1  10_10_1  10.103932
#> 10_11_1  10_11_1   1.250880
#> 10_12_1  10_12_1   1.212296
#> 10_13_1  10_13_1   1.565293
#> 10_14_1  10_14_1   1.068591