Study tools

Cockpit-Display-Replay

jsPsych plugin that renders an eco display from a driving-data stream in sync with a recorded driving video.

What & why

If the cockpit display is burnt into the study video, every interface variant needs its own recording. Cockpit-Display-Replay instead makes the display a function of the data. The plugin couples a driving video with a synchronised data stream (gear, speed, state of charge, consumption, power, range and others). It renders the display live alongside it — polling at 25 Hz against the timestamps of the stream. Interface variants can therefore be swapped without a new recording. It is video-source-agnostic: all it needs is a browser-compatible video file and the data file synchronised with it.

The displays come from the public display library @ecosimlab/ecodisplays (tool EcoInterfaces). The plugin takes it as a git dependency and keeps no copy of its own. That gives a choice of 20 displays, from the AP4 trace to the energy score.

Version 2.0.0 changed the data format for this: a point of the data stream is a DisplayInput of the library now. Recordings in the old format no longer run and have to be converted.

Quickstart

Install the package from the repository (npm install gitlab:ecosimlab/videosimlab-cockpit-replay#2.1.0), then import jsPsychVideosimlabCockpitReplay from "@ecosimlab/jspsych-plugin-videosimlab-cockpit-replay" and add it as a trial to the jsPsych timeline — required parameters: display, displayStream, cockpitVideo.

Guide: Cockpit-Display-Replay

Reuse

Embed individually in an existing jsPsych study

Interface: Standard jsPsych plugin (npm package)

Requirements

jsPsych ^8.0.0
your own video/data source (simulator, dashcam …)

Included

Replay mechanism (timestamp matching) and the 20 displays of @ecosimlab/ecodisplays
Sector assignment via the sectorId and sectorType parameters

Not included

the video and data recording itself (see Recording-Pipeline)

Cite

Jan Heidinger, Leonardt Wagner, Christopher Spölmink, Thomas Franke (2026).
VideoSimLab: Developing a Video-Based Toolchain for Vehicle Display Evaluation Studies
AutomotiveUI '26 (18th Intl. Conf. on Automotive User Interfaces)
10.1145/3828157.3828768