The UNR79 Lane Keeping plugin for VBOX Test Suite gives you the ability to complete and analyse a Lane Keeping test as described in the UNR79 document.
The UNR79 Lane Keeping has a unique Test Setup ribbon, from which you can configure the test.
Click on the Configure button to open the Settings window where you can define the parameters of the test.
Click on the Maths Channels button to open the Maths Channels window to configure unique maths channels. You can find more information about maths channels in the Test Setup section.
Click on the Save Settings button to save the current test setup and add it to the Saved Settings area in the Add Test window.
The test will also be added to the list under the ADAS Test button on the Home tab for easy access.
Click on the Export button to display a dropdown menu with the export options. You can export the selected results or line results to a .csv or a .txt file.
Click the Start of Test button to add a virtual gate to the Chart and Map areas at the current location of the cursor. The added line will act as the start of the test.
The start line will act as the start of the test and is indicated by a green dotted line. When you select a gate, the line will change to dark blue.
Click the Start of Curve button to add a virtual gate to the Chart and Map areas at the current location of the cursor. The added line will act as the start of the curve for validation purposes.
The start line will act as the start of the test and is indicated by a blue dotted line. When you select a gate, the line will change to dark blue.
Click the End of Test button to add a virtual gate to the Chart and Map areas at the current location of the cursor. This line will act as the end of the test.
The end line acts as the end of the test and is indicated by a red dotted line. When you select a gate, the line will change to dark blue.
When you have added a gate, the name of the currently selected gate will be displayed in the name box. Click on the arrow in the box to see a dropdown list of all the added gates. The gates will be named according to the type of gate (if applicable) and the order it was added.
When you have added a gate, you can specify the gate width. The default gate width is 20 m.
Type the required width in the Width (m) value box.
Note: If you change the gate width, the last used gate width will be used as the default width for the next gate.
Click on the Rename button to edit the currently selected gate line.
Click on the Delete button to delete the currently selected gate line.
Click on the Delete All button to delete all set gates for the session.
Click on the Export button to export the created gate(s) as an .spl file. This file can be reused at a later date and with another VBOX product.
Click on the Import button to import a previously saved or provided .spl file. When the file is imported, the gates will be added in the order that they were saved in the .spl file.
Image missing
The Add button adds a column to the Test Results area. Click this button to open a dropdown menu where you can select a channel to display in the test results window.
When you select a column header in the Test Results area, the channel name will be displayed in the Channel box (the top box in the Data Column section). Some columns will have required channels and cannot be changed, but if you can change the channel, the Channel box will become a drop-down list with the available channels.
When you select a column header in the Test Results area, and it is a changeable channel, the Condition dropdown menu becomes available. The conditions will depend on the test and selected channel.
Examples are:
- Avg
- Max
- Min
- Delta
- At Start
- At End
The Sort Ascending button will sort the values in the currently selected column in the Test Results area in alphabetical order from A to Z.
The Sort Descending button will sort the values in the currently selected column in the Test Results area in alphabetical order from Z to A.
Image missing
Click on the Select All button to select every run in the Test Results area with one click.
Run - Deselect All
Click on the Deselect All button to deselect every run in the Test Results area with one click.
Click on the Deselect All button to deselect every run in the Test Results area with one click.
Image missing
Click on the Edit Data button to open the Session Data window and add various vehicle and test information, such as:
Image missing
Vehicle Overlay
- Colour
- Length (m)
- Width (m)
- Antenna Placement
- From back
- From Left
- Advanced
- X (m)
- Y (m)
- Reset
- Remove
Vehicle
- Vehicle Model
- Vehicle Number
- Driver Name
- Engine Model
- Engine Number
- Kerb Mass (kg)
- Power (kW)
Wheels/Tyres
- Front
- Wheel
- Dimensions
- Tyres
- Make
- Dimensions
- Model
- Pressure (psi)
- Wheel
- Rear
- Wheel
- Dimensions
- Tyres
- Make
- Dimensions
- Model
- Pressure (psi)
- Wheel
Test
- Test Date
- Test Track
- Test Facility
- Comments
Conditions
- Weather
- Temperature (ºC)
- Track Temperature (ºC)
- Humidity (%)
- Wind Speed (m/s)
When in Offline mode, the Session Data will be saved into the VBOX file. This information will be recalled every time the file is loaded into VBOX Test Suite.
When in Online mode, a newly created session will be populated with session data from the previous session.
To save time, you can import and export the session data for other sessions. When you have completed the Session Data, you can export the data to a .vbses file by clicking on the Export button in the Session Data window. The exported file will contain all the session data and can be imported into another session via the Import button in the Session Data window.
Image missing
Click on Help to automatically open an Internet browser and load the relevant section of the User Guide on the Racelogic Support Centre.
If you are creating a new test, the Settings window will open when you add the new test. This is where you can define the test parameters.
If you have already added a test and you have it open, you can click on the Configure button to open the Settings window to define or amend the test parameters.
Vsmin
This parameter defines the minimum vehicle speed used as the pass condition for the test.
Vsmax
This parameter defines the maximum vehicle speed used as the pass condition for the test.
aysmax
This parameter defines the maximum lateral acceleration used as the pass condition for the test.
aysmax 80%
This parameter defines 80% of the maximum lateral acceleration and is automatically calculated from the inputted aysmax value. It is used as the minimum pass condition for the test between the Start of Curve gate and End of Test gate.
aysmax 90%
This parameter defines 90% of the maximum lateral acceleration and is automatically calculated from the inputted aysmax value. It is used as the maximum pass condition for the test between the Start of Curve gate and End of Test gate.
Vsmin
This parameter defines the minimum vehicle speed used as the pass condition for the test.
Vsmax
This parameter defines the maximum vehicle speed used as the pass condition for the test.
aysmax
This parameter defines the maximum lateral acceleration used as the pass condition for the test.
aysmax 80%
This parameter defines 80% of the maximum lateral acceleration and is automatically calculated from the inputted aysmax value. It is used as the minimum pass condition for the test between the Start of Curve gate and End of Test gate.
aysmax 90%
This parameter defines 90% of the maximum lateral acceleration and is automatically calculated from the inputted aysmax value. It is used as the maximum pass condition for the test between the Start of Curve gate and End of Test gate.
Selected Lane
You can use the plugin to create 2 virtual lanes to use in the test to get lane range values from your test.
You must plot the required lines in separate files. You cannot add multiple lanes from a single logged file.
You can either load lanes from a saved file or survey lanes live in VBOX Test Suite in Online mode.
Color
You can also change the associated colours for the lane by clicking on the Colour dropdown for the relevant lane and selecting the required colour.
Smooth
You can apply/remove smoothing to/from the lane by ticking/unticking the Smooth box for the relevant lane.
Clear
You can remove the associated lane file and colur by clicking on the Clear button next to a lane.
Image missing
Selected Lane
You can use the plugin to create 2 virtual lanes to use in the test to get lane range values from your test.
You must plot the required lines in separate files. You cannot add multiple lanes from a single logged file.
You can either load lanes from a saved file or survey lanes live in VBOX Test Suite in Online mode.
Color
You can also change the associated colours for the lane by clicking on the Colour dropdown for the relevant lane and selecting the required colour.
Smooth
You can apply/remove smoothing to/from the lane by ticking/unticking the Smooth box for the relevant lane.
Clear
You can remove the associated lane file and colur by clicking on the Clear button next to a lane.
Image missing
- Select Columns to display each interim result as a column on the right-hand side of the results table.
- Select Separate Table to display each interim result as a row in a separate table next to the results table.
Conditions
You can display intermediary results that are determined by any added Interim Conditions.
Click the + button to add a new interim result condition.
Every: The Interim Result will be displayed Every time Test Suite records the set value (e.g. every 10 km/h),
At: The Interim Result will be displayed At an instance of a value (e.g. only at 10 km/h).
Between: The Interim Result will be displayed when between values (e.g. between 30 km/h and 50 km/h).
Select the source of the Interim Result and set the required value.
You can delete a condition by clicking on the X button to the right of the relevant condition.
- Select Columns to display each interim result as a column on the right-hand side of the results table.
- Select Separate Table to display each interim result as a row in a separate table next to the results table.
Conditions
You can display intermediary results that are determined by any added Interim Conditions.
Click the + button to add a new interim result condition.
Every: The Interim Result will be displayed Every time Test Suite records the set value (e.g. every 10 km/h),
At: The Interim Result will be displayed At an instance of a value (e.g. only at 10 km/h).
Between: The Interim Result will be displayed when between values (e.g. between 30 km/h and 50 km/h).
Select the source of the Interim Result and set the required value.
You can delete a condition by clicking on the X button to the right of the relevant condition.
You can rename a session tab by double-clicking the tab header. Changing the name on the session tab in the software will automatically change the name of the locally saved VBOX file (.vbo or .vbb).
By pressing the Edit Data button next to the name of the session in the Test Results area or on the Test Setup tab on the ribbon, you can add vehicle and test information to the session.
- When in Offline mode, this information will be saved into the VBOX file, meaning that this information will be recalled every time the file is loaded into VBOX Test Suite.
- When in Online mode, a newly created session will be populated with session data from the previous session.
This information will be included in the test report to make it easier to see under what conditions the test was conducted.
To save time, you can import and export the session information for use in other sessions (the entire range of data is exported, not just the visible screen).
Once the session information has been completed, you can export the data to a .vbses file. This file will contain all the session information that can then be imported into the open session information field.
The Test Results area has the following default columns:
There is also a selection box that, when ticked, includes that run in the graph and into the Average/Max/Min/Standard Deviation calculations. Once selected, a coloured square will appear to indicate which colour this run is displayed as on the graph.
| Note: If you are loading a file in Offline mode, all valid runs will automatically be ticked. |
If the Vsmin parameter is exceeded, this column will be highlighted deep red and the whole run will be highlighted light red.
If the Vsmax parameter is exceeded, this column will be highlighted deep red and the whole run will be highlighted light red.
If the value is below the aysmax 80% parameter, this column will be highlighted deep red and the whole run will be highlighted light red.
| Note: This channel is subject to a 4th order Butterworth filter with a 0.5 Hz cutoff. |
If the value is above the aysmax 90% parameter, this column will be highlighted deep red and the whole run will be highlighted light red.
| Note: This channel is subject to a 4th order Butterworth filter with a 0.5 Hz cutoff. |
This parameter has a pass condition of ±5 m/s³.
If the value is exceeded, the column will be highlighted deep red and the whole run will be highlighted light red.
If the Lane is crossed, this column will be highlighted deep red and the whole run will be highlighted light red.