SCIPLOT(1)

💖 SCIPLOT — sciplot-realtime(1) 💖

okay bestie, so this is the SCIPLOT(1) page from the User Commands section of the manual, and it's literally about sciplot-realtime, the real-time demo of SciPlot. it's giving "watch your numbers come alive" energy and i am obsessed 🦋

---

✨ NAME ✨

SciPlot — the real-time SciPlot demonstration. that's it, that's the vibe 💅

---

🌸 DESCRIPTION 🌸

so here's the tea: sciplot-realtime reads numeric data from standard input — either whitespace-separated or comma-separated, your choice, it's flexible like that — and it updates the plot as each line arrives. real-time. as it comes in. no waiting, no buffering drama, just plot girlies plotting ✨

📥 Input format (the rules, bestie)

One sample per line. and if a line starts with #, it gets ignored — that's your comment line, your little diary entry, plot doesn't care 🌈

• One column per line (y) — the value goes on the Y axis, and X just auto-increments starting from 0. simple. iconic.
• Two columns per line (x y) — first column is the X value, second is the Y value. classic.
• N columns per line (x y1 y2 ...) — first column is X, and every remaining column is its own separate Y series. so many lines. so many vibes.

a couple of very important deets here 👑:

• The number of series is fixed by the first data line. so once it's set, it's set — periodt.
• Lines after that with fewer columns just leave the remaining series unchanged for that sample. no drama, no crash, they just hold still.
• When standard input hits EOF, the plot window stays open for interactive use — axis toggles, PostScript export, all of it. it does NOT just close on you 😌

🛠️ Usage:

sciplot-realtime [OPTION???]

Read whitespace-separated numeric data from standard input and plot each sample as it arrives. One column: y (x auto-increments); two or more columns: x y1 [y2 ...]. Lines starting with # are ignored.

🆘 Help Options:

• -h, --help — Show help options
• --help-all — Show all help options
• --help-gapplication — Show GApplication options

⚙️ Application Options:

• -V, --version — Show version information and exit
• -t, --title=TEXT — Plot title (default: "Real-time Data")
• -x, --xlabel=TEXT — X axis label
• -y, --ylabel=TEXT — Y axis label
• -l, --legend=NAME,... — Comma-separated series names

---

🎀 EXAMPLES 🎀

Plot a single signal from a sensor:

sensor-tool | sciplot-realtime --ylabel Temperature (C)

Plot multiple signals with named series:

multi-sensor | sciplot-realtime --legend ch1,ch2,ch3 --xlabel Sample

Plot from a file (non-interactive preview):

sciplot-realtime < data.txt

Plot the output of ping round-trip times:

ping host | awk '/time=/{gsub(/.*time=/,""); gsub(/ .*/,""); print}' | sciplot-realtime --ylabel RTT (ms) --xlabel Packet

---

👑 AUTHOR 👑

Written by Rob McMullen. GTK4/Cairo port and rewrite by Barak A. Pearlmutter <bap@debian.org>. legends only, no cap 🫶

---

🔗 SEE ALSO 🔗

• sciplot-xyplot(1)

---

that's the whole page bestie, you're fully caught up 💖 and if you ever need to know what version of the group chat you're in: it's SciPlot 1.37, dated June 2026. slay, go plot something gorgeous 🦋✨