Skip to content

Data Model

The OpenET data model defines standardized objects for representing eye-tracking data across devices, APIs, and storage formats. These schemas are designed to be compatible with existing research standards such as Eye-tracking-BIDS, while also supporting real-time streaming APIs and device interoperability. Please use GitHub PRs, issues, or discussions to contribute or suggest changes.


Geom

Geom layer defines reusable geometric primitives, which serve as reusable blocks for all spatial representations

Coordinate

JSON Schema

Vector

JSON Schema

Angle

JSON Schema


Metadata

The metadata layer adds essential context, describing acquisition setups (hardware, session) and data organization (columns, signals).

Column

JSON Schema

Hardware

JSON Schema

Session

JSON Schema

Signals

JSON Schema


Raw

The raw layer represents raw signals from eye-tracking hardware such as eyelid state, eyeball position, gaze vectors, and pupil measurements.

Gaze

JSON Schema

eyeBall

JSON Schema

eyeLid

JSON Schema

Pupil

JSON Schema


Event

The event layer captures derived measures of fixations, saccades, blinks, etc., independent of device-specific detection methods.

JSON Schema

Fixation

JSON Schema

Saccade

JSON Schema


Metrics

Higher-order metrics computed from raw signals and events are defined in this layer.


Misc.

Misc. layer handles logistical and operational context such as authentication and network-related information.


Last update: March 20, 2026