A measurement is a statistic of the visible window of one signal, with optional on-plot marks and a per-measurement statistics line. Martino Ferrari Measurements

A measurement is a statistic of the visible window of one signal, recomputed as that window moves. The pane lists them with their values; each can also draw its result on the plot.

How to reach it

Press the measurements button in the toolbar, or m.

The pane's + adds one; clicking a row opens the dialog where the signal, the type, the threshold share and the on-plot marks are set, with Save and Delete.

Worth knowing

The types are average, top, bottom, min, max, peak to peak, amplitude, pulse duration, period and frequency. top and bottom are the means of the upper and lower halves, which is why a unit sine reads 0.637 (2/π) rather than 1.

The on-plot marks come in two kinds and the mix is the reading: a level mark is a ruler at a value, a time mark is a marker at a position. An average draws one level mark; a max draws a level mark and a time mark at the first sample that reached it.

Marks cannot be dragged. A measurement mark says what the measurement measured, so it is created unselectable — as is the trigger marker.

A pass is throttled to a cadence rather than run every frame, so a ruler over a live view is stepped. The number and the ruler come from the same pass, so they always agree.

An invalid pass keeps its level marks and drops its time marks. A level is a property of the signal and outlives the window; a position inside the window does not. That is what stops the rulers blinking off at a mode change.

A crossing is counted with hysteresis, not on a bare level: the thresholds are a tenth of the window's peak to peak either side of the share, and an edge is counted only once the signal has passed the far one. Period, frequency and pulse duration all depend on it. The mid level is exactly where a waveform moves fastest, so any interferer faster than the fundamental recrosses a single level several times per real crossing — a 5 Hz sine with a 500 Hz tone at a tenth of the amplitude reads 39 Hz without the band and 5 Hz with it. The band holds to an interferer a third of the waveform's own size.

The band is clamped to stay inside the data, which is what keeps a threshold set near an extreme usable: a fixed band there would sit above every sample and the measurement would read nothing. A share near an extreme still leaves the band little room, so it rejects less — which is one reason period and frequency offer no share to set.

A window with too few crossings reads invalid / -- rather than a plausible invented number. Frequency over a window holding one edge is the usual case.

frequency is reported in Hz and period/pulse duration in seconds; every other type carries the channel's own unit. A value is written with a metric prefix so its digits sit in 1..999 — 636.62 mV, not 0.64 V — including when the stream declares no unit at all, which is always the case for a math channel: there the prefix goes tight against the number (636.62m), since two decimals of an unprefixed small value is 0.00.

Cost is bounded by reading the summary pyramid the producer already maintains, not the raw window. The values are still exact: a bucket's sum is a sum.

Statistics adds a second line to every measurement showing n, the mean, the standard deviation and the range. Each observation is one recompute of the pane, so n counts windows measured, not samples — a mean frequency over many windows is what that claims to be. Reset clears every accumulator and starts fresh. A change of display window, a CONFIG or a measurement edit also resets; a pause, a resume, a zoom, a pan and the toggle itself do not, so turning the line off to read the plot and back on again keeps the history.

Example

On a 1 Hz ±1 sine: average=0, top=0.636620, bottom=-0.636620, max=1, min=-1, peak to peak=2, amplitude=1, pulse duration=0.5 s (duty 0.5), period=1 s, frequency=1 Hz. Over a 2 M-sample window those two passes read about 0.1% of the samples.