Written by Beata Lewandowska
CSV file: raw gazes denoised, normalized and split
This 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 a participant did not provide this info,
- string participant_tags - tags assigned to a participant (added by the 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 the 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_pv - 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,
- float gaze_x_percents - X position of the eyes in percent of the item width (the left edge of the picture is 0%, the right - 100%),
- float gaze_y_percents - Y position of the eyes in percent of the item width (the top of the picture is 0%, the bottom - 100%),
- int gaze_timestamp_ms - time in ms since the beginning of the test,
- float mouse_x_percents - X position of the mouse cursor in percent of the item width (the left edge of the picture is 0%, the right - 100%),
- float mouse_y_percents - Y position of the mouse cursor in percent of the item height (the top of the picture is 0%, the bottom - 100%); this value includes scroll,
- boolean mouse_has_clicked - indicating if the participant has clicked at that time; if not clicked then this data is not included,
- string external_data_debug - any external values assigned to the participant, i.e., external Id from an external survey (if applicable),
- notes:
- notes:
- RealEye version,
- 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.
See the CSV file for the sample study:
See also: Downloading raw data CSV filtered by the item quality grade