Contributions:EyetrackerLoggerSimulator

Synopsis

An extension that records data from a simulated eye tracker into event states.

Location

http://www.bci2000.org/svn/trunk/src/contrib/Extensions/EyetrackerLoggerSimulator

Versioning

Authors

Jürgen Mellinger (mellinger@neurotechcenter.org)

Version History

2021-12-02: initial version

Source Code Revisions

Initial development: 6455
Tested under: 6455
Known to compile under: 7762
Broken since: --

Functional Description

Uses user-defined expressions to compute gaze and eye position, updated in regular intervals. Simulated data are recorded into event states.

Integration into BCI2000

Compile the extension into your source module by enabling contributed extensions in your CMake configuration, and setting EXTENSIONS_EYETRACKERLOGGERSIMULATED=On. Once the extension is built into the source module, enable it by starting the source module with the --LogEyetrackerSimulator=1 command line argument.

Coordinate System

A simulated eye position and gaze is be expressed by 5 coordinate values,

GazeX: X coordinate of gaze position,
GazeY: Y coordinate of gaze position,
EyePosX: X coordinate of eye,
EyePosY: Y coordinate of eye,
EyeDist: Z coordinate of eye.

To preserve physical resolution, X, Y, and Z coordinates are first multiplied by 32767, and then subtracted with 32767 before being saved as integer values.

Parameters

User configurable Parameters

The eye tracker is configured in the Source tab within the EyetrackerLogger section.

LogEyetrackerTobiiPro

Set to 0 to disable the eye tracker logger.

State Variables

EyetrackerTime

Time stamp of eye data compatible with the SourceTime data time stamp.

EyetrackerLeftEyeGazeX, EyetrackerLeftEyeGazeY, EyetrackerRightEyeGazeX, EyetrackerRightEyeGazeY

Screen position where the simulated subject is looking at. Point (0,0) corresponds to the top left of the screen. Multiply each value by the unit given in the GazeResolution parameter in order to obtain the physical location relative to the screen's top left.

EyetrackerLeftEyePosX, EyetrackerLeftEyePosY, EyetrackerLeftEyeDist, EyetrackerRightEyePosX, EyetrackerRightEyePosY, EyetrackerRightEyeDist

Simulated eye position.