plot_AOI_growth {eyetools} | R Documentation |
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")
[Package eyetools version 0.9.2 Index]