Metrics¶

The Metrics page is a configurable dashboard for viewing, comparing, and exploring simulation results. It combines tables, scatter plots, violin plots and contour plots in a flexible grid, giving you both visual and numerical tools to analyse performance across many simulations — from a handful of runs to a sweep of a thousand.
Overview¶
Every simulation in ARD produces a set of summary metrics — lap time, sector times, maximum speeds, g-forces, energy consumption, and more. The Metrics page shows these metrics for all simulations currently loaded on the simulation desk, whether they come from individual runs or a Parameter Sweep.
The page is built around a configurable grid layout where you choose which cells to show, what each one plots, and how they are arranged. Layouts are saved and versioned, so you can switch between analysis workflows.
All cells share one selection: hover a run in any cell and it is picked out in all of them; select runs and they stay highlighted everywhere. See Selecting Runs.
How Racing Teams Use It¶
- Quick lap time comparison — Load several results and see which configuration is fastest in the metrics table
- Identifying correlations — Use scatter plots to check whether top speed or minimum corner speed matters more for lap time
- Sweep analysis — After a parameter sweep, use violin plots to see how lap time spreads across each value of a swept parameter, and contour plots to find a two-parameter optimum
- Where the time is — Group a violin by track sectors or speed phases to see which part of the lap a setup change gains or loses time in
- Report preparation — Save a layout with the plots and tables needed for a debrief and reuse it after each session
Grid Layout¶

The Metrics page is a grid of cells. You control the number of rows and columns, and each cell can span several of them.
Configuring the Layout¶
Click Arrange (pencil icon) next to the layout name to open the layout arranger, a full-width dialog. From here you can:
- Set the number of rows and columns in the grid
- Assign each cell a type — Table, Scatter Plot, Violin Plot or Contour Plot
- Resize cells by dragging the corner handles to span multiple rows or columns
- Set each cell's channels and options

Most options can also be changed directly on the cell — click an axis title to change its channel, for example. Every change saves automatically as a new version of the layout.
Every cell has a fullscreen button in its top-right corner.
Cell Types¶
| Cell Type | Description |
|---|---|
| Table | Every simulation's metrics in a sortable, colour-tinted table |
| Scatter Plot | Each simulation as a point with configurable X, Y and colour axes |
| Violin Plot | How a value is spread across simulations, one column per group |
| Contour Plot | A metric mapped as a colour surface over two swept parameters |
Reference Run¶
Differences — Δ and Δ% in the table, and Δ in the violin — are measured against the reference run, marked ref in the table. Set it with Ref on a row of the Staging Area (the button appears when you hover the row). If no reference is set, one is picked for you as soon as results are staged: a run whose traces are loaded, otherwise the first staged run.
Selecting Runs¶
Selection is shared by every cell on the page. It highlights runs; it only hides the others when you ask it to.
| Action | Result |
|---|---|
| Hover a run in any cell | Picks it out in all cells, including its position on contour plots |
| Click a table row or a dot | Selects or deselects that run |
| Shift-click a table row | Selects the range from the last row you clicked |
| Drag down table rows | Selects the rows you pass over (deselects, if you start on a selected row) |
| Shift-drag on a scatter, violin or contour | Selects the runs inside the box |
| + Cmd/Ctrl | Adds the box to the selection |
| + Alt | Removes the box from the selection |
| Click empty plot space or Esc | Clears the selection |
While runs are selected, the page header shows N selected · Show only selected · Clear. Show only selected filters every cell to the selection (the reference run stays).
Metrics Table¶

