The Test Setup tab is where you can control and configure the currently selected test. The tab will be opened when you click anywhere in the test area in the workspace.
This tab will be unique to each available test plugin. You can see an overview of the available test plugins and find more information about each plugin here.
Regardless of the selected plugin, the Test Setup tab will contain the following options:
Click on the Configure button to open the Settings window where you can define the parameters of the test, including the start and end conditions and the pass conditions. You can expand or collapse a parameter heading by clicking on the Up and Down arrows on the right-hand side of the heading.
Click on the Report button to create a report with the current test results and save it to a chosen location on your computer.
The Test Setup tab in VBOX Test Suite always contains a Maths Channels facility that you can use to create a new channel with a combination of the existing parameters, numbers and mathematical functions.
For example, taking the vertical velocity channel, dividing it by the speed channel and multiplying by 100, thus creating gradient as a percentage.
Click on the Maths Channels button in the Test Setup tab on the ribbon to open the Maths Channels pop-up.
Any existing maths channels will be displayed on the left-hand side of the pop-up window.
You can use a created maths channel wherever the software lets you add a channel, such as for a gauge on the dashboard, a channel in a test configuration, a column in the Test Results or as an axis on a chart.
You can add a new maths channel by clicking on the + button in the top left corner of the Maths Channels window. Select the new channel in the list on the left to edit it.
Enter the maths expression using the drop-down lists for available Channels and Functions.
Enter a name for the maths channel. If you require a unit to be included with the channel in the .vbo file, you can enter a value in the text box below the channel name. Click OK to save changes or Cancel to exit without saving any changes.
If you save a VBOX data file from the software, configured maths channels are included in the file.
You can remove maths channels by selecting the relevant channel on the left and clicking on the x button in the top left corner of the window.
Channels
The standard channels are the GNSS channels that are captured by default. These can always be accessed. The additional channels are any configured CAN channels or any existing maths channels.
Click on the down arrow for a channel to see the extra functions that can be applied, including Current, Previous, Rate of change, Integration and Accumulative.
Functions
You can see a list of the supported functions below. Constants of G and PI are also supported.
| Function | Description |
|---|---|
| + | Add |
| - | Subtract |
| * | Multiply |
| / | Divide |
| % | Remainder |
| << | Bitwise left shift, the most-significant bit is lost, and a 0 bit is inserted on the other end, multiplies a binary number by 2 |
| >> | Bitwise right shift, the least-significant bit is lost, and a 0 bit is inserted on the other end, divides positive numbers by 2 |
| & | Bitwise AND, whenever the value of a bit in both the variables is 1, then the result will be 1 or else 0 |
| | | Bitwise OR, whenever the value of a bit in one of the variables is 1, then the result will be 1 or else 0 |
| ^ | Bitwise XOR, whenever only one variable holds the value 1, then the result is 0 else 0 will be the result |
| == | Equality, checks whether equal, returns 1 for true or 0 for false |
| != | Non-equality, checks whether unequal, returns 1 for true or 0 for false |
| <= | Less than or equal, returns 1 for true or 0 for false |
| >= | Greater than or equal, returns 1 for true or 0 for false |
| < | Less than, returns 1 for true or 0 for false |
| > | Greater than, returns 1 for true or 0 for false |
| Abs(x) | Absolute |
| Acos(x) | Arc cosine, returns degrees |
| Asin(x) | Arc sine, returns degrees |
| Atan(x) | Arc tangent, returns degrees |
| Ceiling(x) | Round up to the nearest integer |
| Cos(x) | Cosine, returns degrees |
| Cosh(x) | Hyperbolic cosine, returns degrees |
| Deg(x) | Convert radians to degrees |
| Exp(x) | Exponential function |
| Floor(x) | Round down |
| Heaviside(x) | Returns 0 if x less than 0, otherwise returns 1 |
| If(x_y_z) | If else condition. Returns y if condition x is true, otherwise will return z |
| Integer(x) | Integer part of x |
| Ln(x) | Natural log of x |
| Log(x_y) | Log of x and y |
| Log10(x) | Logarithm to the base 10 |
| Max(a_b_c_...) | Maximum of all |
| Min(a_b_c_...) | Minimum of all |
| Modf(x) | Fraction part of x |
| Pow(x_y) | Raise x to the power of y |
| Rad(x) | Convert degrees to radians |
| Round(x_y) | Round the number x to y decimal places |
| Sin(x) | Sine, returns degrees |
| Sinh(x) | Hyperbolic sine, returns degrees |
| Sqrt(x) | Square root |
| Tan(x) | Tangent, returns degrees |
| Tanh(x) | Hyperbolic tangent, returns degrees |
Click on the Save Settings button to save the current test setup. It will be added to the Saved Settings area of the Add Test window and to the list of tests under the Performance Test button on the Home tab.
You can export the results by right-clicking anywhere in the Test Results area and selecting Export or clicking Export in the Test Setup ribbon.
You can add columns to the Test Results area by clicking the Add button on the Test Setup ribbon or right-clicking anywhere in the Test Results area and selecting the Add option. This will display a drop-down list of all the available channels to display in a results column. By default, this value is displayed as an At End value, which will display the value of the parameter at the end of the run.
You can remove a column by clicking the X that appears when you hover over the column title. If you have removed a column, you can add it again by clicking the Add button and selecting the desired channel.
If you want to add a maths channel column to the results, you can right-click in the Test Results area and select Add Calculated or click the Add button on the Test Setup tab and select Calculated. This column will then use data from he other results columns to create custom results.
By default, a column is added without a condition. You can change this by clicking on the column header for the channel you wish to add a condition for. The selected column will be highlighted in yellow. Click on the condition dropdown in the Data column area on the Test Setup tab and select the required condition.
You can choose the following conditions for the main results:
- 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 at the crossing of the specified gate line (e.g. Start/Finish).
You can change the displayed parameter, by selecting a parameter from the dropdown menu above.
You can sort the results in ascending or descending order. To do this, you must click on the relevant column to select it and then click on the Sort Ascending or Sort Descending button on the Test Setup ribbon or right-click in the Test Results area and select the option you need.
The Select All button allows the user to tick each run in the Test Results area at once. This can also be accessed by using the keyboard shortcut Ctrl+A.
The Deselect All button allows the user to deselect every run in the Test Results area at once. This can also be accessed by using the keyboard shortcut Ctrl+E.
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.