VTPLOTVisionX 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