plot_AOI_growth: Plots absolute or proportional time spent in AOIs over time

In eyetools: Analyse Eye Data

Plots absolute or proportional time spent in AOIs over time

Description

A visualisation tool for plotting the changes in defined AOI regions across a single trial time.

Usage

plot_AOI_growth(
  data = NULL,
  pID_values = NULL,
  trial_values = NULL,
  AOIs = NULL,
  AOI_names = NULL,
  type = "abs",
  plot_time_not_in_AOI = FALSE
)

Arguments

data	raw data in standard raw data form (time, x, y, trial)
pID_values	specify particular values within 'pID' to plot data from certain participants
trial_values	can be used to select particular trials within the data
AOIs	A dataframe of areas of interest (AOIs), with one row per AOI (x, y, width_radius, height)
AOI_names	An optional vector of AOI names to replace the default "AOI_1", "AOI_2", etc. To omit AOIs from the plot, use NA in relevant vector position
type	either "abs" (absolute) or "prop" (proportion)
plot_time_not_in_AOI	boolean as to whether to include proportion of time spent outside AOIs

Value

a plot of the raw data

Examples

data <- combine_eyes(HCL)
data <- interpolate(data)
# plot absolute and then proportional
plot_AOI_growth(data = data, AOIs = HCL_AOIs, type = "abs")
plot_AOI_growth(data = data, AOIs = HCL_AOIs, type = "prop")

eyetools documentation built on June 18, 2025, 5:08 p.m.