Refine results by selecting a filter or click on 'All results' to search the whole site.
Skip to main content
RACELOGIC Support Centre

ADAS Test - UNR79 CSF

  1. Last updated
  2. Save as PDF
This page contains an overview of the Test Setup in the UNR79 CSF Plugin.

The UNR79 CSF plugin for VBOX Test Suite gives you the ability to complete and analyse a Commanded Steering Function test as described in the UNR79 document.

Ribbon - Test Setup

The UNR79 CSF  has a unique Test Setup ribbon, from which you can configure the test and test area.

VBTS_UNR79_CSF_TestSetup.svg

Test Section

VBTS_UNR79_CSF_TestSetup_Test.svg

Configure

Click on the Configure button to open the Settings window where you can define the parameters of the test.

Maths Channel

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.

Save Settings

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.

Export

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. 

Gate Section 

VBTS_UNR79_CSF_TestSetup_Gate.svg

Start Line

Click the Start Line button to add a virtual gate to the Chart and Map areas at the current location of the cursor.

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.

End Line

Click the End Line button to add a virtual gate to the Chart and Map areas at the current location of the cursor.

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.

Gate Name

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.  

Note: You cannot have multiple gates with the same name.   
Width

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. 
Rename

Click on the Rename button to edit the currently selected gate line.

Delete

Click on the Delete button to delete the currently selected gate line. 

Delete All

Click on the Delete All button to delete all set gates for the session. 

Export

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.

Import

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.

Data Column Section 

VBTS_TestSetup_DataColumnSection.svg

Add

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.

Channel 

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.    

Data column_SelectedColumn_DefaultChannel.svg

Data column_SelectedColumn_EditChannel.svg
Result Condition

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
Sort Ascending

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.

Sort Descending

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.

Run Section 

VBTS_TestSetup_RunSection.svg

Select All

Click on the Select All button to select every run in the Test Results area with one click.

Deselect All

Click on the Deselect All button to deselect every run in the Test Results area with one click.

Session Section
Edit Data 

VBTS_TestSetup_SessionSection.svg

Click on the Edit Data button to open the Session Data window and add various vehicle and test information, such as:

VBTS_UNR79_CSF_SessionData.svg 

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)
  • Rear
    • Wheel
      • Dimensions
    • Tyres
      • Make
      • Dimensions
      • Model
      • Pressure (psi)

 

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.

Help Section 
Help

VBTS_TestSetup_HelpSection.svg

Click on Help to automatically open an Internet browser and load the relevant section of the User Guide on the Racelogic Support Centre.

Note: This page will only be displayed if there is a valid internet connection. If there is no valid internet connection, a cached version of the relevant section (from the last software update) will be presented in PDF form.

Test Settings

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.

VBTS_UNR79_CSF_Settings.svg

Start Conditions
Start On

You can set the condition that you want your test to start at.

Use the dropdown list to select the condition. In addition to the Start and End Lines, you can select any logged channel, if a trigger is activated/deactivated, or immediately.

If you select a channel, you can also define the positive or negative value at which the test should start.

Note: If you set a trigger as the start condition, the test will not restart if the trigger is activated within 1 second of the previous trigger activation.
VBTS_UNR79_CSF_Settings_StartCondition.svg
End Conditions
End On

You can set the condition that you want to end your test.

Use the dropdown list to select the condition. In addition to the Start and End Lines, you can select any logged channel, if a trigger is activated/deactivated, or immediately.

If you select a channel, you can also define the positive or negative value at which the test should start.

 VBTS_UNR79_CSF_Settings_EndCondition.svg
Audio Alert
Channel

Part of the test requires you to understand when an Audio alert happened in the vehicle. You can select an audio alert channel to use in the dropdown list.
 

ON

You must set a value for the audio alert to activate and whether this should happen when the channel is rising or falling.
 

OFF

You must set a value for the audio alert to deactivate and whether this should happen when the channel is rising or falling.

 VBTS_UNR79_CSF_Settings_AudioAlert.svg
Interim Results are populated in the results area whenever the alert ON/OFF status is met. The Dashboard Gauge also provides a visual representation.
Optical Alert
Channel

Part of the test requires you to understand when an optical alert happened in the vehicle. You can select an optical alert channel to use in the dropdown list.
 

ON

You must set a value for the optical alert to activate and whether this should happen when the channel is rising or falling.
 

OFF

You must set a value for the optical alert to deactivate and whether this should happen when the channel is rising or falling.

 VBTS_UNR79_CSF_Settings_OpticalAlert.svg
Interim Results are populated in the results area whenever the alert ON/OFF status is met. The Dashboard Gauge also provides a visual representation.
Lane Selection
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. 

 VBTS_UNR79_CSF_Settings_LaneSelection.svg

 Test Results Area

The Test Results area is the area that displays all of the results from the current test. In this area, you can include/exclude results from the Chart area, display the average/max/min values and also easily identify any runs that have not met the pass criteria.

Every time you start a new test (via the START button on the dashboard), or load a new file, a new tab will be added to the Test Results area. This gives you the ability to switch between separate tests or files and compare runs from each. You can remove a session from the Test Results area by clicking on the X icon on the session tab.

Note: Whenever you make any changes to the test configuration, maths channels, vehicle dimensions, test units or session data, Test Suite will perform a file scan to apply the changes to the loaded files and update the Test Results, Map and Chart areas.  If you, for any reason, want to cancel this results scan, you can click the red X in the top right corner of the workspace. This will keep the updated settings but will not update the Test Results, Map and Chart areas accordingly.  
Rename File

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).

Edit Session Data

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.

Result Columns

VBTS_UNR79CSF_Results Columns.png

The Test Results area has the following default columns:

Run Indicates which run number the results relate to, with run one being the first run completed.

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.
Time (s) The total time the run has taken.
Lane Cross  A YES/NO indication of whether the vehicle crossed the lane. If the Lane is crossed, the whole run will be highlighted light red.
Interim Results

Whenever the Audio Alert or Visual Alert On/Off status is met, interim results are populated in the Test Results area as a new window next to the main results. If you select multiple runs, the window will display the interim results from the last selected run.

Time (s) The total time from the start of the test run until the line condition was met.
Delta (s) The time difference between results.
Audio Alert The Audio alert status.
Optical Alert The Optical alert status.
Px L1 Point on the vehicle that the closest range is referencing in relation to Lane 1.
Range L1 Range from closest vehicle point to Lane 1.
Px L2 Point on the vehicle that the closest range is referencing in relation to Lane 2.
Range L2 Range from closest vehicle point to Lane 2.

You can add, edit and sort columns in the same way as you can in the results window, however, the Line results will have slightly different reporting conditions.

These are:

  • Avg
    The mean average of the parameter during the run.
  • Max 
    The maximum value of the parameter during the run.
  • Min 
    The minimum value of the parameter during the run.
  • Delta 
    The difference between the start and end value of the parameter.
  • At Line 
    The value of the parameter when the line condition was met.
  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Article type
    Reference
    Audience
    Public
  2. Tags
    1. status:draft