Skip to main content

Data Viewer

Data Viewer is designed to be a simple visualization tool for attached data files. It provides the ability to view the vehicle data logs within the context of the session and run data stored in HH Data Management. Primary use cases include:

  • Comparing vehicle or driver performance
  • Viewing the output of math calculations
  • Sharing data analysis between users

Data Viewer can be accessed from the Event tab of the ribbon bar:

Data Viewer plots can be dragged and tiled by the user in a custom layout:

Data Viewer configuration requirements

The Data Analysis profile must define a distance channel - either as a Data channel found in the data file, or a Math channel calculated by HH Data Management.

The Distance channel must be selected in the ribbon bar of the Data Viewer.

Data file selection

Clicking the Add button in the left pane will open the file selection window:

The window provides two functions:

  1. Control the loading of the caches into the view
  2. Selection of the data to be shown in the viewer

The combo boxes at the top are used to control the cache loading. After selecting the desired values in the combo boxes the "Load" buttons are used to load all caches based on the selection:

  • Load all categories - loads all cars from all categories within the selected event
  • Load all cars - loads all cars from the selected category
  • Load car - loads the selected car

Once the caches are loaded, any runs or sessions with attached files of supported file format types, will be shown in the table.

This table can be filtered and sorted by session, category, car, attached file name, etc. using the column headers:

Before data files can be displayed in the Data Viewer graph, they must be locally available. The file selection window provides a column with the file status, and two ways to download files without leaving the Data Viewer:

  • Click the Download button in the Status column
  • Select the desired rows and click the Download Selected Files button

Data files with the "Available" status can be opened in the Data Viewer by the user selecting the rows and clicking OK

The opened data files are displayed in the left pane of the Data Viewer:

There are two features that help to locate the run with the fastest lap of a session overall, and the fastest lap of a session per car.

The show best runs checkbox will filter the list to show only the runs that have the fastest overall lap of the session:

To show the run with the fastest lap for each car, the final column can be used to filter on the value "checked":

Graph Configuration

After the user selects the Data Analysis profile, the Edit Graphs button will be enabled.

The Edit Graphs button will open the graph configuration window.

Using the Add drop-down menu at the bottom of the Graph Configuration window, the user may define several plots to be displayed on one data viewer tab.

Two plot types are available:

  • Time/Distance
  • Scatter

Time/Distance Plots

Configuration

The user can add and remove channel groups and channels with the four buttons at the bottom of the window.

tip

The Min and Max setting for channel groups will control the display limits of the related axes.
For automatic scaling, use Ctrl + Del to clear any previously set value.
For manual scaling, enter numeric values in the cells.

The "Add Channel" button opens a window with a list of all channels defined in the Data Analysis profile. The window has a search box to make channel selection easier in large data sets.

Plot View

A Time/Distance Plot may look like this:

The top toolbar of each plot panel has quick-access settings for each plot:

  • Settings button to open the Graph Configuration window
  • Variance (Time Delta) toggle button
  • Time/Distance mode toggle button
  • Show/Hide offset axis
  • Zero offset button
  • Copy screenshot to Clipboard
  • Save screenshot to disk
  • Set screenshot size
  • Maximize/restore plot panel

Variance

The Variance toggle will add a subplot at the top of the panel and show the time delta between the overlays. The Variance is best displayed when the X Axis is set to Distance mode:

Offset Axis

The offset can be adjusted by dragging the secondary X axis when the "Offset Overlay" toggle is enabled. Disabling the offset axis will not clear the offset. The "Clear Overlay Offset" button will reset the offset to zero.

Plot Controls and Input Interactions

Mouse

  • Mouse Wheel - coarse zoom in/out
  • Ctrl + Mouse Wheel - fine zoom in/out
  • Ctrl + Drag - pan X axes
  • Shift + Drag - select zoom window
  • Offset X axis - move the overlay axis by dragging the X axis below the main plot area
  • Double Click - reset zoom to selected lap

Keyboard

  • Left Arrow/Right Arrow - move cursor
  • Up Arrow/Down Arrow - coarse zoom in/out
  • Ctrl + Up Arrow/Down Arrow - fine zoom in/out step
  • Shift + Left/Right - pan X axes
  • P/N - previous/next lap on primary overlay
  • W - zoom to the lap selected in the file tree
  • F2 - zoom out to full extent of the primary overlay

Scatter Plots

Configuration

  • The X Axis Channel group can contain only a single channel.
  • The Y Axis Channels group can contain more than one channel.

Plot View

An example of a Scatter Plot:

The top toolbar of the plot panel has quick-access settings for the scatter plot:

  • Settings button to open the Graph Configuration window
  • Line/Point mode toggle button
  • Copy screenshot to Clipboard
  • Save screenshot to disk
  • Set screenshot size
  • Maximize/restore plot panel

Plot Controls and Input Interactions

Mouse

  • Mouse Wheel - coarse zoom in/out
  • Click + Drag - select zoom window
  • Double Click - reset zoom

Keyboard

  • P/N - previous/next lap on primary overlay
  • W - zoom to the lap selected in the file tree

Overlays and Plot Settings

Data Viewer supports showing an overlay of another lap from the same or different data file. To add a plot overlay, the user can select the checkbox in the second selection column

Screenshots

Data Viewer has the option to export a screenshot to a file or copy it to clipboard.

The resulting image will show the selected file context in the title above the graph.