Skip to content

Locomotive datalogger

Locomotive logs

Datalogger CSVs with a TimeStamp and Customer header.

  • File type: CSV exports from a locomotive datalogger
  • Supported devices: Locomotive control/monitoring systems that export a TimeStamp:/Customer:/UnitNumber: metadata header followed by day-of-week-prefixed data rows
  • Features: Wall-clock timestamp parsing, metadata extraction (customer, unit number, software version), parallel row parsing for large logs

Supported File Format

Locomotive logs start with five metadata lines, a blank line, then a comma-delimited header row, followed by data rows that begin with a day-of-week abbreviation:

TimeStamp: Sat Nov 15 19:00:03 2025
Customer: VLi
UnitNumber: 6194
SoftwarePartNumber: 16085
SoftwareVersion: 33.21.04

TimeStamp, CPMRst, Rc_tfnd, AB Mode, ASRstSt, ..., Eng RPM, ..., Batt V, ...
Sat Nov 15 19:00:03 2025, 1, 1, 1, 2, ..., 2907, ..., 64.0000000000, ...

How to Export

Export the session log as CSV from your locomotive datalogger software, then load the resulting .csv file directly into UltraLog.

Supported Data

  • Hundreds of locomotive control and diagnostic channels: engine RPM, battery voltage, traction motor and alternator status, brake and throttle position, cab signal states, and fault/status flags across the locomotive's control systems
  • Exact channel set depends on the datalogger configuration and locomotive model
  • Channels carry no unit metadata in the source file, so all values display unitless

Metadata

Locomotive logs carry session metadata in their first five lines, which UltraLog reads into log metadata rather than treating as channels: TimeStamp, Customer, UnitNumber, SoftwarePartNumber, and SoftwareVersion.

Timestamp Handling

Each data row starts with a full wall-clock timestamp (e.g. Sat Nov 15 19:00:03 2025), not an elapsed-time column. UltraLog parses this <weekday> <month> <day> <HH:MM:SS> <year> format, converts it to seconds, and normalizes the first sample to t = 0.