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
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 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.
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.