QUICKPLOT(1) QUICKPLOT(1)
NAME
quickplot - quick interactive 2-D plotter with zoom and value display
SYNOPSIS
quickplot [ OPTIONS ] [ X-OPTIONS ] [ file1 [ file2 ] ... ]
DESCRIPTION
quickplot plots the named data files to any number of two dimensional
plots.
To zoom in: While moving the pointer in the plot window, press and
hold the middle mouse button and then release the button when the zoom
box is where you want it. To zoom back to the previous press the
middle mouse button and pull the zoom box from inside the plot window
to one edge of the plot window and then release the button. To zoom
back to the full press the middle mouse button and pull the zoom box
from inside the plot window to two edges (at a corner) of the plot
window, and then release the button. The left mouse button can be
pressed in the plot window to show linearly interpolated function plot
values. The right mouse button can be pressed in the plot window to
show values at any point (including non-plot values and plot values).
The default input file format is an ASCII file with any number of
fields (values) for each data point. Each field must be delimited by a
space, tab, comma or any combination and/or number of these
characters. Each data point (set of values) must be separated by a
new line character.
For example the data:
0.0 1 1e-5
0.1 2 3.1e-5
0.2 3 4.5e-5
0.3 4 7.7e-5
0.4 5 8.2e-5
has 3 fields and 5 points.
If no input file is given on the command line quickplot will read data
from standard input.
When one field of data in loaded by quickplot an additional field will
be generated that is a count, 0 1 2 3 4 ... and so on, of the one
loaded field. The default plot in this case will be a function plot
of the one loaded field VS the generated count field.
OPTIONS
-a or --no-axes
Don't show border axes in the plot window. By default quickplot
will display value labeled axes at the edges of the plot window
- 1 - Formatted: December 18, 2025
QUICKPLOT(1) QUICKPLOT(1)
if there is one plot or all the plots are on the same scale.
-b or --binary
Input data in the binary format: The binary format is one int,
that is equal to the number of fields (values) in each data
point, followed by the data as doubles one point at a time. For
example if your data file has 3 fields the data could be
represented like this: 3 x0 y0 z0 x1 y1 z1 x2 y2 z2 x3 y3 z3 x4
y4 z4 ..., if there are 5 points, that's one int followed by 15
doubles. By default the input data format is ASCII.
-f LIST or --function-plot=LIST
List of function plots. Example: quickplot -f "1 0 2 1" will
plot data field 1 VS 0 and 2 VS 1. The independent variable in a
function plot must always be increasing. If the options -f or --
function-plot and -p or --phase-plot are not used the default
plots will be function plots of all fields but field 0 against
field 0.
-h or --help
Display some help and then exit.
-l LIST or --labels=LIST
Label the fields in the fields in the value window with the
strings in LIST. Example: quickplot -l "time voltage current"
will label the first field as "time", the second field as
"voltage" and the third field as "current". That is assuming
that the label separator is a space. Use option -L to change the
label separator character from the default of space.
-n or --no-lines
Plot without lines and show just the points.
-p LIST or --phase-plot=LIST
List of phase plots. Example: quickplot -p "1 0 2 1" will plot
data field 1 VS 0 and 2 VS 1. The independent variable in a
phase plot doesn't have to be always increasing like in a
function plot.
-s or --same-scale
Plot all plots on the same scale.
-v or --verbose
- 2 - Formatted: December 18, 2025
QUICKPLOT(1) QUICKPLOT(1)
Print more information to standard error.
-B or --black-and-white
Display the plots in black and white.
-L CHAR or --label-separator=CHAR
Change the label separator to the character CHAR. See option -l.
-N or --no-pipe
Don't read data in from standard input. By default quickplot
looks for standard input, but if a datafilename is given it stops
looking for data from standard input in some short amount of
time. This option will cause quickplot to not look for data from
standard input at all. This option will over ride the -P or --
pipe option. This option was needed to keep quickplot from
choking on unintended input, which would cause quickplot to fail
to run.
-P or --pipe
Read data in from standard input. If no datafilename is given
this will be the default. This option will force quickplot to
wait for data from standard input indefinitely. By default
quickplot looks for standard input, but if a datafilename is
given it stops looking for data from standard input in some short
amount of time.
-R or --read-labels
Read in the labels from the files from first line that is not
skipped. This will only work for ASCII input files. Option -l
will override this option. If this option is given along with
option -l the labels will not be read from the files, but one
additional line will be skipped in reading the data from the
files.
-S NUM or --skip-lines=NUM
Skip the first NUM lines from all input. If the -b or --binary
option is given the first NUM data points will be skipped.
-V or --version
Print version number, compile date, who compiled this quickplot
and about and some license information to standard output. If
you want just the version number try for example:
quickplot --version | awk '/version: / {print $2}'
- 3 - Formatted: December 18, 2025
QUICKPLOT(1) QUICKPLOT(1)
-X or --no-pixmap
Don't load a piXmap of the first view of the plot. By default
quickplot loads the first zoom level display into a X pixmap, so
that it can draw it faster in all forthcoming redraws of the
first zoom level.
X-OPTIONS
quickplot can be started with the following X options:
-bg color or -background color
Set application background color to color.
-fg color or -foreground color
Set application foreground color to color.
-bd color or -bordercolor color
Set application bordercolor color to color.
-bw width or -borderwidth width
Set application borderwidth to width.
-display displayname
Set application X display to displayname.
-fn font or -font font
Set application font to font. Run xlsfonts to see a list of
available fonts.
-geometry geometry
Set application geometry. For example:
prompt% quickplot -geometry 500x400+0+0 datafile
-iconic
Initial application as an icon.
-name name
Set the application resource name to name.
-title title
Pass the title title to the window manager.
- 4 - Formatted: December 18, 2025
QUICKPLOT(1) QUICKPLOT(1)
-rv or -reverse
Reverse the video, i.e. set black to white and vice-versa. This
is the default. Lance likes it this way.
+rv Don't reverse the video.
-selectionTimeout Time
Set selection timeout time to Time in milliseconds.
-synchronous
Enable synchronous behavior.
+synchronous
Disable synchronous behavior.
-xnllanguage language
Set application national language to language.
-xrm resourceString
Set the resource resourceString.
-xtsessionID ID
Set the SM session ID to ID. I don't know what this is.
AUTHOR
Lance Arsenault, quickplot@kachinatech.com, first released: February
1998, last update of this man page: February 28, 1999.
Quickplot home page: http://www.KachinaTech.COM/~quickplot/
SEE ALSO
gnuplot(1), test_data(1)
COPYRIGHT
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; version 2 of the License.
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.
BUGS
Send bug reports to: quickplot@kachinatech.com
- 5 - Formatted: December 18, 2025
QUICKPLOT(1) QUICKPLOT(1)
- 6 - Formatted: December 18, 2025
