Home > VBOX Automotive > Software applications > VBOX Test Suite > VBOX Test Suite User Guide > 11 - VBOX Test Suite Map

11 - VBOX Test Suite Map

The map area is an area that shows a positional trace from either the saved data contained within a file or real time live data. 

 

map1.png


 

In online mode, the map will be centred on the vehicle and will display real-time data.

Map Tab

The map tab is where the user can access all the functionality of the map. This tab will be displayed when the user clicks anywhere on the map area and will automatically be selected.

 

Map tab1.png

Zoom in

The 'Zoom in' button zooms in on the map, centred around the cursor position.

Zoom out

The 'Zoom out' button zooms out on the map, centred around the cursor position.

Reset Zoom

The 'Reset Zoom' button returns the map to full view.

Scale

The 'Scale' button will add a scale to the map. Selecting this button again will remove the scale  from the map window.

Centre on Vehicle

The 'Centre on Vehicle' button will centre the vehicle within the map in whichever part of the data is selected. Selecting this button again will remove this centring functionality.

Show Aerial Image

The 'Show Aerial Image' button will overlay an aerial image from Bing Maps onto the map area.

 

 

Note: To use this feature, there will have to be an active connection to the internet.

Vehicle Up

The 'Vehicle Up' button changes the map orientation so that the Vehicle is always pointing up the map, instead of the default ‘North up’ behaviour.

Note: In 'Online' mode this is set as default.

Path Follow

The path follow button changes the map behavior so that the user can easily follow a predefined path. This mode predicts where the vehicle will be in x seconds based on the vehicle’s current speed and heading.

Turning this mode on brings up a pop up window that allows the user to configure how the mode should operate.

 

Path Follow.png

 

Note: This feature is currently in the BETA phase and is not a fully released and supported feature.

Predict Ahead (s)

The predict ahead option changes the length of time for which the software will predict the path.

Colour

Changes the colour of the prediction line.

Line Width

Changes the width of the prediction line.

Display previous (s)

Selecting this option will show the previous path of the vehicle. The length of this trace can be changed by modifying the seconds value.

YawRate Smoothing

Allows the user to change the method of smoothing to best fit their application.

Smooth Over (s)

Changes the time at which the vehicle path will be smoothed. A higher value will yield a more stable value but will be less responsive to dynamic change.

Zoom X-Y

The 'Zoom X-Y' button defines how the left click and drag action is performed. When selected, Left clicking and dragging the cursor to the right will perform a ‘box zoom’ of that area. To return to the full view, simply click and drag the cursor to the left.

Pan

The 'Pan' button defines how the left click and drag action is performed. When selected, Left clicking and dragging the cursor will pan the map accordingly.

Vehicle Overlay

The ‘Vehicle Overlay’ button opens up a settings window where you can create a shape to represent the dimensions of the vehicle within the map area.

If 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 crosshairs within the map.

Selecting ‘OK’ will close the window and apply the vehicle shape, selecting ‘Cancel’ will close the window without applying the shape or saving changes.

Vehicle Overlay 1.png
  Vehicle Overlay 2.png
 

Selecting ‘Advanced’ will expand the window and enable a vehicle point editing functionality, allowing the creation of custom shapes for the vehicle. Pressing the ‘+’ button will add more points which can be configured by entering antenna offset values. Points can also be manually dragged in to place by selecting and holding the desired point.

 

Selecting ‘Reset’ will revert the window back to the previous standard one and will disregard the changes. Selecting ‘Remove’ will remove the vehicle dimension object from the map area.

 

Selecting ‘OK’ will close the window and apply the vehicle shape, selecting ‘Cancel’ will close the window without applying the shape or saving changes.

Export to KML

The 'Export to KML' allows the user to export the positional trace to the .kml format that can be understood by programmes such as Google Earth.

Path/Outline

Allows the user to load a reference path that can be used with the path follow mode, or as a visual reference. On the load of a path, the software will automatically calculate the perpendicular distance from the lane to the vehicle as well as the distance from the lane to the predicted point. These channels can be displayed on the dashboard and as well as a graphical trace on the chart.

Help

Pressing this 'Help' button will automatically open an internet browsing window and load the relevant section of the Racelogic Support Centre. This page will only be displayed if there is a valid internet connection.

Map Functionality

Navigating around the map

The user is presented with 3 ways to zoom the graph in and out, the first being the button in the Chart tab.

 

77.png

 

By pressing the ‘Zoom in’ or ‘Zoom out’ button, the graph will zoom in/out by 5%. The user can reset the graph to the default zoom level by pressing the ‘Reset Zoom’ button.

These buttons will also briefly appear next to the map crosshairs any time the user clicks/touches anywhere on the map trace. The user can then use these buttons as above.

 

The final way to zoom is by using the mouse. The user can either double click anywhere in the map window to slowly increment the zoom level, use the scroll wheel to zoom either in or out or (providing the ‘Zoom X-Y’ button has been selected) left click and drag to perform a ‘box zoom’.

Panning

When zoomed in, it is possible to right click anywhere within the map window and move the window around.

The same action can be performed with the left click, providing that the ‘Pan’ button has been selected on the ribbon.

You must to post a comment.
Last modified

Tags

Classifications

This page has no classifications.
Having trouble finding what you need?