.TH "quickplot" "1" 
.SH "NAME" 
quickplot \(em fast interactive 2D plotter and data viewer 
.SH "SYNOPSIS" 
.PP 
\fBquickplot\fR [\fBOPTIONS\fP]  [\fBfile1\fP]  [\fBOPTIONS\fP]  [\fBfile2\fP]  
.SH "DESCRIPTION" 
.PP 
\fBquickplot\fR is more like an interactive 
data browser than an interactive picture editor. The difference 
between this 2D plotter and most 2D plotters is that the primary 
purpose of Quickplot is to help you quickly interact with your 
data.  Of secondary importance is to make a pretty static 
picture of your data.  Features that distinguish Quickplot 
include: one click zooming, any number of plots with different 
scales displayed at one time, value picking for any number of 
plots with different scales displayed at one time, and reading 
data from standard input.  These features become indispensable 
when you're looking at data sets with 10,000 to 1,000,000 and 
more data points.  You can't look at a 2D plot with 100,000 
points unless you can quickly zoom.  If you need to look at 
hundreds of files each with 100,000 points, the command line 
options in Quickplot may save your sanity. 
.PP 
This manual page was written for the \fBDebian\fP distribution 
because the original program does not have a manual 
page. Instead, it comes with documentation in html format that 
can obtained by running the program and pulling down the Help Menu. 
The html files can be found at /usr/share/doc/quickplot/html/ 
.SH "OPTIONS" 
.PP 
These programs follow the usual GNU command line syntax, 
with long options starting with two dashes (`\-').  A summary of 
options is included below.   
.IP "\fB-a\fP           \fB\-\-about\fP         " 10 
Display some information about Quickplot 
.IP "\fB-c RGB\fP           \fB\-\-canvas-color RGB\fP         " 10 
start quickplot with the graph background (canvas) color RGB. Examples: \-\-canvas-color #FF0000 or \-\-canvas-color "red" would make it red 
.IP "\fB-d\fP           \fB\-\-different-scales\fP         " 10 
load plots on the same graph with different 
scales. By default Quickplot will load plots on the same 
graph with the same scale if the span of x,y values in all 
the plots are within an order of magnitude of each other  
.IP "\fB-geometry GEOMETRY\fP           \fB\-\-geometry GEOMETRY\fP         " 10 
create the initial window with the given geometry 
GEOMETRY, see man page X(1) for the GEOMETRY 
format. Example: quickplot \-\-geometry=1000x300-0+30  
.IP "\fB-C RGB\fP           \fB\-\-grid-color RGB\fP         " 10 
RGB may be in one of these formats:  
 
.RS 
.IP "   \(bu" 6 
#RGB (each of R, G and B is a single hex digit)  
.IP "   \(bu" 6 
#RRGGBB  
.IP "   \(bu" 6 
#RRRGGGBBB  
.IP "   \(bu" 6 
#RRRRGGGGBBBB  
.IP "   \(bu" 6 
A name from the X color database, which may be 
in /usr/X11R6/lib/X11/rgb.txt. Example colors are 
"steelblue" and "gainsboro".  
.RE 
 
.IP "\fB-g SIZE\fP           \fB\-\-grid-line-width SIZE\fP         " 10 
start quickplot using plot grid width SIZE in 
pixels 
.IP "\fB-h\fP           \fB\-\-help\fP         " 10 
Show summary of options. 
.IP "\fB-b CHAR\fP 	  \fB\-\-label-separator CHAR\fP 	" 10 
when reading labels from the last file in the argument 
list before this option flag use CHAR as the label (single 
character) separator. The default label separator is ' ' 
(space). If this file is not an ASCII text file this will be 
ignored. See option: \-\-labels or \-L. 
.IP "\fB-L\fP 	  \fB\-\-labels\fP 	  " 10 
read labels from the first line not skipped of the 
last file in the augment list before this option flag. If 
this file is not an ASCII text file this will be 
ignored. 
.IP "\fB-I SIZE\fP 	  \fB\-\-line-width SIZE\fP 	  " 10 
start quickplot using plot line width SIZE in 
pixels 
.IP "\fB-l [L_OPTIONS]\fP 	  \fB\-\-linear-field [L_OPTIONS]\fP 	" 10 
make a field that is a uniformly changing linear 
sequence of values, like for example time.  The number of values will 
be gotten from the previous file's values loaded.  The field generated 
will be added as the first field of the previous file. For sound files 
this option is ignored.   
.IP "" 10 
\fBL_OPTIONS\fR 
.IP "" 10 
The L_OPTIONS only have an effect after the \-\-linear-field (or \-l) option and they act on the field made from that argument.  The L_OPTIONS are: 
.RS 
.IP "   \(bu" 6 
\-\-start VALUE or \-r VALUE   set the first value in 
the sequence to VALUE.  The default first value will 
be zero. 
.IP "   \(bu" 6 
\-\-step SIZE or \-t SIZE   set the sequence step 
size to SIZE.  The default is 1.  
.RE 
.IP "\fB-B\fP 	  \fB\-\-no-buttons\fP 	  " 10 
start quickplot with no button bar 
.IP "\fB\-\-no-default-plots\fP 	  " 10 
by default when no \-\-plot or \-p options are given 
Quickplot will make some plots with the files loaded at 
start up. This option will cause Quickplot not to make these 
default plots.  When files are loaded using the GUI defaults 
plot will not be made if this is set. 
.IP "\fB-G\fP 	  \fB\-\-no-grid\fP 	  " 10 
start quickplot with out drawing graph grid lines, 
by default, in the graphs 
.IP "\fB\-\-no-gui\fP 	  " 10 
start quickplot with out showing any of the standard 
GUI's (graphical user interfaces). This is the same as uses 
the options \-\-no-buttons \-\-no-menubar \-\-no-statusbar and 
\-\-no-tabs. 
.IP "\fB-i\fP 	  \fB\-\-no-lines\fP 	  " 10 
start quickplot to plot without drawing lines in the 
graphs by default 
.IP "\fB-M\fP 	  \fB\-\-no-menubar\fP 	" 10 
start quickplot with no menubar 
.IP "\fB-N\fP 	  \fB\-\-no-pipe\fP 	" 10 
don't read data in from standard input 
.IP "\fB-o\fP 	  \fB\-\-no-points\fP 	" 10 
start quickplot to plot without drawing points in the 
graphs by default 
.IP "\fB\-\-no-statusbar\fP 	  " 10 
start Quickplot with no status bar displayed. The 
Quickplot status bar is a thin widget at the bottom of the main 
Quickplot window which displays pointer x, y graph values and mode 
information. 
.IP "\fB\-\-no-tabs\fP 	  " 10 
start Quickplot with no graph tabs displayed. Quickplot uses a notebook like widget to let you select and 
view multiple graphs. 
.IP "\fB-n NUM\fP 	  \fB\-\-number-of-plots NUM\fP 	" 10 
set the possible initial number of plots to NUM.  The 
default possible initial number of plots is 12. 
.IP "\fB-P\fP 	  \fB\-\-pipe\fP 	  " 10 
read in data from standard input.  By default 
Quickplot looks for data from standard input and stops looking if no 
data is found in some short amount of time.  This option will cause 
Quickplot to wait for standard input indefinitely. 
.IP "\fB-p LIST\fP 	  \fB\-\-plot LIST\fP 	" 10 
plot the following list of fields, LIST, at startup. 
example: \-\-plot "0 1 3 4" will plot field 1 VS field 0 and 
field 4 VS field 3.  DataFields are numbered, starting at 
0, in the order that they are read in from a file or 
created, as in the case of option \-\-linear-field.  A 
separate Graph Tab will be created for each \-\-plot (or \-p) 
option given. 
.IP "\fB-O SIZE\fP \fB\-\-point-size 
SIZE\fP" 10 
start quickplot using plot point size SIZE in pixels 
.IP "\fB\-\-print-about\fP" 10 
prints the About HTML document to standard output and then exits 
.IP "\fB\-\-print-help\fP" 10 
prints the Help HTML document to standard output and then exits 
.IP "\fB-s\fP 	  \fB\-\-same-scale\fP" 10 
plot all start-up plots on the same scale 
.IP "\fB\-\-silent\fP 	" 10 
don't spew even on error. The \-\-silent option will 
override the effect of the \-\-verbose option. 
.IP "\fB-S NUM\fP 	  \fB\-\-skip-lines NUM\fP 	  " 10 
skip the first NUM lines in the previous file 
read. The previous file in the argument list should be an 
ASCII text file. 
.IP "\fB-v\fP           \fB\-\-verbose\fP         " 10 
spew more to standard output 
.IP "\fB-V\fP           \fB\-\-version\fP         " 10 
Show version of program. 
.IP "\fB\-\-with-libsndfile\fP 	" 10 
if quickplot is linked with the libsndfile \-\-library, 
print the version of the libsndfile library that quickplot is 
linked with, and exit returning status 0 if quickplot is linked 
with the libsndfile library and 1 if quickplot is not linked with 
the libsndfile library 
.SH "KEYBINDINGS" 
.PP 
Quickplot has GUIs for all of the following immutable keyboard short-cuts: 
.PP 
 
.IP "   \(bu" 6 
\fBa\fR   show information about Quickplot 
using a web browser 
.IP "   \(bu" 6 
\fBb\fR   toggles the visibility of the button bar 
.IP "   \(bu" 6 
\fBc\fR   copies the current focused main window frame 
.IP "   \(bu" 6 
\fBd\fR   delete the main window. This will not close the last main window. 
.IP "   \(bu" 6 
\fBf\fR   makes a new main window frame 
.IP "   \(bu" 6 
\fBg\fR   show/hide the graph configuration widget 
.IP "   \(bu" 6 
\fBh\fR   show help using a web 
browser 
.IP "   \(bu" 6 
\fBi\fR   save a PNG image of the graph 
.IP "   \(bu" 6 
\fBm\fR   show/hide the menu bar 
.IP "   \(bu" 6 
\fBn\fR   make a new graph 
.IP "   \(bu" 6 
\fBo\fR   open a data file 
.IP "   \(bu" 6 
\fBp\fR   show/hide the plot lister widget 
.IP "   \(bu" 6 
\fBq\fR   quit 
.IP "   \(bu" 6 
\fBs\fR   toggles the visibility of the 
status bar 
.IP "   \(bu" 6 
\fBt\fR   toggles the visibility of the 
graph tabs 
.IP "   \(bu" 6 
\fBesc\fR   close the current focused window. This will not close the last main window.      
.SH "AUTHOR" 
.PP 
\fBQuickplot\fR is written by Lance 
Arsenault.  
.PP 
This manual page was written by Gopal Narayanan (gopal@debian.org) for 
the \fBDebian\fP system (but may be used by others).  Permission is 
granted to copy, distribute and/or modify this document under 
the terms of the GNU General Public License, Version 2 any  
later version published by the Free Software Foundation. 
 
.PP 
On Debian systems, the complete text of the GNU General Public 
License can be found in /usr/share/common-licenses/GPL. 
 
.\" created by instant / docbook-to-man, Tue 21 Feb 2012, 16:47