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.