.LP
Xprism2 can be executed from within cantata or directly from the command line.
The minimum syntax specification to run xprism2 from the command line is:
.sp
% xprism2
.sp
After initiating xprism2 from the command line, use your window manager to place
the xprism2 master form (your window manager may use automatic placement).  
The xprism2 master form consists of subform and
action buttons positioned along the left hand side of a workspace, which is
used to display the plot. The xprism2 form will be updated based on the 
command line parameters specified.
.SH
Command Line Arguments
.LP
There are numerous options available to the user for xprism2.  
Below are described the various options which can be
set on the command line when starting up xprism2.
The command line arguments are broken into three major parts. 
Options can be set for all plots areas, for a specific area plot, and for
a specific plot in a specific area. The options set for a specific plot in 
a specific area will override the same options set for a specific area and
all plot areas. The options set for a specific plot area will override
the same options set for all plot areas. NOTE, at this time there is only
one plot area available. Therefore by setting the options for
all plot areas is the same as setting options for plot area one.
This heirarchy allows the user to globally (all plot areas), locally (a
specific plot area) or specifically (a specific plot in a specific plot area)
set command line options for xprism2.
.LP
Since many of the command line options can be used for all plot areas,
a specific plot area or a specific plot in a specific area the following
convension will be used to describe the command line options:
.RS
.IP & 10
[Plot area number] Only 1 plot area is currently available.
.IP * 10
[File number | plot number] Ranges from 1-20;
.IP -fmax
If the option does not have a "&" or a "*" following it then the option
applies to all plot areas and all plots in all plot areas.
.IP -fmax&
If the option has an "&" folowing it then the option is valid only for
a plot area (i.e. -fmax1 would apply to plot area #1).
.IP -fmax&*
If the option has an "&" and a "*" following it then the option is only
valid for a specific plot in a specific plot area (i.e. -fmax15 would apply
to plot area #1 plot #5 in that area).
.IP -fmax[&]
If the option has an "[&]" then the option is valid for either all plot areas
or for a specific plot area. (.i.e -fmax would apply to all plot areas, while
-fmax1 would only apply to plot area #1).
.IP -fmax[&][*]
If the option has an "[&]" and a "[*]" then the option is valid for all plot
areas, a specific plot area or a specific plot in a specific plot area
(i.e. -fmax would apply to all plot areas, -fmax1 would only apply to plot area #1 and -fmax13 would apply to plot area #1 plot #3)
.RE
.LP
Spacing must be exactly as shown; if two symbols are directly
adjacent to each other, then so should be their corresponding
values.  
.SH 
Usage
.LP
.RS
% xprism2
.br
.LP
****  General flags ****
.sp
.br
.IP [-fn] 10 
Specifies the font for xprism2
.IP "[-jr filename.jr]" 10 
Executes a journal recording of xprism2
.IP "[-jp filename.jp]" 10 
Executes a journal playback of xprism2
.IP [-V] 10 
Gives the version for xprism2
.IP [-U] 10 
Gives the usage for xprism2
.IP [-P] 10 
Prompts for a subset of all the possible arguments
.IP "[-A [file1]]" 10 
Creates the answer file called xprism2.ans or file1
.IP "[-a [file1]]" 10 
Uses xprism2.ans or file1 as the answer file
.sp 2
.LP
****  Alternate User Interface Description File ***
.sp 
.IP -form 10
Specify an alternate user interface description file.
Note that the user interface description file used 
MUST have the exact same database lines, in the same
order, as that in $KHOROS_HOME/repos/xprism/xprism2.form.
Default values, labels, etc. may be modified without
harming the operation of xprism2.
.RS
.IP Type: 10
string
.IP Default:
$KHOROS_HOME/repos/xprism/xprism2.form
.IP Example: 10 
-form ~dargiro/forms/xprism2.form
.RE
.sp 2
.LP
*** Workspace Number of Areas and Plots *** 
.sp
.IP -na
Specify the number of plot areas for the workspace. Currently xprism2
only supports 1 plot area.
.RS
.IP Type: 10
integer [0-1]
.IP Default: 10
1 (1 plot area)
.IP Example: 10
-na 1 -- sets the number of plot areas in the workspace to 1.
.RE
.IP -np& 10
Specify the number of plots in a plot area. The maximun number of plots
per area is 20.
.RS
.IP Type: 10
integer [1-20]
.IP Default: 10
1 (1 plot)
.IP Example: 10
-np1 5 -- sets plot area #1 to accept 5 plot specifications from the command line.
.RE
.sp 2
.LP
****  Input from Files or Functions  ****
.sp
.IP -i&* 10
Specify a single plot, with data originating in an
input file.  This file may be an
explicit or implicit image file, ascii file with a
function, an ascii file of data points, or a raw data file.  
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-i12 ascii_data  { if the file ascii_data exists in the local "." directory} This will plot the file ascii_data as plot #2 in area #1. 
.RE
.IP -func&* 10
Specify a single plot, with data originating from the 
supplied function.  For more information on the mathematical 
functions used by xprism2, see manual section Vol 1. Chapter 3.
If the function is specified on the command line it must be
surrounded by quotes (i.e. "sin(x)"). If the function is described
using the -P (prompt) option or in an answer file, the quotes are not
needed.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
 -func11 "sin(x)" - This will plot the function sin(x) in plot area #1 as plot #1.
.RE
.sp 2
.LP
****  Data Format, Data Type, Machine Type ***
.sp
.IP -df[&][*] 10
The format of the data. If the data is Y ONLY, then X values are assigned 
to each Y point starting at 0. The valid options for the -df argument are:
1 = XY Pairs; 2 = Y ONLY. This option is only valid
if the data is RAW or ASCII, otherwise it is ignored.
.RS
.IP Type: 10
integer [1-2]
.IP Default: 10
1 (XY Pairs)
.IP Example: 10
-df1 2 -- set the data format to be Y data Only for plot area #1
.br
-df 1 -- sets to data format to be XY PAIRS for all plots in all plot areas.
.RE
.IP -dt[&][*] 10
The Raw data type. The raw data type allows almost all different type 
of raw data to be plotted. The valid options for the -dt argument are:
1 = Byte, 2 = Integer, 3 = Integer, and 4 = Float. This
option is only valid if the data is RAW, otherwise it is ignored.
.RS
.IP Type: 10
integer [1-4]
.IP Default: 10
4 (float)
.IP Example: 10
-dt 3 -- sets the data type for all plot areas to short.
.br
-dt12 3 -- sets the data type for plot area #1, plot #2 to short.
.RE
.IP -mach[&][*] 10
Sets the Raw data machine type. This will allow data generated on a 
different machine to be displayed on the current machine in the case that 
they are different architectures. See the xprism2 manual for a list of 
valid machine types. This option is only valid if the data is RAW, 
otherwise it is ignored.
.RS
.IP Type: 10
integer
.IP Default: 10
(current machine)
.IP Example: 10
-mach1 2 -- Sets the machine type to "Dec 3100/2100" for plot area #1.
.br
-mach11 9 -- Sets the machine type to "Sun 3,  Sun 4, SunSparc" for 
plot area #1, plot #1.
.RE
.sp 2
.LP
****  Viff Image Data Band and Complex Type ***
.sp
.IP -band[&][*] 10
If the input image is a VIFF image and it is multiband, then the -band
option allows one to select the desired data band to plot. Note, 
the band numbering starts at 0 and goes to n - 1.
.RS
.IP Type: 10
integer 
.IP Default: 10
0 (first data band)
.IP Example: 10
-band1 2 -- plot data band number 2 (the third data band) for plot area 1.
.br
-band 1 -- plot data band number 1 (the second data band) for all plots.
.RE
.IP -cmplx[&][*] 10
If the input image is a VIFF image and it has a data storage type of COMPLEX,
then the -cmplx option allows one to select the desired 
complex type to plot. The valid complex plot types are:
.DS
        Real Part: 1       Imaginary Part: 2
        Magnitude: 3       Phase: 4
.DE
.RS
.IP Type: 10
integer [1-4]
.IP Default: 10
1 (Real Part)
.IP Example: 10
-cmplx1 4 -- plot the phase computed from the complex image for area 1. 
.br
-cmplx11 2 -- plot the imaginary part for plot 1 in area 1.
.RE
.sp 2
.LP
**** Range and Number of Points for Functions ***
.sp
.IP -fxmin[&][*] 10
The minimum X value to be evaluated for the -func option, 
the value must be less than -fxmax and can be a constant such as pi.
.RS
.IP Type: 10
string
.IP Default: 10
(-1.0)
.IP Example: 10
-fxmin -pi --  sets x function minimum to -3.1415 for all plots and plot areas.
.br
-fxmin1 -3.1415 -- sets x function minimum to -3.1415 for plot area #1
.br
-fxmin11 pi -- sets x function minimum to 3.1415 for plot area #1 plot #1
.RE
.IP -fxmax[&][*] 10
The maximum X value to be evaluated for the -func option,
the value must be greater than -fxmin and can be a constant such as pi.
.RS
.IP Type:
string
.IP Default: 10 
(1.0)
.IP Example: 10
-fxmax  3.1415 -- sets x function maximum to 3.1415 for all plots and plot areas. 
.RE
.IP -fpts[&][*] 10 
The number of points to be evaluated for the -func option 
over the [fxmin -- fxmax]  range.  
.RS
.IP Type:
string
.IP Default: 10 
40 points.
.IP Example: 10
-fpts11 10 - sets the number of points to be plotted by the -func11 (plot area 
#1, plot #1) to 10.
.RE 
.sp 2
.LP
****  Plot  Type  Options ***
.sp
.IP -pt[&][*]: 10		
Specify the plot type.  Valid options for the plot type are:
0 = 2D, 1 = Discrete, 2 = Bargraph
.br
3 = Polymarker, 4 = Linemarker
.RS
.IP Type: 10
integer [1-5]
.IP Default: 10
1 (2d)
.IP Example: 10
-pt 2 -- set all plots in all areas to Discrete.
.br
-pt1 2 -- set all plots in plot area #1 to Discrete.
.RE
.IP -mt[&][*] 10
Specify the default marker type.  Each plot will have
its own marker type if this flag is not used, plots
1-15 having marker types 1-15 respectively, and plots
16-20 having repeating marker types starting at 1.  
Valid Options for marker types are:
.DS

   Square:  1       Triangle: 2      
   Cross:   3       BowTie:   4      
   Arc:     5       Diamond:  6      
   Circle:  7       V:        8
   Hexagon: 9       X:        10
   Dot:     11      Caret:    12
   Point:   13      Dagger:   14
   Box:     15

.DE
.RS
.IP Type: 10
integer [1-15]
.IP Default: 10
1 (square)
.IP Example: 10
-mt11 11 -- set plot #1 in area #1 to marker type of dot.
.br
-mt 10 -- set all plots in all areas to have a marker type of X.
.RE
.IP -lt[&][*] 10
Specify the default line type.  Solid is the default
line type if this flag is not used. Note that 
specifying  a line type for a Linemarker or Polymarker
plot will have NO effect.  This is because Linemarker
and Polymarker plots may only use solid lines, by
definition.  Line types are reserved for 2D plots,
Bargraphs, and Discrete plots. The valid options for line types are as follows:
.DS

   Solid:        1      Dotted:       2
   Dot-Dashed:   3      Short-Dashed: 4
   Long-Dashed:  5      Odd-Dashed:   6

.DE
.RS
.IP Type: 10
integer [1-6]
.IP Default: 10
1 (solid)
.IP Example: 10
-lt 5 -- set the line tyle for all plots in all areas to Long-Dashed
.RE
.sp 2
.LP
****  Plot Viewing Options ***
.sp
.IP -legend[&] 10
Specify whether or not the legend is showing. 
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
1 (showing)
.IP Example: 10
-legend 0 -- sets the plot legend to not showing for all plot areas.
.br
-legend1 0 -- sets the plot legend to not showing for plot area #1.
.RE
.IP -box[&] 10
Specify whether or not the plot will contain a box around it. This
actually puts an axis on all four sides of the plot.
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
0 (not boxed)
.IP Example: 10
-box 1 -- sets the box to showing for all plot areas.
.br
-box1 0 -- sets the box to showing for plot area #1.
.RE
.IP -numlabels[&] 10
Specify whether or not the numberical labels on the x and y axes are showing. 
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
1 (showing)
.IP Example: 10
-numlabels 0 -- sets the numerical labels on the x and y axes to not showing 
for all plot areas.
.br
-numlabels1 0 -- sets the numerical labels on the x and y axes to not showing
for plot area #1.
.RE
.IP -axes[&] 10
Specify whether or not the x and y axis lines are showing. 
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
1 (showing)
.IP Example: 10
-axes 0 -- sets the plot x and y axis lines to not showing for all plot areas.
.br
-axes1 0 -- sets the plot sets the x and y axis lines to not showing for plot area #1.
.RE
.IP -grid[&] 10
Specify whether or not the plot grid is showing. 
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
0 (not showing)
.IP Example: 10
-grid 1 -- sets the plot grid to showing for all plot areas.
.br
-grid1 1 -- sets the plot grid to showing for plot area #1.
.RE
.IP -autoscale[&] 10
Specify whether or not the axes are labeled "nice". This uses a hieristic
algorithm to compute the axes minimum, maximum and interval values based
on the give data. This is used to make the axes labeling look "nice".
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
0 (autoscale off)
.IP Example: 10
-autoscale 1 -- sets autoscale to on for all plot areas.
.br
-autoscale1 1 -- sets autoscale to on for plot area #1.
.RE
.IP -clrls[&] 10
Specify whether or not the all plot labels are to be showing or not.
This effects the title and x and y axis labels.
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
0 (do not clear lables)
.IP Example: 10
-clrls 0 -- the plot labels will not be showing for all plot areas.
.br
-clrls1 0 -- the plot labels will not be showing for plot area #1.
.RE
.IP -rsrl[&] 10
Specify whether or not the axes are in rescale (1) mode or relabel (2) mode. 
When in relabel mode the axes are labeled as specified by the -xlmin, -xlmax,
-xlint, -ylmin, -ylmax and -ylint arguments.
.RS
.IP Type: 10
integer [1-2]
.IP Default: 10
1 (rescale)
.IP Example: 10
-rsls 0 -- sets the axes to be relabeled for all plot areas.
.br
-rsls1 0 -- sets the axes to be relabeled for plot area #1
.RE
.IP -xtics[&]
Specify the number of minor inteval lines between each major interval on
the X-axis.
.RS
.IP Type: 10
integer [0-20]
.IP Default: 10
0 (no minor interval lines showing)
.IP Example: 10
-xtics 5 -- sets all plots in all areas to have 5 minor interval lines between 
each major interval on the X-axis.
.br
-xtics1 5 -- sets area #1's X-axis to have 5 minor interval lines between 
each major interval.
.RE
.IP -ytics[&]
Specify the number of minor inteval lines between each major interval on
the Y-axis.
.RS
.IP Type: 10
integer [0-20]
.IP Default: 10
0 (no minor interval lines showing)
.IP Example: 10
-ytics 5 -- sets all plots in all areas to have 5 minor interval lines between 
each major interval on the Y-axis.
.br
-ytics1 5 -- sets area #1's Y-axis to have 5 minor interval lines between 
each major interval.
.RE
.IP -active[&][*] 10
Specify whether or not the plot should be drawn or is active.
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
1 (active)
.IP Example: 10
-active 0 -- sets all plots in all areas not to be drawn.
.br
-active1 0 -- sets all plots in area #1 not to be drawn.
.br
-active12 0 -- sets plot #2 in area #1 not to be drawn.
.RE
.sp 2
.LP
**** Plot Axes Values ***
.sp
.IP -xsmin[&] 10
Specifies the X-axis minimum value. When this is set to greater then the plot data's
minimum, the plots will be clipped. This is used to initally set an area's plots
X-axis to a specified value. If this argument is specifed, the -xsmax  and
-xsint arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
Plot area's data minimum value.
.IP Example: 10
-xsmin -1.0 -- sets all plot areas X-axis minimum value to -1.0.
.br
-xsmin1 -1.0 -- sets plot area #1 X-axis minimum value to -1.0.
.RE
.IP -xsmax[&] 10
Specifies the X-axis maximum value. When this is set to less then the plot data's
maximum, the plots will be clipped. This is used to initally set an area's plots
X-axis to a specified value. If this argument is specifed, the -xsmin  and
-xsint arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
Plot area's data maximum value.
.IP Example: 10
-xsmax 1.0 -- sets all plot areas X-axis maximum value to 1.0.
.br
-xsmax1 1.0 -- sets plot area #1 X-axis maximum value to 1.0.
.RE
.IP -xsint[&] 10
Specifies the X-axis interval value.  This is the interval between major tics
on the X-axis. This should be set to a resonable value based on the 
-xsmin and -xsmax arguments. If this argument is specifed, the -xsmax  and
-xsmin arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
some "nice" value
.IP Example: 10
-xsint 1.0 -- sets all plot areas X-axis major interval value to 1.0.
.br
-xsmin1 -1.0 -- sets plot area #1 X-axis major interval value to 1.0.
.RE
.IP -xlmin[&] 10
Specifies the labeled X-axis minimum value. 
This argument allows the user to relabel the X-axis minimum value without effecting the
data plotted. For this to take effect the -rsls argument must be set to Relabel.
If this argument is specifed, the -xlmax  and -xlint arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
the current minimum value
.IP Example: 10
-xlmin -1000.0 -- sets all plot areas X-axis labeled minimum value to -1000.0.
.br
-xlmin1 1.0 -- sets plot area #1 X-axis labeled minimum value to 1.0.
.RE
.IP -xlmax[&] 10
Specifies the labeled X-axis maximum value.
This argument allows the user to relabel the X-axis maximum value without effecting the
data plotted. For this to take effect the -rsls argument must be set to Relabel.
If this argument is specifed, the -xlmin  and -xlint arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
the current maximum value
.IP Example: 10
-xlmax 1000.0 -- sets all plot areas X-axis labeled maximum value to 1000.0.
.br
-xlmax1 1000.0 -- sets plot area #1 X-axis labeled maximum value to 1000.0.
.RE
.IP -xlint[&] 10
Specifies the X-axis labeled interval value.  This is the interval between major tics
on the X-axis. This should be set to a resonable value based on the 
-xlmin and -xlmax arguments. If this argument is specifed, the -xlmax  and
-xlmin arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
the current interval value
.IP Example: 10
-xlint 1.0 -- sets all plot areas X-axis labeled major interval value to 1.0.
.br
-xlmin1 -1.0 -- sets plot area #1 X-axis labeled major interval value to 1.0.
.RE
.IP -ysmin[&] 10
Specifies the Y-axis minimum value. When this is set to greater then the plot data's
minimum, the plots will be clipped. This is used to initally set an area's plots
X-axis to a specified value. If this argument is specifed, the -ysmax  and
-ysint arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
Plot area's data minimum value.
.IP Example: 10
-ysmin -1.0 -- sets all plot areas Y-axis minimum value to -1.0.
.br
-ysmin1 -1.0 -- sets plot area #1 Y-axis minimum value to -1.0.
.RE
.IP -ysmax[&] 10
Specifies the Y-axis maximum value. When this is set to less then the plot data's
maximum, the plots will be clipped. This is used to initally set an area's plots
X-axis to a specified value. If this argument is specifed, the -ysmin  and
-ysint arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
Plot area's data maximum value.
.IP Example: 10
-ysmax 1.0 -- sets all plot areas Y-axis maximum value to 1.0.
.br
-ysmax1 1.0 -- sets plot area #1 Y-axis maximum value to 1.0.
.RE
.IP -ysint[&] 10
Specifies the Y-axis interval value.  This is the interval between major tics
on the Y-axis. This should be set to a resonable value based on the 
-ysmin and -ysmax arguments. If this argument is specifed, the -ysmax  and
-ysmin arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
some "nice" value
.IP Example: 10
-ysint 1.0 -- sets all plot areas Y-axis major interval value to 1.0.
.br
-ysmin1 -1.0 -- sets plot area #1 Y-axis major interval value to 1.0.
.RE
.IP -ylmin[&] 10
Specifies the labeled Y-axis minimum value. 
This argument allows the user to relabel the Y-axis minimum value without effecting the
data plotted. For this to take effect the -rsls argument must be set to Relabel.
If this argument is specifed, the -ylmax  and -ylint arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
the current minimum value
.IP Example: 10
-ylmin -1000.0 -- sets all plot areas Y-axis labeled minimum value to -1000.0.
.br
-ylmin1 1.0 -- sets plot area #1 Y-axis labeled minimum value to 1.0.
.RE
.IP -ylmax[&] 10
Specifies the labeled Y-axis maximum value.
This argument allows the user to relabel the Y-axis maximum value without effecting the
data plotted. For this to take effect the -rsls argument must be set to Relabel.
If this argument is specifed, the -ylmin  and -ylint arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
the current maximum value
.IP Example: 10
-ylmax 1000.0 -- sets all plot areas Y-axis labeled maximum value to 1000.0.
.br
-ylmax1 1000.0 -- sets plot area #1 Y-axis labeled maximum value to 1000.0.
.RE
.IP -ylint[&] 10
Specifies the Y-axis labeled interval value.  This is the interval between major tics
on the Y-axis. This should be set to a resonable value based on the 
-ylmin and -ylmax arguments. If this argument is specifed, the -ylmax  and
-ylmin arguments must also be specified.
.RS
.IP Type: 10
float 
.IP Default: 10
the current interval value
.IP Example: 10
-ylint 1.0 -- sets all plot areas Y-axis labeled major interval value to 1.0.
.br
-ylmin1 -1.0 -- sets plot area #1 Y-axis labeled major interval value to 1.0.
.RE
.sp 2
.LP
****  Plot Data Windowing and Sampling ***
.sp
.IP -xb[&][*] 10
Specify the first of the data points to plot. That is,
which data point to begin with, the data points being numbered sequentially.
For example, if the "Begin Point" is specified as 5, the plot will start with
the fifth data point.  If the "Begin Point" is set to 0 (the default value),
then the "end point" is ignored and all data points are used. 
.RS
.IP Type: 10
integer
.IP Default: 10
0 (all data points)
.IP Example: 10
-xb 10 -- sets all plot data in all areas to start with the 10th data point.
.br
-xb11 10 -- sets plot #1's data in area #1 to start with the 10th data point.
.RE
.IP -xe[&][*] 10
Specify the last of the data points to plot. That is,
which data point to end with, the data points being numbered sequentially.
For example, if the "End Point" is specified as 25, the plot will end with the
twenty-fifth data point. If the "End Point" is set to 0 (the default value),
then the last data point in the file is used as the end point.
.RS
.IP Type: 10
integer 
.IP Default: 10
0 (the last data point)
.IP Example: 10
-xe 20 -- sets all plot data in all areas to end with data point number 20.
.br
-xe11 20 -- sets plot #1's data in area #1 to end with data point number 20.
.RE
.IP -xs[&][*] 10
Specify the step size which determines how the data should be subsampled
between the begin point and the end point. The default value is 1;  every
point is used.
.RS
.IP Type: 10
integer 
.IP Default: 10
1 (every data point)
.IP Example: 10
-xs 2 -- sets all plot data in all areas to skip every other point before displaying.
.br
-xs11 2 -- sets plot #1's data in area #1 to skip every other point before displaying.
.RE
.sp 2
.LP
****  Plot  Labels  ***
.sp
.IP -title[&] 10
Specify string for title of plot.
.RS
.IP Type: 10
sting 
.IP Default: 10
"Xprism2 Plot"
.IP Example: 10
-title "Frequency_Plot" -- sets the plot title to that specified for all plot areas.
.br
-title1 "Frequency_Plot" -- sets the plot title to that specified for plot area #1.
.RE
.IP -xaxis[&] 10
Specify string for the label on the X-axis.
.RS
.IP Type: 10
sting 
.IP Default: 10
"X-Axis"
.IP Example: 10
-xaxis "Time" -- sets the plot X-axis label to that specified for all plot areas.
.br
-xaxis1 "Time" -- sets the plot X-axis label to that specified for plot area #1.
.RE
.IP -yaxis[&] 10
Specify string for the label on the Y-axis.
.RS
.IP Type: 10
sting 
.IP Default: 10
"Y-Axis"
.IP Example: 10
-yaxis "Response" -- sets the plot Y-axis label to that specified for all plot areas.
.br
-yaxis1 "Response" -- sets the plot Y-axis label to that specified for plot area #1.
.RE
.IP -legendstr[&][*] 10
Specify the legend label for a plot.
.RS
.IP Type: 10
string
.IP Default: 10
plot # 
.IP Example: 10
-legendstr11 "sin wave" -- sets the legend label to "sin wave" for plot #1 in area #1.
.br
-legendstr12 "cos wave" -- sets the legend label to "cos wave" for plot #2 in area #1.
.RE

.sp 2
.LP
****  Color Options ***
.sp
.IP "Available Colors For The Plot Arguments" 10
The list of color options below can be used with the following command line
arguments.
-pc (plot color), -color (axes, grid and labels color), 
-tc (plot title color), 
-xalc (x-axis label color), -xac (x-axis color), -yalc (y-axis label color)
-yac (y-axis color), -nxac (numerical labels on x-axis), 
-nyac (numerical labels on y-axis), -gc (grid color), -lc (legend color),
.DS

    White:  0       Green:     1
    Yellow: 2       Cyan:      3
    Orchid: 4       Magenta:   5
    Orange: 6       Wheat:     7
    Lime:   8       Turquoise: 9
    Pink:   10      LightGrey: 11
    Plum:   12      Forest:    13
    Salmon: 14      Thistle:   15
    Violet: 16      OrangeRed: 17
    Red:    18      SeaGreen:  19
    Blue:   20      Goldenrod: 21
    Coral:  22      Sienna:    23

.DE
.br
NOTE, specifying colors on a monochrome monitor has no effect. Specifying
colors on a display of less than 256 colors may or may not be available
for use.
.IP -pc[&][*] 10
Specify the plot color. If this option is not specified, each successive plot
specified by -i&* and -func&* will be given a different color starting
with 1 (green).
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-pc11 18 -- sets the plot color to Red for plot #1 in area #1.
.br
-pc 18 -- sets all plots in all areas to Red.
.RE
.IP -color[&] 10
Specify the color for all axes, grid, box, and labels. This is a master argument
for setting the color.
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-color 18 -- sets the "global" color to Red for all plot areas.
.br
-color1 18 -- sets the "global" color to Red for plot area #1.
.RE
.IP -tc[&] 10
Specify the color for plot title.
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-tc 18 -- sets the title color to Red for all plot areas.
.br
-tc1 18 -- sets the title color to Red for plot area #1.
.RE
.IP -xalc[&] 10
Specify the color for the x-axis labels.
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-xalc 18 -- sets the x-axis label color to Red for all plot areas.
.br
-xalc1 18 -- sets the x-axis label color to Red for plot area #1.
.RE
.IP -yalc[&] 10
Specify the color for the y-axis label.
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-yalc 18 -- sets the y-axis label color to Red for all plot areas.
.br
-yalc1 18 -- sets the y-axis label color to Red for plot area #1.
.RE
.IP -xac[&] 10
Specify the color for x-axis line.
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-xac 18 -- sets the x-axis line color to Red for all plot areas.
.br
-xac1 18 -- sets the x-axis line title color to Red for plot area #1.
.RE
.IP -yac[&] 10
Specify the color for the y-axis line.
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-yac 18 -- sets the y-axis line color to Red for all plot areas.
.br
-yac1 18 -- sets the y-axis line color to Red for plot area #1.
.RE
.IP -nxac[&] 10
Specify the color for numerical labels on the x-axis.
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-nxac 18 -- sets the x-axis numerical lables color to Red for all plot areas.
.br
-nxac1 18 -- sets the x-axis numerical lables color to Red for plot area #1.
.RE
.IP -nyac[&] 10
Specify the color for numerical labels on the y-axis.
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-nyac 18 -- sets the y-axis numerical labels color to Red for all plot areas.
.br
-nyac1 18 -- sets the y-axis numerical labels color to Red for plot area #1.
.RE
.IP -gc[&] 10
Specify the color for plot grid.
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-gc 18 -- sets the grid color to Red for all plot areas.
.br
-gc1 18 -- sets the grid color to Red for plot area #1.
.RE
.IP -lc[&] 10
Specify the color for plot legend.
.RS
.IP Type: 10
integer [0-23]
.IP Default: 10
0 (white)
.IP Example: 10
-lc 18 -- sets the legend color to Red for all plot areas.
.br
-lc1 18 -- sets the legend color to Red for plot area #1.
.RE
.sp 2
.LP
*** Label Font Types ***
.IP "Available fonts For The Plot Options" 10
The list of font options below can be used with the following command line
arguments: -font (all labels), -xaf (x-axis font), -yaf (y-axis font),
-numf (axes numerical labels font), -lf (legend font), -tf (title font).
.DS

    DoubleRoman:    0    SimplexRoman: 1
    Symbols:        2    TimesItalics: 3
    ComplexItalics: 4    ComplexRoman: 5
    TimesRoman:     6

.DE
.IP -font[&] 10
Specify font type for all text.  Default is DoubleRoman.
.RS
.IP Type: 10
integer [0-6]
.IP Default: 10
0 (DoubleRoman)
.IP Example: 10
-font 3 -- sets all the labels in all areas to the TimesItalics font.
.br
-font1 3 -- sets all the labels in area #1 to the TimesItalics font.
.RE
.IP -xaf[&] 10
Specify font type for the X-axis label.  Default is DoubleRoman.
.RS
.IP Type: 10
integer [0-6]
.IP Default: 10
0 (DoubleRoman)
.IP Example: 10
-xaf 3 -- sets the 's X-axis label in all areas to the TimesItalics font.
.br
-xaf1 3 -- sets the X-axis label in area #1 to the TimesItalics font.
.RE
.IP -yaf[&] 10
Specify font type for the Y-axis label.  Default is DoubleRoman.
.RS
.IP Type: 10
integer [0-6]
.IP Default: 10
0 (DoubleRoman)
.IP Example: 10
-yaf 3 -- sets the Y-axis label in all areas to the TimesItalics font.
.br
-yaf1 3 -- sets the Y-axis label in area #1 to the TimesItalics font.
.RE
.IP -numf[&] 10
Specify font type for the axes numerical labels.  Default is DoubleRoman.
.RS
.IP Type: 10
integer [0-6]
.IP Default: 10
0 (DoubleRoman)
.IP Example: 10
-numf 3 -- sets the numerical axes labels in all areas to the TimesItalics font.
.br
-numf1 3 -- sets numerical axes labels in area #1 to the TimesItalics font.
.RE
.IP -lf[&] 10
Specify font type for legend labels.  Default is DoubleRoman.
.RS
.IP Type: 10 
integer [0-6]
.IP Default: 10
0 (DoubleRoman)
.IP Example: 10
-lf 3 -- sets the legend labels in all areas to the TimesItalics font.
.br
-lf1 3 -- sets the legend labels in area #1 to the TimesItalics font.
.RE
.IP -tf[&] 10
Specify font type for the plot title. Default is DoubleRoman.
.RS
.IP Type: 10
integer [0-6]
.IP Default: 10
0 (DoubleRoman)
.IP Example: 10
-tf 3 -- sets the plot title in all areas to the TimesItalics font.
.br
-tf1 3 -- sets the plot title in area #1 to the TimesItalics font.
.RE
.sp 2
.LP
****  Default Global Input and Ouput Directories ***
.sp
.IP -indir
Secifies the global input directory to read files in from within xprism2.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-indir /research/data/plots -- sets the input global directory to the specified
file.
.RE
.IP -outdir
Secifies the global output directory to write files to from within xprism2.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-outdir /research/data/plots -- sets the output global directory to 
the specified file.
.RE
.sp 2
.LP
****  Default Output Answer File ***
.sp
.IP -outans
Secifies the ouput file to write the answer file to from within xprism2.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-outans /research/data/xprism2.ans -- sets the output answer file name to
the specified file in the xprism2 form.
file.
.RE
.sp 2
.LP
****  Default Filenames for VIFF Image Output Files ***
.sp
.IP -expifile 10
Specifies the name of output file for an explicit image file.  
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-expifile plot1.expl -- sets the explicit image file to ./plot1.expl.
.RE
.IP -impifile 10
Specifies the name of output file for an implicit image file.  
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example:
-impifile plot1.impl -- sets the implicit image file to ./plot1.impl.
.RE
.IP -cmifile 10
Specifies the name of output file for a Khoros VIFF file colormap.  
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example:
-cmifile plot1.cm -- outputs the z data values in th map of a Khoros VIFF file.
.RE
.IP -sdumpfile 10
Specifies the name of output file for a VIFF image screen dump file.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-sdumpfile screendump.xv -- sets the screen dump file to screendump.xv.
.RE
.sp 2
.LP
****  Default Values for Postscript Output ***
.sp
.IP -pslp 10
Specify name of Postscript printer to be used for output.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-pslp borris -- the post-script printer is called "borris"
.RE
.IP -psfile 10
Specifies the name of output file for postscript output of a workspace.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example
-psfile plot1.ps -- sets the output file for postscript output of a workspace
to plot1.ps.
.RE
.IP -psflush 10
Indicates if the postscript printer should
page or not.  Default is ON, so that printer
will page after each plot.  When turned off,
printer will NOT page, so it is possible to
overlay plots on top of one another.
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
1 (on)
.IP Example: 10
-psflush 0 -- sets it so that the printer will not page after each plot sent to
the printer.
.RE
.IP -psinvert 10
Indicates if a photonegative image is desired
on the hardcopy.  Default is ON, producing a
black plot on white background.  Turned OFF,
will give a white plot on a black background.
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
1 (on)
.IP Example: 10
-psinvert 0 -- Sets the postscript output to be white plot on black background.
.RE
.IP -pslandscape 10
Indicates whether or not the postscript output should be printed in landscape
mode or in document mode. The default is OFF document mode.
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
0 (off)
.IP Example:
-pslandscape 1 -- sets the postscript output to print in landscape mode.
.RE
.IP -psmono 10
Indicates whether or not the postscript output should be printed as
a black and white or color plot. The default is black and white.
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
1 (mono)
.IP Example:
-psmono 0 -- sets the postscript output to print color.
.RE
.IP -psw 10
Specify width of printed plot, in inches.
Default is 7 inches.  Minimum value is 1.0,
Maximum value is 11.0.  
.RS
.IP Type: 10
float
.IP Defaults: 10
7 (inches)
.IP Example: 10
-psw 5.0 -- sets the output postscript plot width to 5 inches.
.RE
.IP -psh 10
Specify height of printed plot, in inches.
Default is 7 inches.  Minimum value is 1.0,
Maximum value is 11.0.
.RS
.IP Type: 10
float
.IP Defaults: 10
7 (inches)
.IP Example: 10
-psh 5.0 -- set the output postscript plot height to 5".
.RE
.IP -psx 10
Specify X offset of printed plot on the page, 
in inches, from the upper left hand corner.  
Default is 1 inch.  Minimum value is 0.0, 
Maximum value is 7.0.  Note: beware of 
offsetting your plot off the page!
.RS
.IP Type: 10
float
.IP Default: 10
1.0 (inches)
.IP Example: 10
-psx 1.0 -- set the output postscript x-offset to 1".
.RE
.IP -psy 10
Specify Y offset of printed plot on the page, 
in inches, from the upper left hand corner.  
Default is 3 inches.  Minimum value is 0.0, 
Maximum value is 9.0.  Note: beware of 
offsetting your plot off the page!
.RS
.IP Type: 10
float
.IP Default: 10
3.0 (inches)
.IP Example: 10
-psy 1.0 -- set the output postscript y-offset to 1".
.RE
.IP -psotype
Xprism2 offers vector output (1) or 
raster output (2).  Raster output is a screen dump of the 
workspace.  Default is (1).
.RS
.IP Type: 10
integer [1-2]
.IP Default: 10
1 (vector)
.IP Example: 10
-psotype 2 -- set output postscript to raster output.
.RE
.sp 2
.LP
****  Default Values for Imagen Output ***
.sp
.IP -imlp 10
Specify name of Imagen printer to be used.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-imlp eelaser -- set the printer name to "eelaser"
.RE
.IP -imfile 10 
Specifies the name of output file for an Impress output file.  
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-imfile plot1.im -- set the impress output filename to "plot1.in"
.RE
.IP -imflush 10
Indicates if the imagen printer should
page or not.  Default is ON, so that printer
will page after each plot.  When turned off,
printer will NOT page, so it is possible to
overlay plots on top of one another.
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
1 (page)
.IP Example: 10
-imflush 0 -- set the printer to not flush the page after a plot is sent to it.
.RE
.IP -iminvert 10
Indicates if a photonegative image is desired
on the hardcopy.  Default is ON, producing a
black plot on white background.  Turned OFF,
will give a white plot on a black background.
.RS
.IP Type: 10
logical
.IP Default: 10
1 (black on white)
.IP Example: 10
-iminvert 0 -- sets the plot to be printed on a black background.
.RE
.IP -imw 10
Specify width of printed plot, in inches.
Default is 7 inches.  Minimum value is 1.0,
Maximum value is 11.0.  
.RS
.IP Type: 10
float
.IP Default: 10
7 (inches)
.IP Example: 10
-imw 4.0 -- set the plot width to 4.0".
.RE
.IP -imh 10
Specify height of printed plot, in inches.
Default is 7 inches.  Minimum value is 1.0,
Maximum value is 11.0.
.RS
.IP Type: 10
float
.IP Defaults: 10
7 (inches)
.IP Example: 10
-imh 5.0 -- set the output Impress plot height to 5".
.RE
.IP -imx 10
Specify X offset of printed plot on the page, 
in inches, from the upper left hand corner.  
Default is 1 inch.  Minimum value is 0.0, 
Maximum value is 7.0.  Note: beware of 
offsetting your plot off the page!
.RS
.IP Type: 10
float
.IP Default: 10
1.0 (inches)
.IP Example: 10
-imx 1.0 -- set the output postscript x-offset to 1".
.RE
.IP -imy 10
Specify Y offset of printed plot on the page, 
in inches, from the upper left hand corner.  
Default is 3 inches.  Minimum value is 0.0, 
Maximum value is 9.0.  Note: beware of 
offsetting your plot off the page!
.RS
.IP Type: 10
float
.IP Default: 10
3.0 (inches)
.IP Example: 10
-imy 1.0 -- set the output postscript y-offset to 1".
.RE
.IP -imotype
Xprism2 offers vector output (1) or 
raster output (2).  Raster output is a screen dump of the 
workspace. Note if the plot contains annotations, rasteroutput must be used.
Default is (1).
.RS
.IP Type: 10
integer [1-2]
.IP Default: 10
1 (vector)
.IP Example: 10
-imotype 2 -- set output postscript to raster output.
.RE
.sp 2
.LP
****  Default Values for LN03 Output ***
.sp
.IP -ln03lp 10
Specify name of LN03 printer to be used.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-ln03lp laser -- set the printer name to "laser"
.RE
.IP -ln03file 10 
Specifies the name of output file for an LN03 output file.  
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-ln03file plot1.ln03 -- set the LN03 output filename to "plot1.in"
.RE
.IP -ln03invert 10
Indicates if a photonegative image is desired
on the hardcopy.  Default is ON, producing a
black plot on white background.  Turned OFF,
will give a white plot on a black background.
.RS
.IP Type: 10
logical
.IP Default: 10
1 (black on white)
.IP Example: 10
-ln03invert 0 -- sets the plot to be printed on a black background.
.RE
.sp 2
.LP
****  Default Values for HPGL Output ***
.sp
.IP -hpgllp 10
Specify name of HPGl printer to be used for output.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-hpgllp borris -- the HPGL printer is called "borris"
.RE
.IP -hpglfile 10
Specifies the name of output file for HPGL output of a workspace.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example
-hpglfile plot1.hpgl -- sets the output file for HPGL output of a workspace
to plot1.hpgl.
.RE
.IP -hpglflush 10
Indicates if the HPGL printer should
page or not.  Default is ON, so that printer
will page after each plot.  When turned off,
printer will NOT page, so it is possible to
overlay plots on top of one another.
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
1 (on)
.IP Example: 10
-hpglflush 0 -- sets it so that the printer will not page after each plot sent to
the printer.
.RE
.IP -hpgllandscape 10
Indicates whether or not the HPGl output should be printed in landscape
mode or in document mode. The default is OFF document mode.
.RS
.IP Type: 10
logical [0-1]
.IP Default: 10
0 (off)
.IP Example:
-hpgllandscape 1 -- sets the HPGL output to print in landscape mode.
.RE
.IP -hpglw 10
Specify width of printed plot, in inches.
Default is 7 inches.  Minimum value is 1.0,
Maximum value is 11.0.  
.RS
.IP Type: 10
float
.IP Defaults: 10
7 (inches)
.IP Example: 10
-hpglw 5.0 -- sets the output HPGL plot width to 5 inches.
.RE
.IP -hpglh 10
Specify height of printed plot, in inches.
Default is 7 inches.  Minimum value is 1.0,
Maximum value is 11.0.
.RS
.IP Type: 10
float
.IP Defaults: 10
7 (inches)
.IP Example: 10
-hpglh 5.0 -- set the output HPGL plot height to 5".
.RE
.IP -hpglx 10
Specify X offset of printed plot on the page, 
in inches, from the upper left hand corner.  
Default is 1 inch.  Minimum value is 0.0, 
Maximum value is 7.0.  Note: beware of 
offsetting your plot off the page!
.RS
.IP Type: 10
float
.IP Default: 10
1.0 (inches)
.IP Example: 10
-hpglx 1.0 -- set the output HPGL x-offset to 1".
.RE
.IP -hpgly 10
Specify Y offset of printed plot on the page, 
in inches, from the upper left hand corner.  
Default is 3 inches.  Minimum value is 0.0, 
Maximum value is 9.0.  Note: beware of 
offsetting your plot off the page!
.RS
.IP Type: 10
float
.IP Default: 10
3.0 (inches)
.IP Example: 10
-hpgly 1.0 -- set the output HPGL y-offset to 1".
.RE
.sp 2
.LP
****  Annotation Files  ***
.sp
.IP -anin 10
Because of the variety and unlimited number
of potentially desired annotations, annotations
are not available individually from the 
command line.  However, if one has an
annotation ascii file saved
it may be automatically read in from the 
command line.  If any [-i&*] or [-func&*] input
plots are specified, the annotations will appear
immediately, over the plot(s).  
NOTE: when using the [-anin] flag,
note that the file specified MUST exist in 
the Global Input directory specified by 
the [-indir] flag.  If it does not, the 
filename must be prefaced by "\."
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-anin ~khoros/data/annotation/sample.ov -- loads the annotations from the specifiec file.
.RE
.IP -anout 10
Specifies the name of output file for an annotataion file.
.RS
.IP Type: 10
string
.IP Default: 10
none
.IP Example: 10
-anout ./annotaions.out -- sets the xprism form to have the output 
annotations file as specified.
.RE
.RE
