The eyevec-control program can, if instructed, generate various output files that are mostly meant for studying the eye-tracker itself. For this purpose the program will create a directory called eyevec in your home directory under Linux or your user profile directory under Windows.

The following directory structure will exist if fully populated:

Directory Description

eyevec/

Top-level directory

eyevec/screenshots/

Output directory for screenshots (*.pdf, *.svg, *.png)

eyevec/evaluation/

Output directory for eye-tracking data files (*.bed) created for the purpose of accuracy and precision analysis

eyevec/analysis/

Output directory for gaze analysis results (*.txt, *.csv)

eyevec/basedata/

Output directory for exported baseline procedure eye-tracking data (*.csv)

eyevec/caldata/

Output directory for exported calibration procedure eye-tracking data (*.csv)

eyevec/valdata/

Output directory for exported validation procedure eye-tracking data (*.csv)

eyevec/dcdata/

Output directory for exported drift-check procedure eye-tracking data (*.csv)

eyevec/testdata/

Output directory for exported test procedure eye-tracking data (*.csv)

eyevec/stimuli/

Source directory for custom test stimuli (texts and/or images)
(not created by eyevec-control, but used if present)

You may remove or cleanup this directory structure at any time. None of it is required for proper operation of the eye-tracker.

Screenshots

Screenshots created by eyevec-control will be saved in the screenshots subdirectory as PDF, SVG or PNG files, depending on whether you pressed Ctrl+F12, Shift+F12 or Ctrl+Shift+F12.

The files will have this name format:

<yyyymmdd>T<hhmmss>.<ext>

where:
<yyyymmdd>T<hhmmss> represents date and time in ISO 8601 format
<ext> is either pdf, svg or png

Evaluation results

Eye-tracking data files (*.bed) created by eyevec-control through the Open data file function under Test & Record will be saved in the evaluation subdirectory.

The files will have this name format:

<yyyymmdd>T<hhmmss>-<refnum>.bed

where:
<yyyymmdd>T<hhmmss> represents date and time in ISO 8601 format
<refnum> represents specified reference number

Assuming the proper procedure is followed you can use these eye-tracking data files for accuracy and precision calculations.

Gaze error analysis results

Gaze analysis ourput files (*.txt and *.csv) created by eyevec-control through the Analyze gaze error function under Test & Record will be saved in the analysis subdirectory.

The files will have this name format:

<yyyymmdd>T<hhmmss>-<refnum>.txt and <yyyymmdd>T<hhmmss>-<refnum>.csv

where:
<yyyymmdd>T<hhmmss> represents date and time in ISO 8601 format
<refnum> represents specified reference number

See explanation in the created text file.

Exported from playback

Pressing kbd[Ctrl+e] from the Playback page will export the eye sample records for the latest procedure run to a CSV file. The output subdirectory depends on the procedure run.

Baseline procedure recordings

Exporting post-baseline eye sample records will save a CSV file to subdirectory basedata.

The files will have this name format:

<yyyymmdd>T<hhmmss>-<refnum>-<type>.csv

where:
<yyyymmdd>T<hhmmss> represents date and time in ISO 8601 format
<refnum> represents specified reference number
<type> will be 0 (zero)

Calibration procedure recordings

Exporting post-calibration eye sample records will save a CSV file to subdirectory caldata.

The files will have this name format:

<yyyymmdd>T<hhmmss>-<refnum>-<type>.csv

where:
<yyyymmdd>T<hhmmss> represents date and time in ISO 8601 format
<refnum> represents specified reference number
<type> represents calibration type used

Validation procedure recordings

Exporting post-validation eye sample records will save a CSV file to subdirectory valdata.

The files will have this name format:

<yyyymmdd>T<hhmmss>-<refnum>-<type>.csv

where:
<yyyymmdd>T<hhmmss> represents date and time in ISO 8601 format
<refnum> represents specified reference number
<type> represents validation type used

Drift-check procedure recordings

Exporting post-drift-check eye sample records will save a CSV file to subdirectory dcdata.

The files will have this name format:

<yyyymmdd>T<hhmmss>-<refnum>-<type>.csv

where:
<yyyymmdd>T<hhmmss> represents date and time in ISO 8601 format
<refnum> represents specified reference number
<type> will be 0 (zero)

Test procedure recordings

Exporting post-test eye sample records will save a CSV file to subdirectory testdata.

The files will have this name format:

<yyyymmdd>T<hhmmss>-<refnum>-<type>.csv

where:
<yyyymmdd>T<hhmmss> represents date and time in ISO 8601 format
<refnum> represents specified reference number
<type> represents specified test type

Custom test stimuli

To customize the text and image tests in Test & Record and for customizing the (infant) slide show you can create a subdirectory called stimuli and provide to override the default stimuli.

There are three CSV files involved:

  • testtexts.csv: provide this file to change the text test stimuli

  • testimages.csv: provide this file to change the image test stimuli

  • pauseimages.csv: provide this file to change the slide show

Under Linux the the default files can be found in /usr/share/eyevec/data/. Under Windows the the default files can be found in C:\Program Files\EyeVec\data\. These files are self-explanatory.

Note, if you provide your own testimages.csv and/or pauseimages.csv the image files referred to need to be in the custom stimuli subdirectory too.