QUICKPLOT

NAME

SYNOPSIS

DESCRIPTION

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 zoom level: 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 plot of all the data: 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

-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 --func-plot and -p or --phase-plot are not used the default plots will be function plots of all fields 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.

-s or --same-scale

Plot all plots on the same scale.

-v or --verbose

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.

-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 some license information to standard output. If you want just the version number try for example: quickplot --version | awk '/version: / {print $2}'

-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 forthcomming 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:

% quickplot -geometry 1000x1000+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.

-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

SEE ALSO

COPYRIGHT

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

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

X-OPTIONS

AUTHOR

SEE ALSO

COPYRIGHT

BUGS