VBO file structure
The VBO is Racelogic’s standard data file format as used for logging by almost all VBOX products. It is a text file, typically in UTF-8 (VBox) or ANSI (VBoxTools) encoding. Each line is terminated with carriage return + line feed (0x0D 0x0A) characters.
The file consists of sections. Each section is separated with a blank line. The data is defined by ‘channels’ each of which represents a single type of data e.g. speed, voltage, time etc. For historical reasons channels are considered to be either Standard Channels or CAN Channels channels.
This section describes the types of data and the formatting of the data in a .vbo file. It is important to check this to make sure you are using the correct units when logging your data to the .vbo file.
File sections
The .vbo file consists of sections that are shown in the table below.
Name |
Required |
Description |
Example |
|---|---|---|---|
Date & time
|
Yes
|
This is the data and time the file was created.
It is written on a single line as shown in the example.
Note that VBox Tools replaces the at symbol with the text ‘at’.
|
File created on 07/12/2014 09:02:23
|
Header
|
Yes
|
This lists the channels logged in the file.
|
[header]
satellites
time
latitude
longitude
|
Units
|
Yes
|
This lists the units string for each non-standard channel.
The number of lines in this section must equal the number of lines in the
header minus the number of standard channels.
Blank lines are valid i.e. no units string for that channel.
|
[channel units]
m/s
Nm
km/h
|
Comments
|
No
|
This section contains a variety of product-specific information about the
comments section.
|
[comments]
Video VBox Lite
(c) Racelogic Ltd
Video VBox Version : 003.000.00077 General Release
Serial number : 602234
Engine: uBlox
GPS : 7.03
Rate: 10.00 Max: 10.00
|
laptiming
|
No
|
This section specifies lap timing gates, one gate per line.
|
[laptiming]
Start +5773.465840 +1832.282700 +5773.468800 +1832.204030 ¬ StartFinish
Split +5773.276150 +1832.070770 +5773.277650 +1832.044750 ¬ Back straight
Split +5773.137110 +1832.145100 +5773.163590 +1832.150200 ¬ Chicane Exit
|
AVI information
|
No
|
This section applies to video products only.
It specifies the base file name for the video files
which corresponds to this VBO file.
|
[avi]
VBOX_20141207085917_
|
Circuit info
|
No
|
On products which contain a tracks database this section shows the
country and track which are currently selected.
|
[circuit details]
country United States
circuit Texas World Speedway
|
Session Info
|
No
|
This section contains information about a lap timing session.
It contains the number of laps and the best lap time achieved during
the current session.
|
[session data]
laps 7
fastest 1m 50.04s
|
Column Names
|
Yes
|
This section specifies the name which should be displayed by VBox Tools
as each channel’s column header.
Names should not contain spaces.
All names should be on a single line and space-separated.
|
[column names]
sats time lat long velocity
heading height vert-vel dgps 911GT3_RPM
|
Data section
|
Yes
|
This section contains the actual data.
Each line represents a single sample.
There should be one column for each channel i.e. the number of channels
should match the number of entries in the header section.
The columns should be space separated.
Each column should be a fixed number of characters.
Each column entry must represent a numerical value in integer, decimal
or scientific notation.
|
[data]
007 140208.80 001832.29573 005773.42012 030.725 223.24 +00043.70 +000.03 000 +2.47900E+03
007 140208.90 001832.29533 005773.42046 031.902 220.29 +00043.72 +000.03 000 +2.55375E+03
007 140209.00 001832.29494 005773.42081 033.030 217.39 +00043.74 +000.02 000 +2.61725E+03
|
Standard Channels
Some channels are treated as special cases due to historical reasons, these are the standard channels.
Standard channels do not have an entry in the units section as they are assumed to have known units.
They are identified using the name in the header section and compared to a fixed list of known standard channels.
List of Standard Channels |
Format/example/notes |
|---|---|
satellites |
007 |
time |
hhmmss.sss (2 or 3 decimal places) |
latitude |
minutes * 100000 |
longitude |
minutes * -100000 (note reversed hemispheres) |
velocity kmh
velocity mph
velocity knots
velocity m/s
|
Speed in various units
|
velocity quality
velocity quality mph
velocity quality knots
velocity quality m/s
|
Speed quality in various units
|
heading |
Heading in degrees |
height |
Altitude in metres |
vertical velocity kmh
vertical velocity mph
vertical velocity knots
vertical velocity m/s
|
Vertical velocity in various units
|
event 1 time |
|
trigger event time in clock counts |
|
gps_sats |
GPS satellites used |
glonass_sats |
GloNaSS satellites used |
lat accel g |
|
gps_latacc |
|
long accel g |
|
gps_longacc |
|
solution type |
|
avifileindex |
|
avisynctime |
|
yaw rate |
|
yaw_rate |
|
latacc |
|
yaw rate deg/s |
|
yaw rate 2 |
|
yaw_rate2 |
|
lateral accel (yaw sensor) |
|
latacc 2 |
|
latacc_2 |
|
radius of turn |
|
distance m |
|
distance feet |
|
GPS distance from the start point in metres |
|
GPS distance from the start point in feet |
|
incremental time in seconds |
|
long acc calc |
|
lat acc calc |
|
x position in metres |
|
y position in metres |
|
x position in feet |
|
y position in feet |
|
relative height |
|
centre line deviation |
|
absolute heading |
CAN Channels
CAN channels are any non-standard channels and don’t necessarily have anything to do with CAN.
Historically they were sourced from a vehicle’s CAN bus, hence the name.
Example .vbo file
The following is a 2 second VBO file created by a Video VBox Lite.
File created on 07/12/2014 @ 09:02:23
[header]
satellites
time
latitude
longitude
velocity kmh
heading
height
vertical velocity m/s
dgps status
911GT3_RPM
911GT3_TPS
911GT3_BRAKE_POS
911GT3_STR_ANG
Gear
Gear
TPS
StrAngle
BrakePos
Steering_Direction
Steering_Angle
Brake_Position
RPM
WaterTemp1
OilPress
OilTemp
WaterTemp2
Combined Gs
Steering Input
Speed RPM
avifileindex
avisynctime
[channel units]
gear
gear
%
degrees
degC
bar
degC
degC
[comments]
Video VBox Lite
(c) Racelogic Ltd
Video VBox Version : 003.000.00077 General Release
Serial number : 602234
Engine: uBlox
GPS : 7.03
Rate: 10.00 Max: 10.00
[laptiming]
Start +5773.465840 +1832.282700 +5773.468800 +1832.204030 ¬ StartFinish
Split +5773.276150 +1832.070770 +5773.277650 +1832.044750 ¬
Split +5773.137110 +1832.145100 +5773.163590 +1832.150200 ¬
Split +5773.052430 +1832.033930 +5773.049290 +1832.057560 ¬
Split +5772.856830 +1832.086920 +5772.870350 +1832.060630 ¬
Split +5772.873130 +1832.231090 +5772.853100 +1832.211340 ¬
Split +5773.115630 +1832.225680 +5773.089720 +1832.219680 ¬
Split +5773.134310 +1832.495650 +5773.115380 +1832.476730 ¬
[avi]
VBOX_20141207085917_
[circuit details]
country United States
circuit Texas World Speedway
[session data]
laps 7
fastest 1m 50.04s
[column names]
sats time lat long velocity heading height vert-vel dgps 911GT3_RPM 911GT3_TPS 911GT3_BRAKE_POS 911GT3_STR_ANG Gear Gear TPS StrAngle BrakePos Steering_Direction Steering_Angle Brake_Position RPM WaterTemp1 OilPress OilTemp WaterTemp2 Combined_Gs Steering_Input Speed_RPM avifileindex avitime
[data]
007 140208.80 001832.29573 005773.42012 030.725 223.24 +00043.70 +000.03 000 +2.47900E+03 +4.57040E+01 +0.00000E+00 +1.41519E+02 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +4.37603E-01 -0.00000E+00 +7.70134E-03 0001 -00000001
007 140208.90 001832.29533 005773.42046 031.902 220.29 +00043.72 +000.03 000 +2.55375E+03 +4.64920E+01 +0.00000E+00 +1.37124E+02 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +4.84167E-01 -0.00000E+00 +7.76230E-03 0001 -00000001
007 140209.00 001832.29494 005773.42081 033.030 217.39 +00043.74 +000.02 000 +2.61725E+03 +4.72800E+01 +0.00000E+00 +1.22005E+02 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +5.10214E-01 -0.00000E+00 +7.84178E-03 0001 000000266
007 140209.10 001832.29450 005773.42110 034.551 214.32 +00043.76 +000.03 000 +2.73900E+03 +4.72800E+01 +0.00000E+00 +1.06886E+02 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +5.68849E-01 -0.00000E+00 +7.83826E-03 0001 000000300
007 140209.20 001832.29405 005773.42139 036.163 212.05 +00043.82 +000.04 000 +2.82925E+03 +4.72800E+01 +0.00000E+00 +8.43840E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +5.95196E-01 -0.00000E+00 +7.94226E-03 0001 000000433
007 140209.30 001832.29355 005773.42168 037.271 209.69 +00043.87 +000.04 000 +2.93900E+03 +4.84620E+01 +0.00000E+00 +7.38360E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +5.63798E-01 -0.00000E+00 +7.87993E-03 0001 000000533
007 140209.40 001832.29301 005773.42197 038.695 207.48 +00043.91 +000.05 000 +2.98525E+03 +4.84620E+01 +0.00000E+00 +6.46944E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +5.75930E-01 -0.00000E+00 +8.05425E-03 0001 000000633
007 140209.50 001832.29245 005773.42225 040.186 205.76 +00043.94 +000.06 000 +3.12500E+03 +4.88560E+01 +0.00000E+00 +6.01236E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +5.76488E-01 -0.00000E+00 +7.99054E-03 0001 000000734
007 140209.60 001832.29184 005773.42251 041.785 203.76 +00044.02 +000.07 000 +3.22400E+03 +4.88560E+01 +0.00000E+00 +4.95756E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +5.94440E-01 -0.00000E+00 +8.05335E-03 0001 000000834
007 140209.70 001832.29119 005773.42282 043.391 202.55 +00044.05 +000.04 000 +3.35250E+03 +4.88560E+01 +0.00000E+00 +3.90276E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +5.83795E-01 -0.00000E+00 +8.04233E-03 0001 000000934
007 140209.80 001832.29055 005773.42307 044.605 201.13 +00044.09 +000.03 000 +3.41750E+03 +4.84620E+01 +0.00000E+00 +3.76212E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +5.38359E-01 -0.00000E+00 +8.11010E-03 0001 000001034
007 140209.90 001832.28991 005773.42333 046.003 200.39 +00044.13 +000.03 000 +3.52100E+03 +4.72800E+01 +0.00000E+00 +3.46326E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +5.13118E-01 -0.00000E+00 +8.11841E-03 0001 000001134
007 140210.00 001832.28924 005773.42358 047.303 199.70 +00044.26 +000.06 000 +3.58775E+03 +4.64920E+01 +0.00000E+00 +3.16440E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +4.82044E-01 -0.00000E+00 +8.17600E-03 0001 000001234
007 140210.10 001832.28855 005773.42383 048.660 198.95 +00044.31 +000.06 000 +3.69050E+03 +4.60980E+01 +0.00000E+00 +3.16440E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +4.69647E-01 -0.00000E+00 +8.19291E-03 0001 000001334
007 140210.20 001832.28785 005773.42411 049.847 198.34 +00044.35 +000.06 000 +3.76600E+03 +3.74300E+01 +0.00000E+00 +2.84796E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +4.36600E-01 -0.00000E+00 +8.22451E-03 0001 000001434
007 140210.30 001832.28714 005773.42436 050.946 197.55 +00044.38 +000.05 000 +3.74925E+03 +0.00000E+00 +0.00000E+00 +2.70732E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +4.11252E-01 -0.00000E+00 +8.44339E-03 0001 000001534
007 140210.40 001832.28638 005773.42460 052.265 197.33 +00044.46 +000.07 000 +3.70150E+03 +0.00000E+00 +0.00000E+00 +2.70732E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +4.07898E-01 -0.00000E+00 +8.77373E-03 0001 000001634
007 140210.50 001832.28560 005773.42484 052.869 196.66 +00044.51 +000.07 000 +3.58150E+03 +0.00000E+00 +0.00000E+00 +2.40846E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +3.28092E-01 -0.00000E+00 +9.17249E-03 0001 000001735
007 140210.60 001832.28482 005773.42507 052.737 196.21 +00044.58 +000.07 000 +3.31325E+03 +0.00000E+00 +0.00000E+00 +2.40846E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +2.12880E-01 -0.00000E+00 +9.89037E-03 0001 000001835
007 140210.70 001832.28405 005773.42532 052.433 195.70 +00044.66 +000.08 000 +3.02800E+03 +0.00000E+00 +0.00000E+00 +2.40846E+01 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +0.00000E+00 +1.71435E-01 -0.00000E+00 +1.07597E-02 0001 000001935