blackbox

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^2).

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:

Value	Description
-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:

Value	Description
0	Power notch 0
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:

Value	Description
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.

Value	Description
0	No event