Tinca/Docs/Widgets/Time Series

Time Series

PRO
DISPLAY · 14 FIELDS · 4×2 DEFAULT

Plot values over time or field vs field (XY)

When to reach for it

Time Series plots more than one signal at once: up to four topics on a shared time axis, or an XY scatter of one field against another. For a single compact trend, Sparkline (Pro) is lighter. For one value with no history, Value Display is the free option: color-coded warning thresholds on it are a Pro feature.

Worked example: two motor temperatures

Plot Mode set to Time Series, Time Window (s) at 120. Data Series holds two entries, /motors/left/temperature and /motors/right/temperature, both at the default 100 ms sample interval. Y Axis set to Auto (all series)so neither motor's trace clips off the top of the plot.

Watch out for
  • XY mode adds a point whenever the Y topic ticks, paired with whichever X value is cached at that moment; an X update alone never adds a point. A sparse trace means the Y topic is slow, a stair-stepped one means the X topic is.
  • Show Current Value only drives the single-series overlay number or the XY coordinate readout. With two or more Data Seriesthe legend already lists each series' latest reading, so the toggle has no effect there.
  • Data Series caps at four entries: the config screen shows a live count and hides Add Series once you hit the limit, so there is no way to add a fifth.

Configuration fields

Plot ModePROselect

Plot values against time, or one field against another (XY scatter).

Time SeriesXY Plot
Time Window (s)number

How many seconds of history the time plot shows.

X Axis TopicPROtopic

Topic feeding the horizontal axis in XY mode.

X Axis FieldPROfield-path

Field on the X Axis Topic to use for the horizontal position.

X Axis LabelPROstring

Caption shown under the X axis in XY mode.

Data Seriesseries-list

The topics and fields to plot. Each series has its own color.

Y Axisselect

How the vertical scale is chosen: fit all series, fit only the first series, or a fixed range.

Auto (all series)Auto (first series)Fixed range
Min Ynumber

Bottom of the vertical scale when Y Axis is Fixed range.

Max Ynumber

Top of the vertical scale when Y Axis is Fixed range.

Sample Interval (ms)slider

How often a point is recorded. Lower captures faster changes but uses more memory.

10 to 1000, step 10
Max PointsPROnumber

Most recent points kept in the XY scatter before old ones drop off.

Fade TrailPROboolean

Fade older points so the direction of travel is visible.

Show Grid Linesboolean

Draw faint gridlines behind the plot.

Show Current Valueboolean

Overlay the latest value of each series as a number.