aoi_trajectory_features: Extract AOI growth-curve/trajectory features

In eyeprocess: Harmonize Eye-Tracking, Pupillometry, Biometrics, and Psychometric Process Data

Extract AOI growth-curve/trajectory features

Description

Converts AOI occupancy over binned time into orthogonal-polynomial trajectory coefficients. Coefficients summarize temporal shape and are not latent psychological traits by themselves.

Usage

aoi_trajectory_features(
  data,
  person = "person_id",
  trial = "trial_id",
  time = "time_ms",
  aoi = "aoi",
  bin_ms = 100,
  degree = 3L,
  aois = NULL
)

Arguments

data	Sample-level data.
person, trial, time, aoi	Column names.
bin_ms	Temporal bin width.
degree	Polynomial degree.
aois	Optional AOIs to encode; defaults to observed AOIs.

Value

An object of class "eye_aoi_trajectory", stored as a named list, with components "features", "aois", "degree", "bin_ms", "person", "trial", "caveat". It contains aOI growth-curve/trajectory features and associated metadata or diagnostics needed to interpret the result.

eyeprocess documentation built on Sept. 28, 2026, 5:08 p.m.