The TKPH plugin for VBOX Test Suite gives you the ability to generate reports to summarise the performance across different circuits and check if the vehicle TKPH is exceeding the tyre TKPH.
The plugin includes features such as algorithms for cycle TKPH, average TKPH, Michelin/Bridgestone TKPH corrections and inputs for Load/Dump locations, ambient temperature, vehicle weight data and tyre specification data.
The TKPH plugin as a unique Test Setup ribbon, from which you can configure the test and test area.
Image missing
Image missing
Click on the Configure button to open the Settings window where you can define the parameters of the test.
Click on the Report button to create a report from the current test results.
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 Mining 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.
Image missing
Image missing
Click on the Add Gate button to add a virtual gate to the chart and map at the point of the cursor. Gates are indicated by green lines. The currently selected gate will be indicated by a blue line.
You can now use the gates to define start and/or end conditions.
Image missing
Click on the Add Gate button to add a virtual gate to the chart and map at the point of the cursor. Gates are indicated by green lines. The currently selected gate will be indicated by a blue line.
You can now use the gates to define start and/or end conditions.
Note: Opening a plugin (either as a new tab or overwriting an existing one) will clear all set gates, requiring you to redefine the gates before you amend the test configuration to set start/end conditions.
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:
Vehicle
- Vehicle ID
- Vehicle Type
- Vehicle Specification
- Fleet
- Time Zone
Weight
- Empty Vehicle Weight (tonnes)
- Empty Weight Distribution
- Front
- Rear
- Payload (tonnes)
- Loaded Weight Distribution
- Front
- Rear
- Number of Wheels
- Front axle
- Rear axle
Ambient Temperature
- Day Shift Max (°C)
- Night Shift Max (°C)
Tyre Data
- Add Tyre
- Edit Tyre
- Filters
- Rim
- Brand
- Select tyres for analysis
- Use
- Delete
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.
In 'Chart', you will see several mining-specific parameters when you click on Y-Axis. Note that the X-axis is displayed as elapsed time, whereas calculations are based on UTC time so the exact shape may not be reflected in the Report, which produces results against an X-axis of local time.
Cycle TKPH represents the TKPH value calculated for that cycle, from the load point to the following dump point to the following load point. Front and Rear Cycle TKPH values can be represented in the Chart area.
Moving avg. represents the rolling average of TKPH based on the interval set in Test Configuration (default set to 4-hour moving average). If no load/dump locations are defined, it will be assumed that half of the time is spent loaded and half of the time is spent unloaded. Front and Rear moving avg. values can be represented in the Chart area.
Image missing
On the Map, you can define load/dump locations by selecting Add Region. This allows the software to detect whether a vehicle is loaded or unloaded based on regular movements.
Ensure that the region is placed correctly so as not to miss any areas in which load status may have changed. For instance, make sure all dump locations are captured as dump regions and all load points are captured as load regions. To reduce the chance of error, avoid load/dump regions at traffic hold points, such as intersections.
You can also rename load/dump locations as the relevant circuit will be represented in Results and the Report as “Load”-“Dump”-“Load”.
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 an Accel 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.
Average Over (h)
This setting configures the time period, n hours, as a subset of the full VBOX data set over which the TKPH Moving Average is calculated.
This setting will affect the calculation of the Moving avg. Front TKPH and Moving avg. Rear TKPH, which can be selected as parameters on the Chart.
This setting will also affect the calculation of the Avg and Avg (Mich) trendlines on the Front TKPH by Local Date and Time chart, which is displayed on the Report.
This value is often taken as a 4 hour moving average, or a 6 hour moving average is sometimes applied for 63” tyres.
Average Over (h)
This setting configures the time period, n hours, as a subset of the full VBOX data set over which the TKPH Moving Average is calculated.
This setting will affect the calculation of the Moving avg. Front TKPH and Moving avg. Rear TKPH, which can be selected as parameters on the Chart.
This setting will also affect the calculation of the Avg and Avg (Mich) trendlines on the Front TKPH by Local Date and Time chart, which is displayed on the Report.
This value is often taken as a 4 hour moving average, or a 6 hour moving average is sometimes applied for 63” tyres.
Day Shift Start / Night Shift Start
This setting configures the two shifts, to which the user can assign two ambient temperature values.
This setting will affect the calculations of Bridgestone and Michelin corrections, which refer to ambient temperature. These results can be seen on the Front TKPH by Local Date and Time chart, which is displayed on the Report.
The default value for Day Shift Start is 7am and the default value for Night Shift Start is 7pm. The start times do not necessarily need to be the start of day shift or night shift, as this is an identifier to represent a change in temperature.
Day Shift Start / Night Shift Start
This setting configures the two shifts, to which the user can assign two ambient temperature values.
This setting will affect the calculations of Bridgestone and Michelin corrections, which refer to ambient temperature. These results can be seen on the Front TKPH by Local Date and Time chart, which is displayed on the Report.
The default value for Day Shift Start is 7am and the default value for Night Shift Start is 7pm. The start times do not necessarily need to be the start of day shift or night shift, as this is an identifier to represent a change in temperature.
Day Shift Max / Night Shift Max
This setting configures the default value of the Ambient Temperature to apply to the two daily time periods labelled as Day Shift and Night Shift.
This setting will affect the calculations of Bridgestone and Michelin corrections, which refer to ambient temperature. These results can be seen on the Front TKPH by Local Date and Time chart, which is displayed on the Report. Ambient Temperature refers to the maximum temperature in the shade. If there is existing temperature information stored on the VBOX file as Session Data, then these values will not be used.
The default value for Day Shift Max and Night Shift Max is 38 °C. This will result in no ambient temperature corrections being made as the TKPH ratings for tyres are rated at 38 °C. An overall maximum temperature in the shade can be applied by setting this temperature value to both fields. Alternatively, two levels of resolution for Ambient Temperature can be achieved with both field entries.
Day Shift Max / Night Shift Max
This setting configures the default value of the Ambient Temperature to apply to the two daily time periods labelled as Day Shift and Night Shift.
This setting will affect the calculations of Bridgestone and Michelin corrections, which refer to ambient temperature. These results can be seen on the Front TKPH by Local Date and Time chart, which is displayed on the Report. Ambient Temperature refers to the maximum temperature in the shade. If there is existing temperature information stored on the VBOX file as Session Data, then these values will not be used.
The default value for Day Shift Max and Night Shift Max is 38 °C. This will result in no ambient temperature corrections being made as the TKPH ratings for tyres are rated at 38 °C. An overall maximum temperature in the shade can be applied by setting this temperature value to both fields. Alternatively, two levels of resolution for Ambient Temperature can be achieved with both field entries.
Michelin Corrections
This setting configures if Michelin Corrections, as per the tyre manufacturer's earthmover data book, are displayed on the Report.
This setting only affects the Front TKPH by Local Date and Time chart, which will include lines to represent a Moving Average with Michelin Corrections applied and Cycle TKPH with Michelin Corrections applied if Cycle is ticked.
This allows users to display or hide lines on the Front TKPH by Local Date and Time chart, which can be useful to adjust the Report to easily focus on particular areas.
Cycle
This setting configures if Cycle TKPH is displayed on the Report.
This setting only affects the Front TKPH by Local Date and Time chart, which will include lines to represent Cycle TKPH if checked.
This allows users to display or hide lines on the Front TKPH by Local Date and Time chart, which can be useful to focus on particular areas of the Report.
Table of Cycles
This setting only affects the last page of the report, which will generate a Table of Cycles if checked.
This allows users to check Michelin Corrections on a cycle-by-cycle basis.
Michelin Corrections
This setting configures if Michelin Corrections, as per the tyre manufacturer's earthmover data book, are displayed on the Report.
This setting only affects the Front TKPH by Local Date and Time chart, which will include lines to represent a Moving Average with Michelin Corrections applied and Cycle TKPH with Michelin Corrections applied if Cycle is ticked.
This allows users to display or hide lines on the Front TKPH by Local Date and Time chart, which can be useful to adjust the Report to easily focus on particular areas.
Cycle
This setting configures if Cycle TKPH is displayed on the Report.
This setting only affects the Front TKPH by Local Date and Time chart, which will include lines to represent Cycle TKPH if checked.
This allows users to display or hide lines on the Front TKPH by Local Date and Time chart, which can be useful to focus on particular areas of the Report.
Table of Cycles
This setting only affects the last page of the report, which will generate a Table of Cycles if checked.
This allows users to check Michelin Corrections on a cycle-by-cycle basis.
This setting configures the duration of time over which the vehicle must be considered stationary in a load area for a load event to take place.
This affects each valid run (i.e. cycle) to signal a change in load status. Therefore, this affects all calculations of operating site TKPH, as well as the Vehicle Weight Channel introduced in the Chart.
It is expected that a load event will take a longer time to take place than a dump event, therefore an appropriate default value has been assigned for this duration. Once GPS speed drops under 0.8 km/h in the load area, the vehicle is considered stationary and when the Minimum load time elapses whilst the vehicle remains stationary (or below Maximum load speed), this will constitute a load event.
Although a sufficiently high value may ensure the real load event is captured (and not a brief stop before departing the load area for example), the higher the value the more susceptible it would be to incorrectly detect cycles. If cycles are not being detected as expected, this value can be reduced to ensure the stationary period will be considered as a change in load status. However, with a low value, actual loading time may not be captured accurately.
Minimum dump time (s)
This setting configures the duration of time over which the vehicle must be considered stationary in a dump area for a dump event to take place.
This affects each valid run (i.e. cycle) to signal a change in load status. Therefore, this affects all calculations of operating site TKPH, as well as the Vehicle Weight Channel introduced in the Chart.
It is expected that a dump event will take less time to take place than a load event, therefore a default value of 0.5 seconds has been assigned for this duration. Once GPS speed drops under 0.8 km/h in the dump area, the vehicle is considered stationary and when the Minimum dump time elapses whilst the vehicle remains stationary (or below Maximum dump speed), this will constitute a dump event.
Maximum load speed (km/h)
This setting configures a limit so, in a load area, any speed value below this limit is still considered as the vehicle remaining stationary.
This affects each valid run (i.e. cycle) to signal a change in load status. Therefore, this affects all calculations of operating site TKPH, as well as the Vehicle Weight Channel introduced in the Chart.
This allows users to mitigate noisy data which may cause erratic speed values when the vehicle is actually stationary. This setting only applies after the vehicle initially becomes stationary (i.e. speed < 0.8 km/h), and will not work if the vehicle does not come to a complete stop in the load area.
Maximum dump speed (km/h)
This setting configures a limit so, in a dump area, any speed value below this limit is still considered as the vehicle remaining stationary.
This affects each valid run (i.e. cycle) to signal a change in load status. Therefore, this affects all calculations of operating site TKPH, as well as the Vehicle Weight Channel introduced in the Chart.
This allows users to mitigate noisy data which may cause erratic speed values when the vehicle is actually stationary. This setting only applies after the vehicle initially becomes stationary (i.e. speed < 0.8 km/h), and will not work if the vehicle does not come to a complete stop in the dump area.
Moving average interval (s)
This setting configures the duration, in seconds, of the interval where TKPH is calculated for each interval to build a Moving Average value out of regular sized intervals.
This setting affects the Moving Average calculation, and therefore has an impact on any instance of the TKPH Moving Average.
“n second TKPH” values are used to build the TKPH Moving Average. A “n second TKPH” value is calculated like Cycle TKPH, but the length of the cycle is n seconds and the load status is checked at the start of the n second interval. When load and dump areas are not defined, the moving average will assume a 50%/50% split of time spent loaded and time spent unloaded for the moving average TKPH calculation.
Log Calculations to CSV
This setting configures if cycle calculations, which include Bridgestone and Michelin corrections, are generated as a Comma Separated Value (.csv) file for the user.
If checked, this will generate files to be located in C:\ProgramData\Racelogic\VBOXTestSuite\Mining.
If checked, this will take longer to generate results, so this functionality is recommended only for investigating particular results and not for general use.
This setting configures the duration of time over which the vehicle must be considered stationary in a load area for a load event to take place.
This affects each valid run (i.e. cycle) to signal a change in load status. Therefore, this affects all calculations of operating site TKPH, as well as the Vehicle Weight Channel introduced in the Chart.
It is expected that a load event will take a longer time to take place than a dump event, therefore an appropriate default value has been assigned for this duration. Once GPS speed drops under 0.8 km/h in the load area, the vehicle is considered stationary and when the Minimum load time elapses whilst the vehicle remains stationary (or below Maximum load speed), this will constitute a load event.
Although a sufficiently high value may ensure the real load event is captured (and not a brief stop before departing the load area for example), the higher the value the more susceptible it would be to incorrectly detect cycles. If cycles are not being detected as expected, this value can be reduced to ensure the stationary period will be considered as a change in load status. However, with a low value, actual loading time may not be captured accurately.
Minimum dump time (s)
This setting configures the duration of time over which the vehicle must be considered stationary in a dump area for a dump event to take place.
This affects each valid run (i.e. cycle) to signal a change in load status. Therefore, this affects all calculations of operating site TKPH, as well as the Vehicle Weight Channel introduced in the Chart.
It is expected that a dump event will take less time to take place than a load event, therefore a default value of 0.5 seconds has been assigned for this duration. Once GPS speed drops under 0.8 km/h in the dump area, the vehicle is considered stationary and when the Minimum dump time elapses whilst the vehicle remains stationary (or below Maximum dump speed), this will constitute a dump event.
Maximum load speed (km/h)
This setting configures a limit so, in a load area, any speed value below this limit is still considered as the vehicle remaining stationary.
This affects each valid run (i.e. cycle) to signal a change in load status. Therefore, this affects all calculations of operating site TKPH, as well as the Vehicle Weight Channel introduced in the Chart.
This allows users to mitigate noisy data which may cause erratic speed values when the vehicle is actually stationary. This setting only applies after the vehicle initially becomes stationary (i.e. speed < 0.8 km/h), and will not work if the vehicle does not come to a complete stop in the load area.
Maximum dump speed (km/h)
This setting configures a limit so, in a dump area, any speed value below this limit is still considered as the vehicle remaining stationary.
This affects each valid run (i.e. cycle) to signal a change in load status. Therefore, this affects all calculations of operating site TKPH, as well as the Vehicle Weight Channel introduced in the Chart.
This allows users to mitigate noisy data which may cause erratic speed values when the vehicle is actually stationary. This setting only applies after the vehicle initially becomes stationary (i.e. speed < 0.8 km/h), and will not work if the vehicle does not come to a complete stop in the dump area.
Moving average interval (s)
This setting configures the duration, in seconds, of the interval where TKPH is calculated for each interval to build a Moving Average value out of regular sized intervals.
This setting affects the Moving Average calculation, and therefore has an impact on any instance of the TKPH Moving Average.
“n second TKPH” values are used to build the TKPH Moving Average. A “n second TKPH” value is calculated like Cycle TKPH, but the length of the cycle is n seconds and the load status is checked at the start of the n second interval. When load and dump areas are not defined, the moving average will assume a 50%/50% split of time spent loaded and time spent unloaded for the moving average TKPH calculation.
Log Calculations to CSV
This setting configures if cycle calculations, which include Bridgestone and Michelin corrections, are generated as a Comma Separated Value (.csv) file for the user.
If checked, this will generate files to be located in C:\ProgramData\Racelogic\VBOXTestSuite\Mining.
If checked, this will take longer to generate results, so this functionality is recommended only for investigating particular results and not for general use.
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 the 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. |
The ambient temperature during the circuit.
This figure will be either the Day or Night shift ambient temperature depending on the time of day and the configured shift start times.
The software will automatically add columns based on the configured settings.