One row per simulation and one column per metric or swept parameter. Sim/Name is always the first column and stays in view as you scroll sideways.
Columns¶
Use the Columns button at the top left of the table to choose which metrics, swept parameters and scalar math channels are shown. Drag a column header to reorder the columns; the order is saved with the layout. Click a header to sort by that column, and again to reverse.
Absolute, Δ and Δ%¶
- Absolute — the values themselves
- Δ — each run's difference to the reference run, in the column's units
- Δ% — the same difference as a percentage of the reference value (three decimals)
In Δ and Δ% the reference row is pinned to the top and shows its absolute values.
Colour Tint¶
Each cell is tinted by how far it is from the column's mean (Absolute) or from the reference run (Δ and Δ%): one colour below, the other above, stronger the further away. The strongest tint is reached at the distance most runs fall within (the 90th percentile), so a single outlier does not wash out a column.
The palette button chooses the colour scale for this table, or reverses it. Your default for all tables is under Settings → Table; a table with its own colours offers Use default to go back to it.
Selected Runs¶
Unselected rows fade while runs are selected, and Selected on top lists the selection first (keeping the sort within each group). Hover a row for a tooltip with its values and notes.
Copying the Table¶
Click Copy table at the top right of the table to copy it to your clipboard, then paste it straight into a spreadsheet. Values are copied as displayed, so Δ and Δ% columns paste as numbers.
Scatter Plots¶

