RaceCapturePro2 logfile reference

Revision as of 03:41, 29 February 2016 by Brentp (talk | contribs) (initial cut.. WIP)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Log file format

RaceCapture/Pro logs data onto SD cards using a sparsely populated comma separated value (CSV) format.

File naming

RaceCapture/Pro names files in an ascending order in a pattern of RC_XX.LOG where XX represents a number. When a new log file is created, RaceCapture/Pro will create the next log file where XX is the next available number, preventing duplicate or overwritten log files.

Header

The log file header defines the information present in the data segment of the log file.

Format

Each column in the file is defined in a data structure with the following format:

  • Channel Name
  • Units Label
  • Min value
  • Max value
  • Sample Rate (Hz)

The data structure is defined as follows:

"<Name>"|"<Units>"|<Min value>|<Max Value>|<Sample Rate>

Example:

"Battery"|"Volts"|0.0|50.0

Each data structure describing a segment is separated with a comma.

Special Columns

Interval

Interval represents the milliseconds uptime of the system, and will reflect the number of milliseconds elapsed between samples.

Utc

Utc is sourced from GPS data and will be a valid, non zero value representing Utc time in milliseconds. When there is no GPS lock, UTC will be zero.

Data segment

Within the data segment, sample values appear at the frequency defined in the header file. When channels are logged at different sample rates the data logged at lower sample rates will appear sparsely within the file, with empty values appearing in the space between samples.


Example

"Interval"|"ms"|0|0|1,"Utc"|"ms"|0|0|1,"Battery"|"Volts"|0.0|50.0|1,"AccelX"|"G"|0.0|0.0|25,"AccelY"|"G"|0.0|0.0|25,"AccelZ"|"G"|0.0|0.0|25,"Yaw"|"Deg/Sec"|0.0|0.0|25,"Pitch"|"$
402,0,,-0.02,-0.03,0.93,0.5,-6.2,-0.2,,,,,,,,,,,,,,,,,,,,
442,0,,-0.02,-0.03,0.95,0.2,-6.0,-0.3,0,,,979,26,0.0,0.0,0.0,0.0,0.0,0,0,0.0,0,0.0,-1,0.0,0.0,0.0,0
482,0,,-0.01,-0.03,0.97,0.1,-5.5,-0.2,,,,,,,,,,,,,,,,,,,,
522,0,,-0.01,-0.03,0.99,0.0,-5.0,-0.2,,,,,,,,,,,,,,,,,,,,
542,0,,,,,,,,0,,,986,26,0.0,0.0,0.0,0.0,0.0,0,0,0.0,0,0.0,-1,0.0,,0.0,0