Reference

Data Output Reference

Complete reference for RSLogger data output formats, file structures, and CSV column specifications.

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

ComponentFormatExample
{timestamp}YYYYMMDD_HHMMSS20251208_143022
{prefix}trial_NNNtrial_001
{NNN}Zero-padded trial number001, 002, 003
{camera_id}type_bus_deviceusb_0_001, picam_0
{device_id}Module_dev_portDRT_dev_ttyacm0

Cameras Output

Video File

Camera TypeContainerCodec
USB camerasMP4H.264
CSI cameras (Pi only)AVIMJPEG

Timing CSV

ColumnTypeDescription
trialintTrial number (may be empty)
frame_indexint1-based frame number
capture_time_unixfloatUnix timestamp (6 decimals)
encode_time_monofloatMonotonic time (9 decimals)
sensor_timestamp_nsintHardware timestamp (CSI only)
video_ptsintPresentation timestamp

Full Cameras documentation →

Audio Output

WAV File

PropertyValue
FormatPCM (uncompressed)
Bit Depth16-bit signed integer
ChannelsMono
Sample Rate48,000 Hz (default)

Timing CSV

ColumnTypeDescription
ModulestringAlways “Audio”
trialintTrial number
write_time_unixfloatUnix timestamp (6 decimals)
chunk_indexintSequential chunk number
write_time_monotonicfloatMonotonic time (9 decimals)
adc_timestampfloatHardware ADC timestamp
framesintSamples in this chunk
total_framesintCumulative sample count

Full Audio documentation →

Eye Tracker Output

Scene Video

PropertyValue
ContainerMP4
CodecH.264
ResolutionConfigurable (default 1280x720)

GAZEDATA CSV

ColumnTypeDescription
ModulestringAlways “EyeTracker-Neon”
trialintTrial number
gaze_timestampfloatDevice timestamp
norm_pos_xfloatNormalized X (0-1)
norm_pos_yfloatNormalized Y (0-1)
confidencefloatGaze confidence (0-1)
wornboolGlasses worn status
pupil_left_diamfloatLeft pupil diameter (mm)
pupil_right_diamfloatRight pupil diameter (mm)
record_time_unixfloatSystem timestamp
record_time_monofloatMonotonic time

Full Eye Tracker documentation →

Detection Response Task Output

Detection Response Task CSV (7 columns)

ColumnTypeDescription
Device IDstringDevice identifier
LabelstringTrial label or “NA”
Unix time in UTCintHost timestamp (seconds)
Milliseconds Since RecordintDevice time (ms)
Trial NumberintSequential trial count
ResponsesintButton press count
Reaction TimeintRT in ms (-1 = miss)

wDRT CSV (9 columns)

Same as DRT plus:

ColumnTypeDescription
Battery PercentintBattery level (0-100%)
Device time in UTCintDevice RTC timestamp

Full Detection Response Task documentation →

Visual Occlusion Goggles Output

sVOG CSV (7 columns)

ColumnTypeDescription
Device IDstringDevice identifier
LabelstringDevice port/label
Unix time in UTCfloatEvent timestamp (6 decimals)
Milliseconds Since RecordintTime since recording start
Trial NumberintSequential trial count
TSOTintTotal Shutter Open Time (ms)
TSCTintTotal Shutter Close Time (ms)

wVOG CSV (9 columns)

Same as sVOG plus:

ColumnTypeDescription
LensstringLens state
Battery PercentintBattery level (0-100%)

Full Visual Occlusion Goggles documentation →

GPS Output

GPS CSV (21 columns)

ColumnTypeDescription
ModulestringAlways “GPS”
trialintTrial number
timestamp_utcstringISO 8601 UTC time
timestamp_unixfloatUnix timestamp
record_time_monofloatMonotonic time
latitudefloatDecimal degrees (+ = N)
longitudefloatDecimal degrees (+ = E)
altitude_mfloatAltitude (meters)
speed_kmhfloatSpeed (km/h)
heading_truefloatTrue heading (degrees)
fix_qualityintFix type (0=None, 1=GPS, 2=DGPS)
satellites_usedintSatellites in solution
hdopfloatHorizontal DOP

Full GPS documentation →

Notes Output

Notes CSV (4 columns)

ColumnTypeDescription
NotestringAlways “Note”
trialintTrial number
ContentstringAnnotation text
TimestampfloatUnix timestamp (6 decimals)

Full Notes documentation →

Timestamp Formats

Timestamp Types

TypeFormatPrecisionUse Case
Unix timestampSeconds since 1970-01-016 decimal places (microseconds)Cross-system reference
Monotonic timeSeconds since boot9 decimal places (nanoseconds)Cross-module sync
ISO 8601YYYY-MM-DDTHH:MM:SS.sssZMillisecondsHuman-readable
Hardware timestampNanosecondsNanosecondsDevice-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.