Products / Documentation / Data Output Reference Reference
Data Output Reference Complete reference for RSLogger data output formats, file structures, and CSV column specifications.
On this page
Session Structure File Naming Conventions Cameras Output Video File Timing CSV Audio Output WAV File Timing CSV Eye Tracker Output Scene Video GAZEDATA CSV Detection Response Task Output Detection Response Task CSV (7 columns) wDRT CSV (9 columns) Visual Occlusion Goggles Output sVOG CSV (7 columns) wVOG CSV (9 columns) GPS Output GPS CSV (21 columns) Notes Output Notes CSV (4 columns) Timestamp Formats Timestamp Types Session Structure
RSLogger organizes data hierarchically by session and module:
session_YYYYMMDD_HHMMSS/
├── Cameras/
│ └── {camera_id}/
│ ├── {prefix}_{camera_id}.mp4
│ ├── {prefix}_{camera_id}_timing.csv
│ └── {prefix}_{camera_id}_metadata.csv
├── Audio/
│ ├── {timestamp}_AUDIO_trial{NNN}_MIC{id}_{name}.wav
│ └── {timestamp}_AUDIOTIMING_trial{NNN}_MIC{id}_{name}.csv
├── EyeTracker-Neon/
│ ├── {prefix}_GAZEDATA_trial{NNN}.csv
│ ├── {prefix}_SCENE_trial{NNN}.mp4
│ ├── {prefix}_EVENT_trial{NNN}.csv
│ ├── {prefix}_IMU_trial{NNN}.csv
│ └── {prefix}_FRAME_trial{NNN}.csv
├── DRT/
│ └── {timestamp}_DRT_trial{NNN}_{device_id}.csv
├── VOG/
│ └── {timestamp}_VOG_trial{NNN}_{device_type}_{port}.csv
├── GPS/
│ └── {timestamp}_GPS_trial{NNN}.csv
└── Notes/
└── {timestamp}_NOTES_trial{NNN}.csv
File Naming Conventions
Component Format Example {timestamp}YYYYMMDD_HHMMSS 20251208_143022 {prefix}trial_NNN trial_001 {NNN}Zero-padded trial number 001, 002, 003 {camera_id}type_bus_device usb_0_001, picam_0 {device_id}Module_dev_port DRT_dev_ttyacm0
Cameras Output
Video File
Camera Type Container Codec USB cameras MP4 H.264 CSI cameras (Pi only) AVI MJPEG
Timing CSV
Column Type Description trialint Trial number (may be empty) frame_indexint 1-based frame number capture_time_unixfloat Unix timestamp (6 decimals) encode_time_monofloat Monotonic time (9 decimals) sensor_timestamp_nsint Hardware timestamp (CSI only) video_ptsint Presentation timestamp
Full Cameras documentation →
Audio Output
WAV File
Property Value Format PCM (uncompressed) Bit Depth 16-bit signed integer Channels Mono Sample Rate 48,000 Hz (default)
Timing CSV
Column Type Description Modulestring Always “Audio” trialint Trial number write_time_unixfloat Unix timestamp (6 decimals) chunk_indexint Sequential chunk number write_time_monotonicfloat Monotonic time (9 decimals) adc_timestampfloat Hardware ADC timestamp framesint Samples in this chunk total_framesint Cumulative sample count
Full Audio documentation →
Eye Tracker Output
Scene Video
Property Value Container MP4 Codec H.264 Resolution Configurable (default 1280x720)
GAZEDATA CSV
Column Type Description Modulestring Always “EyeTracker-Neon” trialint Trial number gaze_timestampfloat Device timestamp norm_pos_xfloat Normalized X (0-1) norm_pos_yfloat Normalized Y (0-1) confidencefloat Gaze confidence (0-1) wornbool Glasses worn status pupil_left_diamfloat Left pupil diameter (mm) pupil_right_diamfloat Right pupil diameter (mm) record_time_unixfloat System timestamp record_time_monofloat Monotonic time
Full Eye Tracker documentation →
Detection Response Task Output
Detection Response Task CSV (7 columns)
Column Type Description Device IDstring Device identifier Labelstring Trial label or “NA” Unix time in UTCint Host timestamp (seconds) Milliseconds Since Recordint Device time (ms) Trial Numberint Sequential trial count Responsesint Button press count Reaction Timeint RT in ms (-1 = miss)
wDRT CSV (9 columns)
Same as DRT plus:
Column Type Description Battery Percentint Battery level (0-100%) Device time in UTCint Device RTC timestamp
Full Detection Response Task documentation →
Visual Occlusion Goggles Output
sVOG CSV (7 columns)
Column Type Description Device IDstring Device identifier Labelstring Device port/label Unix time in UTCfloat Event timestamp (6 decimals) Milliseconds Since Recordint Time since recording start Trial Numberint Sequential trial count TSOTint Total Shutter Open Time (ms) TSCTint Total Shutter Close Time (ms)
wVOG CSV (9 columns)
Same as sVOG plus:
Column Type Description Lensstring Lens state Battery Percentint Battery level (0-100%)
Full Visual Occlusion Goggles documentation →
GPS Output
GPS CSV (21 columns)
Column Type Description Modulestring Always “GPS” trialint Trial number timestamp_utcstring ISO 8601 UTC time timestamp_unixfloat Unix timestamp record_time_monofloat Monotonic time latitudefloat Decimal degrees (+ = N) longitudefloat Decimal degrees (+ = E) altitude_mfloat Altitude (meters) speed_kmhfloat Speed (km/h) heading_truefloat True heading (degrees) fix_qualityint Fix type (0=None, 1=GPS, 2=DGPS) satellites_usedint Satellites in solution hdopfloat Horizontal DOP
Full GPS documentation →
Notes Output
Notes CSV (4 columns)
Column Type Description Notestring Always “Note” trialint Trial number Contentstring Annotation text Timestampfloat Unix timestamp (6 decimals)
Full Notes documentation →
Timestamp Types
Type Format Precision Use Case Unix timestamp Seconds since 1970-01-01 6 decimal places (microseconds) Cross-system reference Monotonic time Seconds since boot 9 decimal places (nanoseconds) Cross-module sync ISO 8601 YYYY-MM-DDTHH:MM:SS.sssZ Milliseconds Human-readable Hardware timestamp Nanoseconds Nanoseconds Device-specific timing
ⓘ Synchronization Tip
For best cross-module synchronization, use monotonic timestamps (encode_time_mono, write_time_monotonic, record_time_mono). See the Synchronization Guide for details.