Data Output 📁

This page describes what data is saved (e.g., gaze data, timestamps, XML/CSV formats), and where it’s stored.

---

📉 Where to Find the Data Files

All data is stored within the folder of the program you're running (e.g., VR-ABA, SB-AAA). Depending on the setup, files may come from a camera tracker, eye tracker, or Tobii screen-based system.

---

🔍 VR Eye & Camera Tracking Data

• Location: ProgramFolder\VIBES-LAB_Data\Experiments\ProgramFolder

• Includes:

  • Camera Tracker Data (.csv)

  • Eye Tracker Data (.csv) (Vr Only 🕹️)

Example: VR-ABA\VIBES-LAB_Data\Experiments\VR-ABA\2025_2_13_1018__CameraTrackerData.csv VR-ABA\VIBES-LAB_Data\Experiments\VR-ABA\2025_2_13_1018__EyeTrackerData.csv

---

👁️ Tobii Data (Screen-Based Eye Tracker Only)

• Location: ProgramFolder\TobiiData

• File Type:

  • Saved as .CSV files for detailed gaze and event info.

Example: SB-AAA\TobiiData

---

Note 📝

Data is saved continuously meaning that even if the program or computer crashes the data remains intact

---

📊 Eye Tracker & Camera Tracker: Universal File Headers

These fields are included in the camera tracker, (VR) eye tracker .csv and (Tobii) eye tracker .csv data files generated during a session:

🧩 Shared (Universal) Headers

Header	Description
SubjectID	The participant's ID number.
Date	Date of the session in month_day format.
LocalTime	Timestamp in hour_minute_second.
UnityTime	Time (in seconds) since the Unity program was launched.
Phase	The current phase number.
BlockNumber	The current block number.
TrialNumber	The current trial number.
Step	The current step number within a trial.
TrialTime	Time (in seconds) since the current trial began.
Stage	Text label for what's happening (e.g., US, Instruction, InterTrial).
Context	Indicates the context/environment the participant is in (e.g., A or B).

---

👁️ Eye Tracker–Only Headers

These are included only in eye tracker data files (.csv):

Header	Description
screenfixationX/Y	2D coordinates of gaze on the screen. Values range from (0,0) bottom-left to (1,1) top-right. Values may go outside 0–1 due to blinks, calibration drift, or headset adjustments.
GazefixationX/Y/Z	Gaze position in 3D world space (not collision-aware).
localGazeX/Y/Z	Gaze position relative to the camera — similar to Gazefixation, but in camera-local space.
leftEyePositionX/Y/Z	Position of the left eye in mm relative to the IR sensor.
rightEyePositionX/Y/Z	Same as above, for the right eye.
leftEyeRotationX/Y/Z	Euler rotation angles of the left eye.
rightEyeRotationX/Y/Z	Euler rotation angles of the right eye.
leftEyePupilSize	Diameter of the left pupil in mm.
rightEyePupilSize	Diameter of the right pupil in mm.
leftEyeOpenAmount	Openness of the left eye — 1 = fully open, 0 = fully closed.
rightEyeOpenAmount	Same as above, for the right eye.
GazeHitPointX/Y/Z	Gaze position in 3D world space collision-aware.
GameObjectInFocus	Returns the name of the object the participant is looking at.

---

📷 Camera Tracker–Only Headers

These are included only in Camera Tracker data files (.csv):

Header	Description
xPos/yPos/zPos	Position of the Camera (users head) in 3D world space
xRot/yRot/zRot	Rotation of Camera in 3D world space

---

📷 Tobii Eye Tracker–Only Headers

These are included only in Tobii Eye Tracker data files (.csv):

Header	Description
LeftEyePupilDiameter	Diameter of the left pupil in mm.
RightEyePupilDiameter	Diameter of the left pupil in mm.
GazeHitPointX/Y/Z	Gaze position in 3D world space collision-aware.
GameObjectInFocus	Returns the name of the object the participant is looking at.