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

Beata Lewandowska
Written by Beata Lewandowska

CSV file: Fixations


Beside the Raw Data export and AOI data export there is also an option of downloading the fixation data as a CSV file.

The file contains:

  • string study_id - UUID,
  • string item_id - UUID,
  • string item_filename - the name of your file, as it was named while adding to study,
  • string item_cdn_url - URL to the tested item saved on our servers,
  • string tester_id - UUID,
  • string tester_external_id - (UUID) in case if you provide one by connecting your study with an external tool, i.e. a survey,
  • string tester_display_name - a name that a tester gives while asked about a name, gender, and age at the end of the study (if you have chosen that option), i.e. "Anna, Female, 27",
  • int 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;
  • 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;
  • int test_item_display_order - a number indicating the order in which the items were displayed,
  • float fixation_point_x - the x coordinate of fixation expressed as a percentage of the displayed item size,
  • float fixation_point_y - the y coordinate of fixation expressed as a percentage of the displayed item size,
  • int fixation_starts_at_ms - when the fixation appeared (counting from the beginning of displaying the item),
  • int fixation_ends_at_ms - when the fixation disappeared (counting from the beginning of displaying the item),
  • int fixation_duration_ms - for how long lasted the fixation,
  • 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);
  • noise reduction level,
  • TestCriteria - data was downloaded for participants:
  • isGenderMale={true/false},
  • isGenderFemale={true/false},
  • isGenderOther={true/false},
  • isGenderUnknown={true/false},
  • qualityMin={from1 to 6},
  • qualityMax={from 1 to 6},
  • isTesterTypeRealEye={true/false},
  • isTesterTypeNonRealEye={true/false},
  • timestamp of when the file was downloaded.

See the CSV file for the sample study:

  • fixations

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

Categories: