Map

Last updated
Save as PDF
Share
1. Share
2. Tweet
3. Share

This page contains information about the Map tab in the ribbon in VBOX Test Suite.

The Map area is an area that shows a positional trace from either the saved data in a file or from real-time, live data. A location cursor will indicate the location of the vehicle. To provide the greatest accuracy, the map uses the EGM 96 Geoid of Earth.

Display

Zoom In

Click on the Zoom In button to zoom in on the map, centred around the cursor position.

Zoom Out

Click on the Zoom Out button to zoom out on the map, centred around the cursor position.

Reset Zoom

Click on the Reset Zoom button to return the map to full view.

Scale

Click on the Scale button to add a scale to the map. Click on the button again to remove the scale from the map window.

Show Aerial Image/Road Map

Click on the arrow button under the Show Aerial Image/Road Map button to see a dropdown menu where you can select between the two modes: Aerial Image or Road Map. The icon and dropdown menu title will change depending on the selected option.

Aerial Image
This will overlay an aerial image onto the Map area. Click on the main button to enable the image, and click it again to disable it.

Road Map
This will overlay a road map onto the Map area. Click on the main button to enable the map, and click it again to disable it.

Note: You must have an active internet connection to use this feature.

Centre on Vehicle

Click on the Centre on Vehicle button to centre the vehicle in the map. Click on the button again to stop centering the vehicle.

Vehicle Up

Click on the Vehicle Up button to change the map orientation so that the vehicle is always pointing up on the map, instead of the default North up behaviour.

Note: In Online mode, Vehicle Up is enabled by default.

Path Follow

Click on the Path Follow button to change the map behaviour and make it easier to follow a predefined path. This mode predicts where the vehicle will be in x seconds based on the vehicle’s current speed and heading.

Activating this mode will display a pop-up window where you can configure how the mode should operate.

Click on the OK button to close the window and apply the Path Follow settings.

Click on the Turn Off button to close the window without applying the mode or saving the changes.

Predict Ahead (s)
The Predict ahead option changes the number of seconds that the software will predict the path ahead.

Colour
Click on the colour sample to see a colour options window and change the colour of the prediction line on the map.

Line Width
Set the line width for the prediction line to a level between 1 and 10.

Display previous (s)
The Display previous option determines how many seconds of the previous path will be displayed. Tick the box to enable the option and set the length of the trace by modifying the number of seconds.

Smooth Over (s)
Change the time at which the vehicle path will be smoothed. A higher value will yield a more stable line but will be less responsive to dynamic change.

Show arrow on predictive line
Tick this box to display an arrow on the predictive line on the map to denominate the vehicle.

Heat Map

Click on the Heat Map button to open the Heat Map pop-up window and configure the heat map feature.

This feature adds colour to the map to highlight a channel value at that location. You can, for example, choose to show a heat map of Speed or X Accel. If you select one or more runs, the heat map colour is derived from data of the selected run(s). Otherwise, the colour is derived from the whole session. If there are multiple data points in the same area, the points will be averaged.

VBTS_Heat Map Settings_450.png

VBTS_Heat Map.png

Click on the OK button to close the window and apply the Heat Map settings.

Click on the Turn Off button to close the window without applying the mode or saving the changes.

Channel
The Channel that will be marked on the map.

Absolute
Tick this box to denote Absolute Value. This eliminates the need to create a maths channel for lateral acceleration.

Radius (m)
The radius of data that will be grouped when the software calculates the required heat.
Type the required number of meters directly into the value box or use the arrow buttons next to the value box to increase/decrease the value.

From Colour
This setting will display the currently selected colour for the lowest value in the Heat Colour Range.
You can change the colour by clicking on the colour square to open the colour selector. Pick a colour or define a custom colour and click OK to add it to the Heat Map.

To Colour
This setting will display the currently selected colour for the highest value in the Heat Colour Range.
Click on the colour square to open the colour selector. Pick a colour or define a custom colour and click OK to add it to the Heat Map.

Auto
Tick this box to have VBOX Test Suite set the Min. and Max values for the Heat Colour Range.

Heat Colour Range
Set the Min and Max values for the Heat Colour Range.

Map Tool

Zoom X-Y

Click on the Zoom X-Y button to enable a ‘box zoom’ of the selected area when you left-click and dragging the cursor to the right on the map. Left-click and drag the cursor to the left to return to the full view.

Pan

Click on the Pan button to pan the map by left-clicking and dragging on the it.

Measure

Click on the Measure button to enable the measurement feature.

When this is enabled, you can left-click and drag on the map to insert a measurement line to measure the distance between two points on the map.

After you have measured a distance, you can drag the ends of the line to change the start/end point. This gives you the ability to zoom in and fine-tune the start/end point.

Vehicle

Style

Click on the Style button to configure the style of the position trace and the cursor display.

Position Trace - Show sampled points
Tick this box to see the sampled points in the trace on the Map.

Position Trace - Show Targets
If you load a VBOX file with ADAS targets, VBOX Test Suite can display these targets on the map during the file analysis.

Tick this box to show any configured Remote Targets on the Map.

File
Use the dropdown list to select the VBOX file in which you want to edit the trace style(s).

Position Trace - Line Style

Click on the coloured square to change the colour of the trace line.
Use the Line Style dropdown menu to choose between Solid, Dashed and Dotted.
Edit the thickness of the trace line by increasing/decreasing the value under Line Thickness.

Cursor Display - Type
Set the type of cursor by selecting an option in the dropdown menu: Cross, Circle, Triangle or Square.

Cursor Display - Size
Set the size of the cursor by selecting a value for this option.

Cursor Display - Thickness
Set the thickness of the cursor by selecting a value for this option.

Cursor Display - Colour
Click on the coloured square to change the colour of the cursor.

Vehicle Overlay

Click on the Vehicle Overlay button to open a pop-up where you can create a shape to represent the dimensions of the vehicle in the Map area.

When you enter the vehicle size and antenna placement offsets, the software will create a 4-sided object representing the vehicle and will overlay this on the cursor on the map.

Click OK to close the window and apply the vehicle shape. Click the Turn Off button to close the window without applying the shape or saving the changes.

You can change the colour of the represented vehicle by clicking on the existing colour in the top right-hand corner of the window.

Click on Advanced to expand the window and enable a vehicle point editing functionality, where you can create custom shapes for the vehicle.

Press the + button next to any point in the list to add another point underneath. Configure these points by entering antenna offset values.

The vehicle points will be visible when you view the overlay on the map.

Clicking on Reset in the bottom left corner will revert the window to the standard window and disregard any changes. Click on Remove to remove the vehicle dimension object from the Map area.

Click on the OK button to close the window and apply the vehicle shape to the map. Click on Cancel to close the window without applying the shape or saving the changes.

You can export or import vehicle overlays as a .VEH file by selecting the Up/Down arrow dropdown menu and select Import or Export.

The direction of the represented vehicle is determined by the calculated channels are being calculated.
The channel order used to calculate the direction of the vehicle is:

RobotHead
True_Head2
True_Head
Head_imu2
Heading

Data

Load Line

When VBOX Test Suite detects an ADAS object in a .vbb file, it will automatically add it to the Map as a non-editable black line.

Click on the Load Line button to open a pop-up window with an overview of all loaded lines/objects.

In this popup, you can:

Remove a loaded object by clicking on the X to the right of it.
Change the line colour of an object by clicking on the coloured square to the left of it and selecting a new colour.
Enable labels on the objects in the Map by ticking the Show Label option.
Load a new reference path (.vbb, .vbo, .dbn, .vbc or .cir file) that can be used with the path follow mode, or as a visual reference.

When you load a path, the software will automatically calculate the perpendicular distance from the lane to the vehicle and the distance from the lane to the predicted point.

You can also display these channels on the dashboard and in a graphical trace on the chart.

Export to KML

Click on the Export to KML button to select the file you want to export the positional trace from to a .KML file that can be understood by programs such as Google Earth.

Gate

The Gate area will mirror the gate options available in each test. You can find more information on the individual Test Page. If you have not chosen a test, the Gate area will default to the following:

Add Gate

Click on the Add Gate button to add a virtual gate to the chart and map at the point of the cursor. The gates are indicated by green lines. The currently selected gate will be indicated by a blue line.

When you have added a gate, you can specify the gate width. The default gate width is 20 m.

You can now use the gates as start or end conditions.

Notes:

If you change the gate width, the last used gate width will be used as the default width for the next gate.
Opening a plugin (either as a new tab or overwriting an existing one) will clear all set gates. If you do this you must, therefore, redefine the gates before you amend the test configuration to set start/end conditions.

Rename

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

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

Export

Click on the Export button to export the created gate(s) as an .spl file that can be reused at a later date and can be used with other VBOX products.

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 gate lines.

Import

Click on this button to import a previously saved or provided .spl file. When this is imported, the gates will be added in the order that they were saved in the .spl file.

Help

Click the Help button in the Map tab to open a browser window and load the relevant topic from the VBOX Test Suite User Guide at the Racelogic Support Centre. This page will only be displayed if there is a valid internet connection.