GBPLOT(1)

📦
version 6.3 · 2 versions
  • 6.3 · debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 6.0 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 NAME 🌸

gbplot — the gnuplot command line interface. yes bestie, it's section 1, User Commands, and she's serving command-line plotting realness 💅

✨ SYNOPSIS ✨

gbplot [options] [command] [specstring] < datafile

🦋 DESCRIPTION 🦋

okay so the whole vibe here is: this command produces simple plots from the command line using the gnuplot program. command is one of the gnuplot commands — either plot or splot — and specstring is a list of gnuplot specifications. to escape shell interpretation, put specstring between double quotes. no cap, that part matters.

you can also specify the type of terminal and the output file name as command line options. and you can start an interactive session too, which is genuinely useful when you wanna adjust plot parameters by hand. it's giving ✨control✨.

the program can be used in a shell pipe, like this:

cat datafile | gbplot [options] [command] [specstring]

💅 OPTIONS 💅

  • -h — print this help
  • -i — start interactive session after the plot
  • -T — set a different terminal
  • -o — set an output file (yes it's spelled ouptut in the source, we don't talk about it 😭)
  • -t — assign a title to the plot
  • -p — prepend expression to plot command
  • -l — set log; possible values are x, y and xy
  • -C — command to be run before the plot
  • -v — verbose output: print commands to standard error
  • --help — same as -h
  • --version — print the program version

🍓 EXAMPLES 🍓

two plots: one using line and one using points. iconic.

echo "1\n2\n3" | gbplot plot "u 0:1 w l title 'line', '' u 0:1 w p title 'point'"

save the plot in PDF format in a file named test.pdf

echo "1\n2\n3" | gbplot -T pdf -o test.pdf plot "u 0:1 w l title 'line'"

set log on the y axis

echo "1\n2\n3" | gbplot -l y plot "u 0:1 w l title 'line', '' u 0:1 w p title 'point'"

set log on the x axis and a grid

echo "1\n2\n3" | gbplot -l x -C "set grid" plot "u 0:1 w l title 'line', '' u 0:1 w p title 'point'"

set a grid and the position of the legend

echo "1\n2\n3" | gbplot -C "set grid" -C "set key bottom right" plot "u 0:1 w l title 'line', '' u 0:1 w p title 'point'"

compute the value of the gamma function on a set of points; gawk is used to filer the relevant numbers

echo "1\n2\n3" | gbplot -C "set table" plot 'u (gamma($1))' | gawk '/ i/{print $2}'

👑 AUTHOR 👑

Written by Giulio Bottazzi

🐛 REPORTING BUGS 🐛

Report bugs to <gbutils@googlegroups.com>

Package home page <http://cafim.sssup.it/~giulio/software/gbutils/index.html>

Copyright © 2009-2014 Giulio Bottazzi

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License (version 2) as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

bestie this is the legal bit so pls actually read it: no warranty, fr fr. if it breaks, it breaks 🙈

and that's the whole page, periodt. this was gbplot ver. 5.6, dated March 2019, and it lives in section 1 of the manual 💖 thanks for coming to my ted talk, go make some plots, you got this 🫶✨

📦 where this page comes from