GUFF(1)

💅 GUFF(1) — the plot device that ate 💅

okay bestie, so you know GUFF? it's a whole manual page, and the manual name is guff, and honestly it's giving "tiny tool, huge main character energy". it's literally described as a plot device and i'm obsessed 🎀

---

✨ NAME ✨

guff — a plot device 🦋

---

🌸 SYNOPSIS 🌸

guff [-A] [-c] [-d WxH] [-f] [-h] [-l xyc] [-m MODE] [-r] [-s] [-S] [-x]
[FILE]

---

💖 DESCRIPTION 💖

so here's the tea: guff reads a stream of points from a file or from stdin and plots them. that's it. that's the whole vibe. it reads points, it plots them, slay ✨

---

🎀 OPTIONS 🎀

🌈 Common options:

• -d WxH — sets the dimensions, aka width and height. it should be formatted like "-d WxH", e.g. "-d 72x40" or "-d 640x480". literally just width, an x, height, periodt 💅
• -f — flips the X and Y axes in the plot. chaotic? maybe. iconic? absolutely 🔥
• -h — prints a help message. bestie needs help sometimes 🫶
• -l xyc — sets X, Y, and/or Count to log-scale. that's log-scale for any of those three, your call ✨
• -m MODE — sets the mode to dot (that's the default), line (SVG only, no cap), or count (which tracks how densely clustered the points are). three modes, three vibes 👑
• -x — treats the first column as the X value for the other columns. otherwise, the row number is used for the X value. iykyk 📊

🦋 SVG-only options:

• -c — uses colorblind-safe default colors. inclusive king behavior fr fr 💜
• -r — draws a linear regression line for each column. math girlies rise 🌸

🙈 Rare options:

• -A — don't draw axes. minimalism, but make it plot 🎀
• -S — disables stream mode, meaning it exits at the first blank line. bye-bye at the first empty line 👋

---

⭐ EXIT STATUS ⭐

returns 0. that's it. clean exit, no drama 💅

---

🔥 EXAMPLES 🔥

read a series of number rows on stdin, and plot to ASCII once end-of-stream or a blank line is reached:

$ guff

same, but generate SVG:

$ guff -s

read number rows from a file:

$ guff file

plot stdin with a log-scale on the Y axis:

$ guff -ly

treat the first value on each line as the X value for all columns:

$ guff -x

plot stdin to SVG, with lines connecting the points:

$ guff -s -m line

same, but using a colorblind-safe palette:

$ guff -s -c -m line

plot stdin to SVG, and draw a linear regression line for each column:

$ guff -s -r

plot stdin with point counts, to show point density:

$ guff -m count

same, with a log scale for the point counts:

$ guff -m count -lc

same, with SVG output:

$ guff -s -m count -lc

---

💀 BUGS 💀

there isn't a way to change the plot options when a blank line resets the data. annoying? yes. real? also yes 😭

and rather than attempt to intelligently handle strange input, guff just skips the rest of the line when strtod(3) indicates there isn't a well-formatted number. it's not being mean, it's just not doing the work for you 🙈

---

👑 COPYRIGHT 👑

guff is Copyright (C) 2015 Scott Vokes vokes.s@gmail.com. respect the original icon 💖

---

🌟 SEE ALSO 🌟

• awk(1) — go check out awk, bestie, it's a whole vibe too 🐚

---

okay that's the whole page, and yes i'm still obsessed — this little beauty is from July 2015, and it's GUFF(1) all the way down. mwah 💋 🎀