vxlplot − graphical plot utility for VisionX excel files

vvplot [if=<inputfile>] [of=<outputfile>] [-s] [-bx] [-bw] [-br] [-xy] [-k] [xl=] [yl=] [t=] [k=] [yr=] [ps=] [ppm=] [pbm=] [pgm=] [pnm=] [-gnu] [-i]

Vxlplot is a utility for making graphical plot files from VisionX Excel format files. VisionX files with comma-separated (VX_CTABLE), tab-separated (VX_TTABLE) data elements, or floating point vectors are supported. Only one type is supported per file, and only one instance of each type. Vxlplot supports the following formats: xy plots, bar charts, box-whisker plots, and box plots. The input file must have the data formatted correctly for each of the plot types. Vxlplot is usually used internally by vplot but it may also be used alone. The plot files created by vxlplot can be plotted with vplot or output in a number of standard formats. Default plot type is XY plot.

XY Plots

XY plots plot treat the first column (or an index column, if -i is used) as the X value and the remaining columns as Y values. This is similar to how gnuplot interprets data natively. Note that this program treats vectors as rows, not columns, as vvplot does.

Box Plots

Box plots have data represented as X and Y. Centered at each X value is a box the height of the Y value. Only two columns, x and y, are supported. Additional columns will result in the generation of overlapping box plots; if it is desired to have clusters of bars, use the bar chart style. For best results, specify the x and y ranges.

Box-Whisker Plots

Box-whisker plots are typically used to represent statistics about a set of data points. The data file must have 6 columns. Each row represents one box-whisker plot. If the x value is a text label instead of a number, the -i option should be specified to generate x values for plotting. Note that gnuplot may, in some cases, pick poor values for the y range, and thus it is suggested that the y range is manually specified. The columns are:

x value 1st quartile min max 3rd quartile median/mean

This option requires gnuplot 4.2.0 or later; vplot will not generate any output if a lesser version of gnuplot is installed.

Bar charts

Bar charts represent several data series as clusters of bars. Each data series goes down a column, with each row representing a value on the x-axis. There should be at least 2 columns, of the format:

x value count1 ... countN

This will result in plot with the a number of clusters equal to the number of rows, with each cluster containing N bars. Note that gnuplot may pick poor values for the y range, and it may be necessary to manually specify the y range. This option requires gnuplot 4.2.0 or later; vplot will not generate any output if a lesser version of gnuplot is installed.

-s

Run in silent mode, only create the data file for gnuplot. By default gnuplot commands and other information is included with the file.

-bx

Select the box plot style for the gnuplot format

-bw

Select the box-whisker style for the gnuplot plot format.

-br

Select a bar chart for the gnuplot format.

-i

For box-whisker or xy plots, generate an index value to use for the x-axis.

xl=

Set the X axis label.

yl=

Set the Y axis label.

t=

Set the plot title. If t= is specified with no argument, then the data file name is used.

yr=

Set the Y axis range. The range is given by the string "ylo:yhi".

-k

Include a key to distinguish different data series (mainly for bar charts)

k=

For multiple vector plots, specifies a string of comma delimited labels to be used as the title of each vector plot in the key.

ps=

Generate Postscript file output. The default file name is "vplot.eps".

ppm= pbm= pgm= pnm=

Generate the respective pbmPlus format image file. The default file name for all formats is "vplot.pnm".

-gnu

Generate a gnuplot command and data file. The gnuplot command file will be "<filename>.gnu" and the data file will be "<filename>.dat". Where <filename> is given by the "of=" parameter. The default filenames are "vplot.gnu" and "vplot.dat".

A. P. Reeves, R. J. Prokop, W. J. Kostis, A. C. Jirapatnakul

vexcel(1), vvplot(1), vplot(1), gnuplot(1)