Tobbi picture
Description of the output file

The output file could be opened as CSV file, so it can be readed as plain text file or using some spreadsheet application such as Excel.
The first part of the list contains the data that is processed in the eye tracker and sent to Tobii Studio, and the second part of the list shows the data that is further processed in Tobii Studio [1].

Eye tracker gaze data:
Field Description Values
Timestamp Shows the timestamp, in milliseconds, of when the gaze data was collected.
Gaze PointXLeft Horizontal screen position of the gaze point for the left eye. 0 is the left edge, the maximum value of the horizontal screen resolution is the right edge.
GazePointYLeft Vertical screen position of the gaze point for the left eye. 0 is the bottom edge, the maximum value of the vertical screen resolution is the right edge.
CamXLeft Horizontal location of the left pupil in the camera image. 0 is the left edge, 1 is the right edge.
CamYLeft Vertical location of the left pupil in the camera image. 0 is the left edge, 1 is the right edge.
DistanceLeft Distance from the eye tracker to the left eye. The distance is given in mm on a straight axis, directly out from the eye tracker plane. Variates.
PupilLeft Pupil size (left eye) in mm. The distance and pupil size measurements are calculated to be as close to real values as possible. However, individual differences in the eyes of subjects and the strength of glasses/contact lenses will cause errors in these values. The measurements still reflect changes in head position and pupil size accurately. Variates.
ValidityLeft Validity of the gaze data. The validity is 0 if the eye is found and the tracking quality good. If the eye cannot be found by the eye tracker, the validity code will be 4. Read more under the Validity codes section further down.
GazePointXRight The horizontal screen position of the gaze point for the right eye. 0 is the left edge, the maximum value of the horizontal resolution of the screen is the right edge.
GazePointYRight Vertical screen position of the gaze point for the right eye. 0 is the bottom edge, the maximum value of the vertical resolution of the screen is the right edge.
CamXRight Horizontal location of the right pupil in the camera image. 0 is the left edge, 1 is the right edge.
CamYRight Vertical location of the right pupil in the camera image. 0 is the top edge, 1 is bottom edge.
DistanceRight Distance from the eye tracker to the right eye. The distance is given in mm on a straight axis, directly out from the eye tracker plane. Variates.
PupilRight Distance from the eye tracker to the right eye. The distance is given in mm on a straight axis, directly out from the eye tracker plane. Variates.
ValidityRight Validity of the gaze data. The validity is 0 if the eye is found and the tracking quality good. If the eye cannot be found by the eye tracker, the validity code will be 4. The value is for the right eye. For details, see the Validity codes section further down.


Additional data processed by Tobii Studio:
Field Description Values
DateTimeStamp Timestamp recalculated using the computer date time, shown in hours, minutes, seconds and milliseconds (hh:mm:ss:ms). Variates.
DateTimeStampStartOffset Timestamp converted into hh:mm:ss format. The start time for the recording is also shown in the Replay and Visualization views in Tobii Studio if the option Show Date is selected in the Recordings field. Variates.
Number Timestamp number (order). Variates.
FixationIndex Indexes for the fixation points (values correspond to the order of the fixation). Variates.
GazePointX Gaze PointX can be the horizontal screen position for either eye or the average for both eyes. The value to show here is specified in Tobii Studio. This value is also used for the fixation definition. Zero is the left edge, the maximum value of the horizontal screen resolution is the right edge.
GazePointY GazePointY can be the vertical screen position for either eye or the average for both eyes. The value to show here is specified in Tobii Studio. This value is also used for the fixation definition. Zero is the bottom edge, the maximum value of the vertical screen resolution is the right edge.
Event Events, automatic and logged, will show up under Events. The automatic events are start and end events for the different media, mouse clicks and key presses. The automatic events are listed in the event table under Event Key and Data at [1]. The logged events are the manually logged events entered either in the replay view or from the remote logger. Variates.
EventKey Unique event key is shown for different key presses. Variates.
Data1 Data field for the event. The contents of this field vary depending on what type of event this is. Variates.
Data2 Data field for the event. The contents of this field vary depending on what type of event this is. Variates.
Descriptor Description of the event. The contents vary depending on what type of event this is. Variates.
StimuliName The file name given to the media element when it was added to the test timeline. Variates.
StimuliID ClearView related data column. In Tobii Studio text export, the values are set to 0.
MediaWidth Media size in pixels. Variates.
MediaHeight Media size in pixels. Variates.
MediaPosX Distance from the left side of the screen to the media on the screen given in pixels. Variates.
MediaPosY Distance from the top of the screen to the media on the screen given in pixels. Variates.
MappedFixationPointX X coordinate for the fixation point mapped to the media coordinate system, where the origin for the coordinate system is the top left corner of the image/media. Variates.
MappedFixationPointY Y coordinate for the fixation point mapped to the media coordinate system, where the origin for the coordinate system is the top left corner of the image/media. Variates.
FixationDuration Fixation duration. The time in milliseconds that a fixation lasts. Variates.
AoiIds ID number for the AOI, usually a counter starting at zero for the first AOI. Variates.
AoiNames Name of the AOI or AOIs if fixations on multiple AOIs are to be written on the same row. Variates.
WebGroupImage File name of the image file that is used to visualize the web group. Variates.
MappedGazeDataPointX X coordinate for the raw gaze data point mapped to the media coordinate system where the origin for the coordinate system is the top left corner of the image/media. Variates.
MappedGazeDataPointY Y coordinate for the raw gaze data point mapped to the media coordinate system where the origin for the coordinate system is the top left corner of the image/media. Variates.
MicroSecondTimestamp Timestamp for this export row in microseconds. Variates.
AbsoluteMicroSecondTimestamp: Time counter timestamp in microseconds. Variates


Validity codes:
Left eye validity code Right eye validity code Eyes found System left and right eye identification
0 0 Both Correctly identified
4 0 Right Correctly identified
0 4 Left Correctly identified
3 1 Right Estimated as probable
1 3 Left Estimated as probable
2 2 One eye Uncertain
4 4 None Uncertain


Validity codes should be used for data filtering to remove data points which are obviously incorrect. If you export the raw data file, we recommend removing all data points with a validity code of 2 or higher.
References
[1] Tobii Studio ™ 2.X, User manual. 2010. ©Tobii Technology AB. pp: 73-75.