Provided by: xplot_1.19-9.1build1_amd64 
NAME
xplot - simple x-y column data plotter for X
SYNOPSIS
xplot [-v] [-title 'titlestring'] [-format 'formatstring'] [-y 'yrange'] [-display
host:dpy] [-name appname] [-visual class] [-depth d] [-private] [-shared] [-stdcmap]
[-debug l] [-sync] datafiles ...
DESCRIPTION
This manual page documents briefly the xplot command. This manual page was written for
the Debian GNU/Linux distribution using the program's intergrated help file because the
original program does not have a manual page.
xplot is a small program to plot one- or twodimensional datasets, which are present either
in a file or are generated `on-the-fly' and piped to XPlot. XPlot lets you display one or
more datasets and lets you zoom to different sections of the sets. Also. `blowups' of the
currently shown portion of the data can be made.
xplot is meant for on-screen data exploration. It does not have a print button, nor is it
meant for final output and publication-quality figures.
xplot is non longer actively maintained upstream. If you would like to take it over, talk
to the author: Karel Kubat <karel@icce.rug.nl>.
OPTIONS
A summary of options are included below.
-v increases verbosity. XPlot prints information about what files are read and of how
many points they consist when this flag is present.
-title 'titlestring'
defines the title for the plot (can also be set interactively).
-format 'formatstring'
The formatstring FORMAT is used to read in data. If you're familiar with C, then
you know what a formatstring is. The default formatstring is "%f %f ", meaning that
XPlot should try to interpret each line as two numbers (%f, for `floating point
value'), separated by one or more whitespace characters. The -format flag can be
handy if, e.g., you want to read in a file like
time 12.0 value 3
time 12.1 value 4
time 12.2 value 5
You'd then have a format string
"time %f value %f "
Don't forget the trailing blank in the formatstring, it makes sure that the end-of-
line character is skipped.
-y yrange'
This flag allows you to specify the range of the Y axis at startup. Normally XPlot
determines the range from the read data. The YRANGE specifier must be in the form
NUMBER:NUMBER (e.g., 0:13), where the first number specifies the lowest value of
the Y axis, and the second number specifies the highest value.
XFORMS OPTIONS
XPlot is built with the XForms Graphical User Interface Toolkit for X, and hence supports
a number of flags which are interpreted by XForms. The flags must be stated before any
file arguments, and are:
-display host:dpy
defines the X display.
-name appname
defines the application name.
-visual class
TrueColor, PseudoColor etc...
-depth d
visual depth in bits
-private
forces a private colormap.
-shared
forces a shared colormap.
-stdcmap
forces a standard colormap.
-debug l
prints debugging information, l is the level.
-sync forces synchronous mode.
USING XPLOT
The XPlot window
The main XPlot window is called the `Control window'. It lets you select boundaries for
the plot, activate or deactivate cetain datasets, etc.. See further the subsections.
Boundaries of the plot
The main XPlot window (called Control) shows the datasets in a small plot, surrounded by
sliders. Two sliders are provided per axis, one selecting the minimum value and one
selecting the maximum value. E.g., if you want to see the middle portion of the plot, set
the upper horizontal slider (the minimum X value to display) to about 1/3 of its length
and set the lower horizontal slider to 2/3 of its length.
The boundaries of the plot can furthermore be entered in the input fields, below the small
plot.
One last button, labeled `Scale Y', affects the sizing of the graph. The button scales the
Y axis to contain all points given a certain X range. The scaling of the Y axis is
performed over all active datasets (you can also deactivate sets, see the appropriate
section).
Selecting and deselecting datasets
When many datasets are plotted, it may be useful to deactivate (or later, reactivate) some
of the sets. The button which is labeled `(De)activate sets', on the right hand side of
the control window, starts a small window (called the `activator'), showing an overview of
the plotted sets. The names of the active sets are prefixed with [+], the inactive sets
are prefixed with [-]. Clicking on the line with a name of a dataset `toggles' the
activity: an active set becomes inactive and v.v..
Initially, all datasets are `active' (i.e., displayed).
The activator stays on-screen until you click the `dismiss' button of the activator
window.
Making larger plots: blowups
The buttons `static blowup' and `dynamic blowup' in the control window start a `blowup' of
the current plot: i.e. using the current borders and currently active sets. The blown up
graph is dismissed by clicking in the blowup window. The blown up graph can be resized,
e.g., to grab its contents in a paint program.
The difference between a static and a dynamic blowup is the following. A static blowup
will remain to show the the plotted data even when you, e.g., deactivate a set or change
the boundaries. A static blowup is handy when e.g. you want to compare one part of the
data with another part: make a static plot of the first part, move to the second part, and
compare. In contrast, a dynamic plot redraws its data whenever necessary; therefore, it is
an `enlargement' of the plot in the control window.
XPlot can create an unlimited number of blowups: that way, you can simultaneously view
different sets with different boundaries in different blowups..
Line types of the plots
The radio buttons labelled `Line types', on the right hand side of the control window,
select the line types for the plotting of the datasets. All sets are plotted in the same
style.
The default style, `solid or circles', plots a set either with a solid line, or with a
solid line and circles on the separate points. The points are plotted when the graph
contains less than 20 points: the idea here is that the presence of circles obfuscates a
graph when more than 20 circles would be present in the graph.
Other styles force either solid lines, solid lines with circles, or solid lines with
squares.
Postponed or immediate plotting
The button labeled `Auto-redraw', on the right hand side of the Control window, selects
whether XPlot should redo a plot when any change occurs (e.g., when the boundaries are
altered or when a linestyle is defined). Initially, auto-redraw is `on'.
Setting auto-redraw to `off' is a good idea when you are plotting large datasets. The
reason for this is that the replotting of all sets (e.g., when sliding one of the boundary
sliders) may take too long. In this case, you can disable the automatic redrawing, and
`manually' redraw the plot when you are satisfied with all necessary changes. The `manual
redraw' is always done when you press the button labeled `Redraw now'.
Plot titles
The input field labeled `Title', below the small plot on the Control window, lets you
enter a title for the plot. XPlot's title facility is restricted to one title, which als
used in blowups. You might want to define a title, make a blowup, and dump it to say a
printer using `xwd' and related programs.
Quitting XPlot
The button labelled `dismiss' on the XPlot control window removes the control window from
the screen. The XPlot program will only terminate when no blowups are on-screen. To quit
XPlot, you need to remove all blowups (by clicking on them) and to click the `dismiss'
button of the control window.
SEE ALSO
This text is also available on-line help by pressing xplot's Help/About button.
AUTHOR
xplot V1.18 Copyright (c) ICCE / Karel Kubat 1995
This manual page by Peter S Galbraith <psg@debian.org> using info from
/usr/share/xplot/xplot.help for the Debian GNU/Linux system (but may be used by others).
XPLOT(1)