Software / Documentation

Logger Documentation

Cross-platform synchronized multi-sensor data collection for automotive and human factors research.

The Logger is a professional data acquisition platform designed for researchers who need synchronized capture of video, audio, eye tracking, and behavioral task data. Available for Windows, macOS, Linux, and Raspberry Pi. All modules record with frame-level synchronization (~30ms accuracy) and export timestamped CSV data for analysis.

Modules

The Logger provides seven recording modules that can be used independently or in combination:

Supported Hardware

Device Connection Module
IMX296 Global Shutter Camera (Raspberry Pi only) CSI Cameras
USB Webcams USB Cameras
USB Microphones USB Audio
Pupil Labs Neon Network (WiFi/USB) Eye Tracker
Detection Response Task (wired) USB Serial Response Task
Detection Response Task (wireless) XBee Wireless Response Task
Visual Occlusion Goggles (wired) USB Serial Occlusion Goggles
Visual Occlusion Goggles (wireless) XBee Wireless Occlusion Goggles
OzzMaker BerryGPS-IMU (Raspberry Pi only) UART GPS

Red Scientific Hardware

Detection Response Task and Visual Occlusion Goggles devices are available from Red Scientific. See our Devices page for specifications and purchasing information.

Workflow

The Logger follows a simple session-based workflow:

  1. Select modules — Check the boxes for devices you want to use in the Modules menu
  2. Start Session — Initialize all selected modules and create a session folder
  3. Record — Begin a trial to capture synchronized data from all modules
  4. Stop — End the trial (data saves automatically)
  5. End Session — Finalize and close all modules

You can record multiple trials per session. Each trial is saved with synchronized timestamps across all modules.

Data Output

The Logger organizes data by session and module:

session_YYYYMMDD_HHMMSS/
├── Cameras/
│   ├── video.avi
│   └── frame_timing.csv
├── Audio/
│   ├── audio.wav
│   └── chunk_timing.csv
├── EyeTracker-Neon/
│   ├── scene_video.mp4
│   └── gaze_data.csv
├── DRT/
│   └── response_data.csv
├── VOG/
│   └── shutter_timing.csv
├── GPS/
│   └── location_data.csv
└── Notes/
    └── annotations.csv

For detailed information about each module's data format, see the individual module documentation or the Data Output Reference.

System Requirements

The Logger runs on Windows, macOS, Linux, and Raspberry Pi. No installation required—download, extract, and run.

Platform Requirements
Windows Windows 10 or later (64-bit)
macOS macOS 11 (Big Sur) or later
Linux Ubuntu 20.04+ or equivalent (x86_64)
Raspberry Pi Pi 4/5 with Raspberry Pi OS Bookworm (ARM64)

Platform-Specific Features

GPS module and CSI cameras are only available on Raspberry Pi. All other modules work on all platforms.