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

Beata Lewandowska
Written by Beata Lewandowska

CSV file: raw gazes denoised, normalized and split


This CSV file contains the following fields:

  • string tester_id - UUID,
  • int tester_age - could be undefined if tester did not provide this info,
  • int tester_gender - 1 - male, 0 - female. Could be undefined if tester did not provide this info,
  • tester_tags - tags assigned to a tester (added by study owner),
  • tester_quality_grade - tester's grade from 1 to 6 where:
  • 1 = very low,
  • 2 = low,
  • 3 = average,
  • 4 = good,
  • 5 = very good,
  • 6 = perfect;
  • 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 - tester’s screen width in pixels,
  • int test_browser_height - tester’s screen height in pixels,
  • test_item_display_order - a number indicating the order in which the items were displayed,
  • 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 tester has clicked at that time; if not clicked then this data is not included,
  • 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.
  • external_data_debug - any external values assigned to the participant (i.e. external Id from an external survey).

See the CSV file for the sample study:


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

Categories: