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 participant_id - UUID,
- string participant_external_id - UUID,
- int participant_age - participant's age given at the end of the study; could be undefined if the participant did not provide this info,
- int participant_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 participant_display_gender - participant's gender given at the end of the study; could be undefined if the participant did not provide this info,
- string participant_tags - tags assigned to the participant (added by study owner),
- int participant_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 participant_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_ms - stimuli view time in ms (it may be shorter than defined in settings due to image mapping with clicks),
- int test_browser_width_px - participant’s screen width in pixels,
- int test_browser_height_px - participant’s screen height in pixels,
- int test_item_display_order - a number indicating the order in which the items were displayed,
- int exposure_number - (only applicable for Website Mockup studies) indicates the time the participant saw an item, i.e., 1 means that the participant saw this item for the first time,
- 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).
- string external_data_debug - all the external variables assigned to the participant (if applicable),
- 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);
- max. fixation duration (Ms);
- moving median range (Ms);
- saccade max duration (Ms);
- participantQualityGradeItemMin=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", the age was "35", "male", the whole test took 20000 ms, the 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 had 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