VRHIST

VisionX V4

NAME

vrhist − histogram plot utility using R

SYNOPSIS

vrhist [if=] [of=] [c=] [xl=] [yl=] [s=] [-v] [-d] [c=] [ct=] [xl=] [yl=]

DESCRIPTION

Vrhist is a utility for making a histogram plot. This beta version requires a csv file with a header row and that the column of interest be specified by the c= parameter. It uses the R statistics package. The intiial version has limited capabilites. If the -c option is specified then a histogram for a categorical variable is created; in this case the numerical and statistical options have no effect.

CONSTRAINTS

Initial verions only one-line plots are currently supported.

OPTIONS

if=<infile>

is a csv text file that must have a header. It selects the specified column in the csv and plots a histogram of that data. Blank row values in the csv file are ignored.

(The input file is a composit gnuplot file that is used by gnuplot and other plotting utilities. Alterntively a text file with one or two collumns may be accepted.)

of=<outfile>

The output file is in color png format (R will add .png to the name)

c=<column>

THe column in the csv file to be selected for the histogram

	s=[x[,y]]		The size option as specifies the size in pixels of teh resulting file. If on x is specified then y is set to teh same value
	-c		plot the histogram for a categorical rather than a numerical variable
	ct=<text>		The title of the graph
	xl=<text>		X-axis label (default is value)
	yl=<text>		Y-axis label (Defualt is Frequency)

mn=<value>

Set the minimum value for the x-axis

mx=<value>

Set the maximum value for the x-axis

	-p		Set the value scale to be 0 to 100 (percentage)
	-b		Set the value scale to be 0 to 256 (unisgned byte)

sp=<number>

set the statistics position in the x- direction. Arg is a number in the range 1-10. 1 is at the far left and 10 is close to the far right.

	-s		Inhibit the display of the descriptive statistics
	-v		verbose flag
	-d		Debug flag, more information and tmp files are sved in the current directory

AUTHOR

A. P. Reeves