op_plot_timeseries: Plot Keypoints with Facet Wrap

In duet: Analysing Non-Verbal Communication in Dyadic Interactions from Video Data

Plot Keypoints with Facet Wrap

Description

This function plots the specified keypoints over time with facet wrapping. It allows the user to overlay axes or separate them, and to filter the data by person. If the number of facets exceeds the max_facets limit, a warning is issued, and the function will not return a plot.

Usage

op_plot_timeseries(
  data,
  keypoints = NULL,
  free_y = TRUE,
  overlay_axes = FALSE,
  person = "both",
  max_facets = 10
)

Arguments

data	Data frame containing the keypoint data.
keypoints	Character vector of keypoints to include in the plot. When overlay_axes = TRUE, input keypoints as "0", "1", "2", etc. When overlay_axes = FALSE, input keypoints as "x0", "y0", "x1", "y1", etc.
free_y	Boolean indicating if the y-axis should be free in facet_wrap (default is TRUE).
overlay_axes	Boolean indicating if 'x' and 'y' columns should be overlaid in the same plot (default is FALSE).
person	Character string specifying which person to plot ("left", "right", or "both", default is "both").
max_facets	Integer indicating the maximum number of facets allowed (default is 10). If the total facets exceed this number, the function returns NULL with a warning.

Value

A ggplot object or NULL if the maximum number of facets is exceeded.

Examples

# Load example data from the package
data_path <- system.file("extdata/csv_data/dyad_1/A_body.csv", package = "duet")
data <- read.csv(data_path)

# Plot with overlay_axes = TRUE
op_plot_timeseries(data = data, keypoints = c("0", "1"), overlay_axes = TRUE, person = "both")

# Plot with overlay_axes = FALSE
op_plot_timeseries(data = data, keypoints = c("0", "1"), overlay_axes = FALSE, person = "left")

duet documentation built on April 3, 2025, 5:52 p.m.