VTPLOT

VisionX V4

NAME

vtplot − graphical plot utility using R

SYNOPSIS

vtplot [if=<inputfile>] [of=<outputfile>] [dN=] [s=] [f=] [ct=] [xl=] [yl=] [xmin=] [ymin=] [xmax=] [ymax=] [cl=] [lw=] [lp=] [-c] [-bw] [-b] [-pt] [-logx] [-logy] [-l] [-r] [-v] [-d]

DESCRIPTION

Vtplot is a utility for making graphical plot files. In general it is used by vplot when the -rpng option is specified. It uses the R statistics package. It is desigend to use the composite gnu file format used by vplot and vfig. The intiial version has limited capabilites.

CONSTRAINTS

Initial verions both one-line and multiple-line plots are supported. However certain customized options only work for one-line plots.

OPTIONS

if=<infile>

The input file is a composit gnuplot file that is used by gnuplot and other plotting utilities. Alterntively a text file with multiple columns may be accepted. If if= has one column, it is used as the Y-axis values. If if= has more than one column, the first two columns are used as the X-Y axis values.

of=<outfile>

The output file is in color png format

dN=<N=1,2,3,4>

Additional data for multiple-line plots. dN= is the column number in the input file if=. When dN= is specified, the first two columns of if= are used as X-Y axis values for the first line. Then the additional lines are added using the same format (line type, width) with different colors. (d1=green, d2=blue, d3=black, d4=purple). Note that boxwhisker plot (-bw), logarithmic x or y (-logx, -logy) only work for one-line plot.

s=[x[,y]]

The size option as specifies the size in pixels of the resulting file. Default s is x=400 and y=300.

f=<font size>

Text font size including title, axis labels and values. Default is 1.5. Legend font size is set to be f-0.5.

	xl=<text>		X-axis label
	yl=<text>		Y-axis label
	ct=<text>		Plot title
	xmin=<>		X-axis minimum (default computed from data)
	ymin=<>		Y-axis minimum (default computed from data)
	xmax=<>		X-axis maximum (default computed from data)
	ymax=<>		Y-axis maximum (default computed from data)
	cl=<>		plot color (default red), in multiple-line plots cl=<> only controls the first line color
	lw=<>		line width (default 1)
	lp=<>		legend position (lp=1,2,3,4, default 1=TopLeft, 2=TR, 3=BL, 4=BR)
	-c		Input is a csv file (default is table file)
	-bw		Box-whisker plots (default line plots). It does not work for dN=.
	-b		Barplot (default lines). It does not work for dN= or -logx/-logy.
	-pt		Plot with points (default lines)
	-logx		X-axis logarithmic. It does not work for dN=.
	-logy		Y-axis logarithmic. It does not work for dN=.
	-l		Legend. Legend color uses the same color as each line. Legend text uses the header name of each column data being plotted.
	-r		ROC plot. if= contains two columns, the 1st is binary class labels and the 2nd is predicted values. Output is the corresponding ROC plot.
	-v		verbose flag
	-d		Debug flag, more information and tmp files are saved in the current directory

AUTHOR

A. P. Reeves, Y. Xie