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

Beata Lewandowska
Written by Beata Lewandowska

CSV file: Raw Facial Coding


The "Raw Facial Coding" CSV file allows to download the facial coding data and contains the following fields:

  • string tester_id - UUID,
  • int tester_age - could be undefined if tester did not provide this info,
  • int tester_gender - 0 - female, 1 - male, 2 - other; could be undefined if tester did not provide this info,
  • 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;
  • 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 sue to image mapping with clicks or keystrokes),
  • int test_browser_width - tester’s screen width in pixels,
  • int test_browser_height - tester’s screen height in pixels,
  • JSON ARRAY test_facial_coding_raw_data - facecodeInfo[], array of info about emotions as shown below:
  • int facecodeInfo[0] - timestamp; samples are taken each 30 ms (at 0ms, 30 ms, 60 ms, etc.)
  • int facecodeInfo[1] - "neutral" emotion in scale from 1 to 0,
  • int facecodeInfo[2] - "happy" emotion in scale from 0 to 1,
  • int faceinfo[3] - "surprise" emotion in scale from 0 to 1;
  • notes:
  • RealEye version,
  • testerQualityGradeItemMin=X - data was downloaded only for items with min. quality = X, where X is from 1 to 6 where:
  • 1 = very low,
  • 2 = low,
  • 3 = average,
  • 4 = good,
  • 5 = very good,
  • 6 = perfect;
  • timestamp of when the file was downloaded,
  • external_data_debug - external variables assigned to the participant.

See sample CSV file here.

Categories: