Banner

Working with the black box

The black box allows developers or other users with special needs to log a series of train states in regular intervals for later analysis. The black box needs to be enabled in the Options menu. Once that is done, after driving a session, go to the Review last game menu and click on Export from the Black box section in order to create a CSV file containing the log.
Inside the CSV (comma-separated value) file, for each line, there is a series of values in this order:
Time, Position, Speed, Acceleration, ReverserDriver, ReverserSafety, PowerDriver, PowerSafety, BrakeDriver, BrakeSafety, Event

Time:
The current time in seconds (s) since midnight. This might exceed 86400 if passing day boundaries.

Position:
The current position in meters (m) according to the route file used.

Speed:
The current speed of the train in meters per second (m/s).

Acceleration:
The current acceleration of the train in meters per second squared (m/s²).

ReverserDriver, ReverserSafety:
These are tokenized representations of the current reverser position as selected by the driver and as overridden by the safety system, respectively. The following tokens are used:
-1 The backward position
0 The neutral position
1 The forward position

PowerDriver, PowerSafety:
These are tokenized representations of the current power lever position as selected by the driver and as overridden by the safety system, respectively. The following tokens are used:
0 Power notch zero
positive integer The respective power notch

BrakeDriver, BrakeSafety:
These are tokenized representations of the current brake lever position as selected by the driver and as overridden by the safety system, respectively. The following tokens are used:
0 Brake notch zero
positive integer The respective brake notch
-1 The emergency brake (EMG)
-2 The hold brake
-3 Release (REL)
-4 Release (LAP)
-5 Release (SRV)
Please note that the automatic air brake makes use of values -1, -3, -4 and -5, while notched brakes use positive integers, 0, -1 and -2.

Event:
This is a tokenized representation of special events. Currently, there are no such events defined.
0 No event