menu_book

Knowledge Base

Documentation, guides, and resources for Noldus products.

FaceReader 10 - Export (Detailed Log, ODX, N-Linx And API)

Last updated: Jul 28, 2026

Export (Detailed Log, ODX, N-Linx And API)

By default, the detailed export file contains the classification output values for the six basic emotions, and the neutral state. Contempt is added if you selected it as optional classification in the Analysis options tab. Select one of the options below to add extra information to the log file.

IMPORTANT Please note that if your observations are long, writing a lot of extra information to the log can make your log files very large and can make the analysis slower.

Action Units

This option is only available if your FaceReader license includes the Action Unit Module. With this option selected, extra columns with the Action Units are added to the log file. Values are between A (trace) and E (max). This option is only available when you have the Action Unit Module.

See Action Units in the log files in The Action Unit Module

Export Action Units As Continuous Values

With this option selected, the Action Unit categories A-E are exported as numerical values between 0 and 1.

See Action Units in the log files in The Action Unit Module

With this option selected, the Action Unit intensities can be imported into The Observer XT as external data.

See Import the detailed logs as external data in FaceReader with The Observer XT

Export The Unilateral Action Unit Intensities

If you select this option, the Detailed log file will have three columns for each unilateral Action Unit, one for the intensity of the Action Unit on the right side of the face, one for the left side and one combined which is the maximum of the left and right values.

Consumption Behavior

This option is only available if your FaceReader license includes the Consumption Behavior Module. With this option selected, FaceReader adds three columns to the Detailed log file, 'Intake event', 'Chewing' and 'Chew motion' with for each analyzed frame 'Yes' or 'No' to indicate whether the behavior was active or not.

Custom Expressions

This option is only available if your FaceReader license includes the Action Unit Module. Selecting this option, adds a column to the Detailed log file for each custom expression showing its intensity for each analyzed frame.

Facial States

With this option selected, 5 extra columns are added to the Detailed log: Mouth (open or closed), Left-Eye (open or closed), Right-Eye (open or closed), Left-Eyebrow (raised, neutral or lowered) and Right-Eyebrow (raised, neutral or lowered).

See Facial States in FaceReader's output

Gaze Data

With this option selected, two extra columns are added to the Detailed log: Gaze Direction and Gaze Type. The gaze direction can either be Left, Left-Up, Left-Down, Right, Right-Up, Right-Down, Up, Down and Forward. The gaze type is either Fixation, Saccade or Unknown. This option is only available if Gaze tracking is selected in the Analysis Options.

Gaze Angles

With this option selected two extra columns are added to the Detailed log: Horizontal gaze angle and Vertical gaze angle. The horizontal and vertical gaze angles are 0 degrees when the test participant looks straight ahead.

Head Orientation

With this option selected, three extra columns are added to the Detailed log: Pitch, Yaw and Roll (in degrees).

See Reporting Display in FaceReader's output

Head Position

With this option selected three extra columns are added to the Detailed log: Horizontal position, Vertical position and Depth position with the head position angles in millimeters relative to the camera.

Vital Signs

This option is only available if your FaceReader license includes the Vital Signs Module. With this option selected, eight extra columns (Heart Rate, Heart Rate Variability (RMSSD), Heart Rate Variability (SDNN), Heart Rate Warnings, Heart rate confidence, Breathing Rate, Breathing Rate Warnings and Breathing rate confidence) are added to the Detailed log.

The Heart Rate Warnings and Breathing Rate Warnings columns may contain the following warnings:

  • FIND_FAILED/FIT_FAILED — If no face is found or the face cannot be modeled (e.g. because the quality of the video is poor)
  • MISSING — If you work live (using a camera) and your computer cannot process the incoming images fast enough, frames will be skipped
  • Framerate, bitrate, resolution ratio too low — If your camera settings deviate from the recommended settings. See The Vital Signs Module for more information about the recommended settings for heart rate, heart rate variability, and breathing rate measurement.

The Heart rate confidence values and Breathing rate confidence values are values between 0 and 1, indicating the quality of the heart rate/breathing rate measurements.

Valence And Arousal

If you select this option the valence and arousal are added to the log file.

See Valence and Arousal Line Chart and in FaceReader's output.

Expressions From Voice

This option is only available if your FaceReader license includes the Voice Analysis Module. With this option selected seven extra columns are added to the Detailed log: Neutral from Voice, Happy from Voice, Sad from Voice, Angry from Voice, Valence from Voice, Arousal from Voice, Loudness and Speech rate. Voice Analysis in the Analysis Options must be enabled.


Source: FaceReader 10 Reference Manual (Help), Noldus Information Technology

Free consultation available

Schedule a 15-minute call with a Noldus specialist to discuss your behavioral research needs.

Noldus is here to assist you throughout the whole process.

shopping_bag
check_circle

Thank you!

We'll get back to you shortly.

error

Please correct the following errors:

error

error

error

error

By clicking Submit, you consent to Noldus processing your data as described in our privacy policy.