eyetools (version 0.9.2)

AOI_seq: Sequence analysis of area of interest entries

Description

Analyses the sequence of entries into defined AOI regions across trials. Can only be used with fixation data with a "fix_n" column denoting fixation events. Assumes that AOIs are non-overlapping and hasn't been tested with overlapping AOIs. Consecutive fixations within an AOI are grouped together as a single entry. Non-consecutive fixations in the same AOI (i.e., with an intervening fixation in no AOI) are treated as two separate entries.

Usage

AOI_seq(data, AOIs, AOI_names = NULL, progress = TRUE)

Value

a dataframe containing the sequence of entries into AOIs on each trial, entry/exit/duration time into AOI

Arguments

data

A dataframe with fixation data (from fixation_dispersion). Either single or multi participant 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.

progress

Display a progress bar

Examples

# \donttest{
data <- combine_eyes(HCL)
fix_d <- fixation_dispersion(data)

AOI_seq(fix_d, AOIs = HCL_AOIs)
# }