validate_vendor_timestamp_semantics: Validate vendor-specific timestamp semantics

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

Validate vendor-specific timestamp semantics

Description

The audit records expected semantics rather than silently coercing clocks. Tobii data can carry device/system timing; Pupil Labs Neon timestamps are high-resolution UTC nanoseconds in native recordings; Gazepoint may expose native monotonic and media-relative clocks depending on export type.

Usage

validate_vendor_timestamp_semantics(
  data,
  vendor,
  device_time = NULL,
  system_time = NULL,
  media_time = NULL
)

Arguments

data	Input data frame or compatible tabular object.
vendor	Vendor identifier.
device_time	Device timestamp column.
system_time	System timestamp column.
media_time	Media/stimulus timestamp column.

Value

An object of class "eye_vendor_timestamp_semantics", stored as a named list, with components "vendor", "pass", "clocks". It contains vendor-specific timestamp semantics and associated metadata or diagnostics needed to interpret the result.

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