Learn how to use RealEye.io - distributed webcam eye-tracking platform.

Beata Lewandowska
Written by Beata Lewandowska

CSV file: Raw Gazes and Raw gazes denoised

Exporting raw eye-tracking test results and using them.


You may get all test results from any study as CSV file.

To get the CSV file, simply click the "Save Results CSV" button on the study's dashboard (see also: Export AOI data).

CSV file contains the following fields:

  • string tester_id - UUID,
  • int tester_age - participant's age given at the end of the study; could be undefined if the participant did not provide this info,
  • int tester_gender - participant's gender given at the end of the study: 0 - female, 1 - male, 2 - other; could be undefined if the participant did not provide this info,
  • string tester_display_gender - participant's gender given at the end of the study; could be undefined if the participant did not provide this info,
  • string tester_tags - tags assigned to the participant (added by study owner),
  • int tester_quality_grade - participant's grade from 1 to 6 where:
  • 1 = very low,
  • 2 = low,
  • 3 = average,
  • 4 = good,
  • 5 = very good,
  • 6 = perfect;
  • int tester_quality_grade_item - item's grade from 1 to 6 where:
  • 1 = very low,
  • 2 = low,
  • 3 = average,
  • 4 = good,
  • 5 = very good,
  • 6 = perfect;
  • string item_id - UUID,
  • string test_id - UUID,
  • timestamp test_created_at - when a participant provided the result,
  • int test_duration - stimuli view time in ms (it may be shorter than defined in settings due to image mapping with clicks),
  • int test_browser_width - participant’s screen width in pixels,
  • int test_browser_height - participant’s screen height in pixels,
  • int test_item_display_order - a number indicating the order in which the items were displayed,
  • JSON ARRAY test_raw_data - gazeInfo[], an array of info about gaze as shown below:
  • int gazeInfo[0] - gaze point position on the screen (X-axis pixels from top-left corner). NOTE: It could be less than 0 or more than test_browser_width. The participant could be looking out of the screen.
  • int gazeInfo[1] - gaze point position on the screen (Y-axis pixels from top-left corner). NOTE: It could be less than 0 or more than test_browser_height. The participant could be looking out of the screen.
  • int gazeInfo[2] - time in ms since the beginning of the test.
  • float gazeInfo[3] - Y scroll offset in pixels (in case the participant was using the scroll).
  • float gazeInfo[4] - X position of mouse cursor in pixels (from top-left corner).
  • float gazeInfo[5] - Y position of mouse cursor in pixels (from top-left corner).
  • boolean|undefined gazeInfo[6] - indicating if the participant has clicked at that time; if not clicked then this data is not included.
NOTE:
For the "Raw gazes denoised" CSV the eyes posiotions in this array are already calculated due to the noice reduction level set (not raw samples).
  • notes:
  • RealEye version,
  • (for denoised data) fixation filter settings:
  • gazepoint interpolation (Hz) - to improve calculations we interpolate the data to 60 Hz;
  • gazepoint interpolation max gap (ms) - we interpolate data if the timestamp gap between two input values is not bigger than this value (50 ms);
  • gaze velocity threshold;
  • min. fixation duration (Ms);
  • noise reduction level,
  • testerQualityGradeItemMin=X - CSV file can be downloaded filtered by the item quality grade, where X is a value from 1 (very low) to 6 (perfect),
  • timestamp of when the file was downloaded.
NOTE:
Please be aware that test_raw_data for every participant will most likely contain a different number of gazeInfo. That's because the gaze-tracking sampling rate varies depending on the webcam, participant's computer performance and subscribed plan.

Example CSV file:

tester_id,tester_age,tester_gender,item_id,test_id,test_created_at,test_duration_ms,test_browser_width_px,test_browser_height_px,test_raw_data
660ea005-d031-4c20-914c-b94d13c94497,34,1,4f6b3515-71f4-4fa3-b9ca-4fdfc1dee4ad,0c81e7a0-360d-4183-8345-5dabbeddbd90,2019-07-09T10:34:12+00:00,20000,2048,1019,"[1097,98,333,0,1073,725],[964,62,350,0,1073,725],[933,47,365,0,1073,725],[933,47,382,0,1073,725],[933,47,400,0,1073,725],[991,175,416,0,1073,725],[991,175,438,0,1073,725],[1019,97,450,0,1073,725],[1019,97,466,0,1073,725],[861,-39,489,0,1073,725],[744,170,506,0,1073,725],[744,170,516,0,1073,725],
...
[359,550,19868,212.8000030517578,1036,689.1999969482422],[359,550,19884,212.8000030517578,1036,689.1999969482422],[334,648,19901,212.8000030517578,1036,689.1999969482422],[334,648,19919,212.8000030517578,1036,689.1999969482422],[400,618,19934,212.8000030517578,1036,689.1999969482422],[400,618,19951,212.8000030517578,1036,689.1999969482422],[916,629,19968,212.8000030517578,1036,689.1999969482422],[916,629,19983,212.8000030517578,1036,689.1999969482422],[793,559,20000,212.8000030517578,1036,689.1999969482422]]"

From following data

660ea005-d031-4c20-914c-b94d13c94497,34,1,4f6b3515-71f4-4fa3-b9ca-4fdfc1dee4ad,0c81e7a0-360d-4183-8345-5dabbeddbd90,2019-07-09T10:34:12+00:00,20000,2048,1019

we can tell for example that participant's id was "660ea005-d031-4c20-914c-b94d13c94497", age "35", "male", whole test took 20000 ms, screen resolution was "2048 x 1019".

Now let's take a single gazeInfo

[933,47,365,0,1073,725]

This data tells us that the participant was looking around the "933 x 47" pixels of his screen, "365" ms since the test item has been exposed. "0" means the image has not been scrolled. His/her mouse cursor was at the "1073 x 725" pixel of his screen. The participant has not clicked a mouse at that moment.


NOTICE:
Please note that data export to CSV file is available only for plans with the "Export data" feature.


See the CSV files for the sample study:

See also: Downloading raw data CSV filtered by the item quality grade


API: https://www.realeye.io/docs/api/#gazes-data-export

Categories: