Extract angular speed (peak or average speed) for a direction vector between a `min_time` and `max_time`.

Source: R/extract_movement_functions.R

You can supply timestamps to `min_time` and `max_time` (e.g timestamp of begin escape) to average over only a period. In both cases, you can either retrieve peak or average (default) angular speed.

extract_speed_angular(
  df,
  min_time = min(df$time),
  max_time = max(df$time),
  method = "mean",
  samplingrate = 10,
  direction = c(0, 0, 1)
)

Arguments

df

A movement or eyetracker data frame. Expected columns are either `rot_x`, `rot_y`, `rot_z`, or `gaze_direction_x`, `gaze_direction_y`, `gaze_direction_z`

min_time

minimum time in s (default: trial start)

max_time

maximum time in s (default: trial end)

method

whether to extract mean (default) or max

samplingrate

resampling rate

direction

Direction vector for which to compute the angular speed

Value

Peak or average 3-dimensional speed, between `min_time` and `max_time`.

Details

NOTE: to avoid an impact of tracker glitches, data are resampled at default rate of 10 Hz (movement) or 100 Hz (gaze) and median-smoothed over 3 data points (300 or 30 ms).