Math Channels¶

Math channels are calculated channels you define with an equation. They let you derive new signals from existing data channels — and from other math channels — directly in Trace View, without exporting to a spreadsheet first.

Overview¶

A math channel is defined by an expression that references other channels using the channel(x) syntax, where x is the current X-axis value. For example:

vCar(x) * 3.6

converts car speed from m/s to km/h at every point along the lap.

Math channels can reference both raw data channels and other math channels, so you can build layered calculations such as normalised signals, balance metrics, or team-specific analysis channels.

Math channels that are visible in Trace View are included when results are exported from the File Viewer, and bundle permissions can include them so shared result packages carry the calculated channels your team expects.

Math channels are available across every chart type in Trace View — trace lines, scatter, distribution, correlation, and the track heat map. Select a math channel from the metrics axis selector wherever you choose a channel for an axis or colour scale.

Referencing Vehicle Parameters¶

In addition to data channels, expressions can reference vehicle setup parameters as scalar values using a dotted path, for example:

aero.front_wing.cl_multiplier
chassis.wheelbase.value

These values come from the vehicle attached to each result, so the same equation evaluates correctly across results run on different vehicles. The equation editor suggests parameters from the currently loaded vehicle as you type.

Per-result resolution

If a path is not found on the currently loaded vehicle, a warning appears, but the channel is still saved and evaluates against each result's own vehicle at run time. This lets you keep one library of analysis channels that work across your fleet.

Operators and Signs¶

Any binary operator may be followed directly by a signed number, so expressions like the following are valid:

vCar(x) * -1
gLat(x) / -9.81
nEngine(x) ^ -2

Chained signs are also resolved correctly (x * --1 becomes x, and x * ---1 becomes -x). Malformed sequences such as vCar(x) */ are still rejected by the editor.

Channel Units¶

Each math channel can declare its own unit, chosen from the searchable unit list in the equation editor. The declared unit appears on axis labels and tooltips wherever the channel is shown, just like a built-in channel.

You can also pin the input unit for each dependency channel. For example, if your expression expects vCar in km/h rather than m/s, pin vCar → km/h and the conversion is applied automatically before your expression runs.

Aggregate Functions¶

In addition to standard arithmetic and elementary functions, three aggregate functions are available for working across the whole trace.

Function	Arguments	Result
`integral(channel(x))`	1	Running cumulative integral (trapezoidal) at every point
`integral(channel(x), lower, upper)`	3	A single definite integral value over the range from `lower` to `upper`
`sum(channel(x))`	1	Running cumulative sum at every point
`sum(channel(x), lower, upper)`	3	A single summed value over the range from `lower` to `upper`
`derivative(channel(x))`	1	Numerical derivative (rate of change) at every point

Examples:

integral(vCar(x))               # cumulative distance from speed
integral(vCar(x), 100, 500)     # distance covered between 100 m and 500 m
sum(gLat(x))                    # running cumulative lateral g
derivative(vCar(x))             # longitudinal acceleration from speed

Bounds apply to the X axis

The second and third arguments on integral and sum are the lower and upper bounds along the current X axis (for example distance or time). With bounds supplied, the function returns a single value instead of a per-point trace. derivative accepts only a single argument.

Display Units¶

Aggregate functions operate on data already converted to your chosen display units. If a referenced channel (for example hRollCentreR) is set to display in mm, the function receives values in mm, so the result comes out in the units you expect — no manual rescaling required.

Formatting¶

The equation editor includes a Format button that tidies your expression:

Short equations stay on a single line with consistent spacing around operators.
Long equations wrap only at meaningful parenthesised terms, and only when a line would exceed the readable limit.
Scientific notation such as 1e+3 is preserved rather than being split.

Trace View — Where math channels are created, edited, and displayed
Metrics — Summary values derived from result channels