Skip to contents

Plot Time Series of Keypoint Speed

Source: R/plot_speed_timeseries.R
plot_speed_timeseries.Rd

Creates a multi-panel visualization of keypoint speed data over time. Each keypoint gets its own panel showing its speed, useful for analyzing movement intensity and identifying potential tracking issues.

Usage

plot_speed_timeseries(data, y_max = NULL)

Arguments

data

A data frame containing tracked keypoint data with the following columns:

  • time: Numeric time values

  • keypoint: Factor specifying the keypoint names

  • x: x-coordinates

  • y: y-coordinates

y_max

Optional numeric value specifying the maximum value for the y-axis. If NULL (default), the y-axis limit is automatically determined from the data.

Value

A ggplot object combining individual time series plots for each keypoint using patchwork. The plots are stacked vertically with shared axes and legends.

See also

Examples

if (FALSE) { # \dontrun{
# Plot with automatic y-axis scaling
plot_speed_timeseries(movement_data)

# Plot with fixed maximum speed of 100
plot_speed_timeseries(movement_data, y_max = 100)
} # }