AOI_seq: Sequence analysis of area of interest entries

In eyetools: Analyse Eye Data

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)

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

Value

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

Examples

data <- combine_eyes(HCL)
fix_d <- fixation_dispersion(data)

AOI_seq(fix_d, AOIs = HCL_AOIs)

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