AOI_seq: Sequence analysis of area of interest entries

In tombeesley/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.

Usage

AOI_seq(
  data,
  AOIs,
  AOI_names = NULL,
  participant_ID = "participant_ID",
  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.
participant_ID	the variable that determines the participant identifier. If no column present, assumes a single participant
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, participant_ID = "pNum")

AOI_seq(fix_d, AOIs = HCL_AOIs, participant_ID = "pNum")

tombeesley/eyetools documentation built on Dec. 23, 2024, 12:36 a.m.