---
title: "CSV file: Raw Facial Coding"
description: "CSV file: Raw Facial Coding"
---

[Skip to content](http://support.realeye.io/csv-file-raw-facial-coding#main-content)

[![logotype](https://support.realeye.io/hs-fs/hubfs/logotype.png?width=140&height=57&name=logotype.png)](https://support.realeye.io/?hsLang=en)

Open main navigation

Close main navigation

- [Contact us](mailto:contact@realeye.io)

[Contact us](mailto:contact@realeye.io)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [RealEye Knowledge Base](http://support.realeye.io/?hsLang=en)
2. [Analyzing Study Results](http://support.realeye.io/analyzing-study-results?hsLang=en)

# CSV file: Raw Facial Coding

The "Raw Facial Coding" CSV file allows you to download the facial coding data and 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 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 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** - participant's screen width in pixels,
- int **test\_browser\_height** - 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](https://realeye.user.com/knowledge-base/articles/73/update/144/%7B%%20kb_article_url%20187%20%%7D) 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\_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.)
- float **facecodeInfo\[1\]** - "neutral" emotion in scale from 0 to 1,
- float **facecodeInfo\[2\]** - "happy" emotion in scale from 0 to 1,
- float **facecodeinfo\[3\]** - "surprise" emotion in scale from 0 to 1,
- float **facecodeInfo\[4\]** - k-coefficient value,
- test\_k\_coefficient\_mean - k-coefficient mean value.
- notes:
- RealEye version,
- 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,
- string **external\_data\_debug** - all the external variables assigned to the participant (if applicable).

See the CSV files for the [sample study](https://www.realeye.io/item/ff85ad25-1933-403f-a1f6-af42a44094c1/):

- [facial coding](https://docs.google.com/spreadsheets/d/15ijSpCqoUayR5gX8UKLxpb73j62XFlGfmtZIMGLPP9w/edit?usp=sharing)

API: [https://www.realeye.io/docs/api/#facial-coding-data-export](https://www.realeye.io/docs/api/#facial-coding-data-export)

- [Getting started](http://support.realeye.io/getting-started?hsLang=en)
- [(Webcam) Eye-Tracking Basics](http://support.realeye.io/webcam-eye-tracking-basics?hsLang=en#main-content)

    - [RealEye accuracy](http://support.realeye.io/webcam-eye-tracking-basics?hsLang=en#realeye-accuracy)
- [Licenses & Pricing](http://support.realeye.io/licenses-pricing?hsLang=en)
- [Account Settings](http://support.realeye.io/account-settings?hsLang=en)
- [Study Setup & Settings](http://support.realeye.io/study-setup-settings?hsLang=en#main-content)

    - [Study Types](http://support.realeye.io/study-setup-settings?hsLang=en#study-types)
- [Content Setup & Stimuli (Items) Settings](http://support.realeye.io/content-setup-stimuli-items-settings?hsLang=en)
- [Managing Participants](http://support.realeye.io/managing-participants?hsLang=en)
- [Analyzing Study Results](http://support.realeye.io/analyzing-study-results?hsLang=en)
- [Advanced Features & Integrations](http://support.realeye.io/advanced-features-integrations?hsLang=en)
- [Security & Privacy](http://support.realeye.io/security-privacy?hsLang=en)
- [Troubleshooting](http://support.realeye.io/troubleshooting?hsLang=en)
- [Ghost articles](http://support.realeye.io/ghost-articles?hsLang=en)

[![logotype](https://support.realeye.io/hs-fs/hubfs/logotype.png?width=140&height=57&name=logotype.png "logotype")](http://realeye.io)

RealEye sp. z o. o.  
Obornicka 330  
60-689 Poznań  
Tax: PL9721299175

<https://www.facebook.com/> [mailto:support@realeye.io](mailto:support@realeye.io)

Copyright © 2024, RealEye sp. z o. o.