Scatter plots show each simulation as a point, positioned by two chosen channels. A third channel can colour the points.
Axes¶
Click an axis title to choose its channel from the metrics, the swept parameters (Sweep Params tab) or scalar math channels (Math tab). Swept parameters must be numeric to be plotted.
The X axis can also group by a cut of the lap — track sectors, equal distance bins or speed phases (Grouping tab). The scatter then shows one dot per run in each group, like a violin plot without its outline; see Violin Plots for how the groups and values work.
Runs without a value for the chosen channels are left out, and the plot says how many.
Colour, Groups and Plot Type¶
The toolbar at the top right holds Colour by… and a switch between dots and line — a line through the points in X order, useful when X is the swept parameter itself. Colour by… offers two ways to colour the dots (× removes either):
- Colour by a channel — a colour scale over a continuous channel, with its legend on the right
- Group by a channel — one colour per value of the channel, listed in a legend on the right. Up to six values each get their own group (a swept parameter, usually); a channel with more is split into six groups of equal run count. Runs without a value stay grey.
- Group by a cut of the lap — track sectors, equal distance bins or speed phases (Grouping tab). Each run becomes one dot per segment, coloured by segment, and Y becomes a trace channel reduced over each segment, as on the violin: the time spent in it, or the mean, min or max of a channel, absolute or as Δ to the reference run. Those controls and the cut itself (bin count, speed-phase boundaries) sit at the top left of the plot. Choosing a cut sets Y to segment time; ending the grouping sets it back to lap time.
Grouping replaces colouring, and colouring replaces grouping. A run keeps its group colour under Show only selected.
Fit Lines¶
Fit draws the least-squares line through the runs, with its R² (how much of the spread in Y the line explains) and slope in the corner. When the dots are grouped, each group gets its own line in its colour and its R² in the legend. 95% adds each line's 95% confidence band: where the line could lie, given the scatter around it. The band is narrowest at the middle of the data and widest at its ends.
Lines are fitted to the runs on the plot, so Show only selected refits them to the selection.
Where does a parameter act?
Put a swept parameter on X, group by speed phases with Y as Δ segment time, and turn on Fit. Each line's slope is how much time that phase gains or loses per unit of the parameter — a ride height that helps in high-speed corners and hurts in slow ones shows as lines of opposite sign.
Do two parameters interact?
Put one swept parameter on X and lap time on Y, group by a second swept parameter and turn on Fit. Parallel lines mean the parameters act independently; lines that fan out or cross mean the best value of one depends on the other.
Zoom, Pan and Range¶
- Drag to pan and scroll to zoom; dots grow as you zoom in
- Double-click to go back to the full view
- Click the axis numbers (not the title) to type an exact minimum and maximum; the range is saved with the layout
Violin Plots¶
A violin plot shows how a value is spread across runs: one column per group, a dot per run, and an outline showing where runs are dense. Dashed lines mark the quartiles and the solid line the median.
Grouping (X)¶
Click the X axis title to choose how runs are grouped:
| Grouping | Columns |
|---|---|
| A swept parameter or metric | One per value (numeric values with many levels are binned) |
| Track sectors | One per sector defined on the track |
| Equal distance bins | The lap cut into equal lengths |
| Speed phases | Low, mid and high speed, from the reference lap's speed |
A new violin groups by the first swept parameter, or by speed phases when nothing is swept.
Values (Y)¶
Grouped by a swept parameter or metric, Y is any metric or scalar math channel. Grouped by a cut of the lap, Y is any trace channel reduced per segment — its mean, min or max over each segment, or the time spent in it — shown absolute or as Δ to the reference run. Every run in the sweep is analysed; traces load in batches, selected runs first, and the note under the chart says what is still loading or could not be used.
Editing the Cut¶
Click the column labels to edit the cut: the speed-phase boundaries (in km/h; by default the reference lap's speed terciles) or the number of distance bins. Settings are saved with the layout.
Contour Plots¶
Where a scatter plot shows individual results as points, a contour plot shows a sweep as a continuous, colour-mapped surface — useful for reading the shape of a response and locating an optimum.
| Channel | Description |
|---|---|
| X Axis | A swept parameter |
| Y Axis | A second swept parameter |
| Z (colour) | The metric mapped to colour — lap time by default |
Reading the Map¶
- Bands and lines — the map is filled in bands between round-number levels, and each level is a line labelled with its value, so values can be read straight off the map. The legend has one step per band.
- Dots — each dot is a swept point that was run. Between the dots the map is interpolated (straight-line, so it never overshoots the runs). A point with no value is marked ✕, and the area around it is hatched rather than filled in. A dense sweep (more than 64 points) leaves the dots off; hover still picks out the point under the cursor.
- Best — for lap and sector times, the fastest point is ringed and labelled best, and the fastest region is the brightest.
- Show: metric / Δ to ref — Δ to ref shows the metric relative to the reference run. The colours then diverge from a dark middle ("same as the reference"): for times, faster regions take the gain colour and slower ones the loss colour, as in the table, and the zero line is drawn stronger.
- N runs per point: Mean / Min / Max — when more than two parameters were swept, several runs share each point on the map, and these buttons choose what each point shows: their mean, or the lowest or highest. For lap time, Min is the best lap time reachable at each point with the other parameters at their best.
Hover the map for the value under the cursor, or a dot for its run. Click a point to select its run, or Shift-drag a box to select the runs inside it (with Cmd/Ctrl to add, Alt to remove), as on the scatter and violin. Show only selected draws the map from the selected runs.
X and Y can only be swept parameters: only they lay the runs out on a grid. Z is any metric.
Contours for shape, scatter for individuals
Use a contour plot to see where a two-parameter optimum sits and how sharp it is. Switch to a scatter plot when you need to identify and select specific runs.
Layout Management¶

The Metrics page supports multiple saved layouts. Use Select in the toolbar to switch layouts and Save As to copy the current one under a new name. Layouts persist across sessions. The Tutorial button in the toolbar opens a short popover summarising what each cell does and the selection gestures.
Create Purpose-Built Layouts
Save different layouts for different tasks — for example one for sweep exploration with violins and a contour, and one with tables for detailed metric comparison.
Tips & Best Practices¶
Plots for patterns, tables for precision
Spot trends and outliers in the plots, then read exact numbers in the table. Because hover and selection are shared, the matching row lights up as you move over a plot.
Find where the time is
Group a violin by speed phases or sectors with Y as time in Δ: a setup change that gains overall but loses in low-speed corners shows up immediately.
Select, then filter
Box-select a cluster on a scatter, then use Show only selected to see just those runs in every cell.
Start simple
Begin with a table and one plot. Add cells when you have a specific question that needs a different view.
Traces
Violin plots grouped by a cut of the lap read each run's traces. For full trace analysis — speed against distance, g-g diagrams and more — use the Trace View.
Related Topics¶
- Parallel Coordinate Plots — Visualise multi-dimensional sweep results
- Parameter Sweep — Run sweeps to generate comparative metrics
- Trace View — Analyse detailed per-point simulation data
- Vehicle Compare — Compare vehicle configurations side by side
- Channel Reference — What each metric and its suffix (Max, Std, AbsMax, ...) means