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:
Cameras
Multi-camera video with hardware-accelerated encoding. Supports CSI cameras (IMX296 global shutter) and USB webcams.
Audio
Multi-channel USB microphone recording with real-time level monitoring and per-chunk timing.
Eye Tracker
Pupil Labs Neon integration with gaze overlay, pupil diameter, and IMU data capture.
Detection Response Task
Wired and wireless response task devices for cognitive workload measurement per ISO 17488.
Visual Occlusion Goggles
Electronically controlled goggles with experiment modes for vision research (Cycle, Peek, eBlindfold, Direct).
GPS (Raspberry Pi only)
BerryGPS-IMU integration with real-time location tracking, offline maps, and comprehensive NMEA data parsing.
Notes
Timestamped session annotations synchronized with all other data streams.
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:
- Select modules — Check the boxes for devices you want to use in the Modules menu
- Start Session — Initialize all selected modules and create a session folder
- Record — Begin a trial to capture synchronized data from all modules
- Stop — End the trial (data saves automatically)
- 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.
