Martino FerrariandClaude Opus 4.6
87f61ea364
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
80 lines
4.0 KiB
Plaintext
80 lines
4.0 KiB
Plaintext
<page xmlns="http://projectmallard.org/1.0/"
|
|
type="topic" style="task"
|
|
id="signals">
|
|
|
|
<info>
|
|
<link type="guide" xref="index#main"/>
|
|
<link type="seealso" xref="layout"/>
|
|
<desc>How the source's CONFIG becomes channels, what enabling a signal starts, and how a
|
|
signal's scale and offset are calibrated.</desc>
|
|
<credit type="author copyright">
|
|
<name>Martino Ferrari</name>
|
|
</credit>
|
|
</info>
|
|
|
|
<title>Signals and calibration</title>
|
|
|
|
<p>The source's CONFIG message describes its signals: a name, a unit and a type. udpscope
|
|
turns each enabled signal into a <em>channel</em> — a ring of values beside the shared time
|
|
ring — and a channel is what a trace plots. Calibration is a scale and an offset applied at
|
|
ingest.</p>
|
|
|
|
<section id="reach">
|
|
<title>How to reach it</title>
|
|
<steps>
|
|
<item>
|
|
<p>Click the <gui>+</gui> badge in the badge bar, or press <key>g</key>. The
|
|
<gui>Signals</gui> page lists what can be added — the signals the source declares that
|
|
are not acquired yet, each with a tick that acquires it. Past six acquired signals the
|
|
badges fold into one <gui>N signals</gui> badge, and the page then lists every signal.</p>
|
|
</item>
|
|
<item>
|
|
<p>Once a signal is acquired its badge appears. Click it to open that signal's page: its
|
|
details directly under its name — <gui>Unit</gui>, <gui>Gain</gui> and <gui>Offset</gui>,
|
|
each with a pencil button that edits that one value, then the type, size, range, sample
|
|
rate and timing the stream declared — its colour and <gui>Plot on</gui> buttons for the
|
|
rows.</p>
|
|
</item>
|
|
</steps>
|
|
</section>
|
|
|
|
<section id="knowing">
|
|
<title>Worth knowing</title>
|
|
<list>
|
|
<item><p>Signals start disabled, and enabling one is what starts acquiring it. A trigger
|
|
on a signal nobody acquires can never fire, so arming a trigger enables its signal for
|
|
you.</p></item>
|
|
<item><p>A signal's page shows the gain and offset it is <em>currently</em> drawn
|
|
through, so a trace already scaled by a gain of 2 reads 2. The pencil beside a number opens
|
|
an editor for that number only, at its current value —
|
|
pressing <gui>Apply</gui> confirms it rather than resetting it. A signal nobody
|
|
calibrated shows the identity, 1 and 0. The unit can be renamed the same way (an empty
|
|
entry restores the one the stream declares); the new name is used in the readouts, the
|
|
measurements and the export, and is remembered with the session.</p></item>
|
|
<item><p>Calibration is applied <em>at ingest</em>, so changing it re-plans the buffer
|
|
and drops the history. So does enabling or disabling a signal, and so does a new
|
|
CONFIG. An empty plot for a second after one of those is the ring refilling, not a
|
|
fault.</p></item>
|
|
<item><p>The stream's first signal is usually its <em>timestamp</em>, and that one is
|
|
never acquired. It cannot be plotted, measured or used as a math source, and udpscope
|
|
refuses to put it in a row rather than binding a trace that would read nothing for
|
|
ever.</p></item>
|
|
<item><p>A signal's colour follows the <em>signal</em>, not the slot, so the same signal
|
|
on two rows is one colour, and the dot on its badge shows it. A signal on no row gets a
|
|
grey dot rather than none.</p></item>
|
|
<item><p><em>Change a signal's colour</em> with <gui>Change colour</gui> on its page; a
|
|
signal on no row has no trace to colour, so the button is dimmed. The colour is saved
|
|
with the session; <gui>Default colour</gui> on the same page gives the palette entry
|
|
back.</p></item>
|
|
</list>
|
|
</section>
|
|
|
|
<section id="example">
|
|
<title>Example</title>
|
|
<p>A source declaring <code>time</code>, <code>sine</code>, <code>ramp</code> and
|
|
<code>noise</code> yields three plottable signals. Enable all three and the exit dump
|
|
reads <code>3 signals, 3 channels</code>; <code>time</code> is not among them.</p>
|
|
</section>
|
|
|
|
</page>
|