.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.6.
.TH GBPLOT "1" "March 2019" "gbplot ver. 5.6" "User Commands"
.SH NAME
gbplot \- gnuplot command line interface
.SH SYNOPSIS
.B gbplot
[\fI\,options\/\fR] [\fI\,command\/\fR] [\fI\,specstring\/\fR] \fI\,< datafile\/\fR
.SH DESCRIPTION
This command produce simple plots from the command line using the
\&'gnuplot' program. 'comand' is one of the gnuplot commands: 'plot' or
\&'splot' while 'specstring' is a list of gnuplot specifications. In
order to escape shell interpretation place 'specstring' between double
quotes. It is possible to specify the type of terminal and output file
name as command line options. It is also possible to start an
interactive session, useful to adjust plot parameters by hand. The
program can be used in a shell pipe, as in
.PP
cat datafile | gbplot [options] [command] [specstring]
.SH OPTIONS
.HP
\fB\-h\fR print this help
.HP
\fB\-i\fR start interactive session after the plot
.HP
\fB\-T\fR set a different terminal
.HP
\fB\-o\fR set an ouptut file
.HP
\fB\-t\fR assign a title to the plot
.HP
\fB\-p\fR prepend expression to plot command
.HP
\fB\-l\fR set log; possible values x,y and xy
.HP
\fB\-C\fR command to be run before the plot
.HP
\fB\-v\fR verbose output: print commands to standard error
.TP
\fB\-\-help\fR
same as '\-h'
.HP
\fB\-\-version\fR print the program version
.SH EXAMPLES
Two plots: one using line and one using points.
.IP
echo "1\en2\en3" | gbplot plot "u 0:1 w l title 'line', '' u 0:1 w p title 'point'"
.PP
Save the plot in PDF format in a file named 'test.pdf'
.IP
echo "1\en2\en3" | gbplot \-T pdf \-o test.pdf plot "u 0:1 w l title 'line'"
.PP
Set log on the y axis
.IP
echo "1\en2\en3" | gbplot \-l y plot "u 0:1 w l title 'line', '' u 0:1 w p title 'point'"
.PP
Set log on the x axis and a grid
.IP
echo "1\en2\en3" | gbplot \-l x \-C "set grid" plot "u 0:1 w l title 'line', '' u 0:1 w p title 'point'"
.PP
Set a grid and the position of the legend
.IP
echo "1\en2\en3" | gbplot \-C "set grid" \-C "set key bottom right" plot "u 0:1 w l title 'line', '' u 0:1 w p title 'point'"
.PP
Compute the value of the gamma function on a set of points; gawk is used to filer the relevant numbers
.IP
echo "1\en2\en3" | gbplot \-C "set table" plot 'u (gamma($1))' | gawk '/ i/{print $2}'
.SH AUTHOR
Written by Giulio Bottazzi
.SH "REPORTING BUGS"
Report bugs to <gbutils@googlegroups.com>
.br
Package home page <http://cafim.sssup.it/~giulio/software/gbutils/index.html>
.SH COPYRIGHT
Copyright \(co 2009\-2014 Giulio Bottazzi
.PP
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.
.PP
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.