
XPRISM2(HELP)                Khoros                 XPRISM2(HELP)

     Starting Up Xprism2

     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:

     % xprism2

     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 com-
     mand line parameters specified.

     Command Line Arguments

     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.

     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:

          &         [Plot area number] Only 1 plot area is
                    currently available.

          *         [File number | plot number] Ranges from 1-20;

          -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.

          -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).

          -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).

          -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).

          -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)

     Spacing must be exactly as shown; if two symbols are
     directly adjacent to each other, then so should be their
     corresponding values.

     Usage

          % xprism2

          ****  General flags ****

          [-fn]     Specifies the font for xprism2

          [-V]      Gives the version for xprism2

          [-U]      Gives the usage for xprism2

          [-P]      Prompts for a subset of all the possible
                    arguments

          [-A [file1]]
                    Creates the answer file called xprism2.ans or
                    file1

          [-a [file1]]
                    Uses xprism2.ans or file1 as the answer file

          ****  Alternate User Interface Description File ***

          -form     Specify an alternate user interface descrip-
                    tion 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.

                    Type:     string

                    Default:  $KHOROS_HOME/repos/xprism/xprism2.form

                    Example:  -form ~dargiro/forms/xprism2.form

          *** Workspace Number of Areas and Plots ***

          -na  Specify the number of plot areas for the
               workspace. Currently xprism2 only supports 1 plot
               area.

               Type:     integer [0-1]

               Default:  1 (1 plot area)

               Example:  -na 1 -- sets the number of plot areas
                         in the workspace to 1.

          -np&      Specify the number of plots in a plot area.
                    The maximun number of plots per area is 20.

                    Type:     integer [1-20]

                    Default:  1 (1 plot)

                    Example:  -np1 5 -- sets plot area #1 to
                              accept 5 plot specifications from
                              the command line.

          ****  Input from Files or Functions  ****

          -i&*      Specify a single plot, with data originating
                    in an input file.  This file may be an expli-
                    cit or implicit image file, ascii file with a
                    function, an ascii file of data points, or a
                    raw data file.

                    Type:     string

                    Default:  none

                    Example:  -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.

          -func&*   Specify a single plot, with data originating
                    from the supplied function.  For more infor-
                    mation 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.

                    Type:     string

                    Default:  none

                    Example:   -func11 "sin(x)" - This will plot
                              the function sin(x) in plot area #1
                              as plot #1.

          ****  Data Format, Data Type, Machine Type ***

          -df[&][*] 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.

                    Type:     integer [1-2]

                    Default:  1 (XY Pairs)

                    Example:  -df1 2 -- set the data format to be
                              Y data Only for plot area #1
                              -df 1 -- sets to data format to be
                              XY PAIRS for all plots in all plot
                              areas.

          -dt[&][*] 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 argu-
                    ment are: 1 = Byte, 2 = Integer, 3 = Integer,
                    and 4 = Float. This option is only valid if
                    the data is RAW, otherwise it is ignored.

                    Type:     integer [1-4]

                    Default:  4 (float)

                    Example:  -dt 3 -- sets the data type for all
                              plot areas to short.
                              -dt12 3 -- sets the data type for
                              plot area #1, plot #2 to short.

          -mach[&][*]
                    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.

                    Type:     integer

                    Default:  (current machine)

                    Example:  -mach1 2 -- Sets the machine type
                              to "Dec 3100/2100" for plot area
                              #1.
                              -mach11 9 -- Sets the machine type
                              to "Sun 3,  Sun 4, SunSparc" for
                              plot area #1, plot #1.

          ****  Viff Image Data Band and Complex Type ***

          -band[&][*]
                    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.

                    Type:     integer

                    Default:  0 (first data band)

                    Example:  -band1 2 -- plot data band number 2
                              (the third data band) for plot area
                              1.
                              -band 1 -- plot data band number 1
                              (the second data band) for all
                              plots.

          -cmplx[&][*]
                    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 com-
                    plex plot types are:
                            Real Part: 1       Imaginary Part: 2
                            Magnitude: 3       Phase: 4

                    Type:     integer [1-4]

                    Default:  1 (Real Part)

                    Example:  -cmplx1 4 -- plot the phase com-
                              puted from the complex image for
                              area 1.
                              -cmplx11 2 -- plot the imaginary
                              part for plot 1 in area 1.

          **** Range and Number of Points for Functions ***

          -fxmin[&][*]
                    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.

                    Type:     string

                    Default:  (-1.0)

                    Example:  -fxmin -pi --  sets x function
                              minimum to -3.1415 for all plots
                              and plot areas.
                              -fxmin1 -3.1415 -- sets x function
                              minimum to -3.1415 for plot area #1
                              -fxmin11 pi -- sets x function
                              minimum to 3.1415 for plot area #1
                              plot #1

          -fxmax[&][*]
                    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.

                    Type:
                         string

                    Default:  (1.0)

                    Example:  -fxmax  3.1415 -- sets x function
                              maximum to 3.1415 for all plots and
                              plot areas.

          -fpts[&][*]
                    The number of points to be evaluated for the
                    -func option over the [fxmin -- fxmax]
                    range.

                    Type:
                         string

                    Default:  40 points.

                    Example:  -fpts11 10 - sets the number of
                              points to be plotted by the -func11
                              (plot area #1, plot #1) to 10.

          ****  Plot  Type  Options ***

          -pt[&][*]:
          Specify the plot type.  Valid options for the plot type
          are: 1 = 2D, 2 = Discrete, 3 = Bargraph
          4 = Polymarker, 5 = Linemarker

          Type:     integer [1-5]

          Default:  1 (2d)

          Example:  -pt 2 -- set all plots in all areas to
                    Discrete.
                    -pt1 2 -- set all plots in plot area #1 to
                    Discrete.

          -mt[&][*] 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 repeat-
                    ing marker types starting at 1. Valid Options
                    for marker types are:

                       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

                    Type:     integer [1-15]

                    Default:  1 (square)

                    Example:  -mt11 11 -- set plot #1 in area #1
                              to marker type of dot.
                              -mt 10 -- set all plots in all
                              areas to have a marker type of X.

          -lt[&][*] 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 Line-
                    marker or Polymarker plot will have NO
                    effect.  This is because Linemarker and Poly-
                    marker 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:

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

                    Type:     integer [1-6]

                    Default:  1 (solid)

                    Example:  -lt 5 -- set the line tyle for all
                              plots in all areas to Long-Dashed

          ****  Plot Viewing Options ***

          -legend[&]
                    Specify whether or not the legend is showing.

                    Type:     logical [0-1]

                    Default:  1 (showing)

                    Example:  -legend 0 -- sets the plot legend
                              to not showing for all plot areas.
                              -legend1 0 -- sets the plot legend
                              to not showing for plot area #1.

          -box[&]   Specify whether or not the plot will contain
                    a box around it. This actually puts an axis
                    on all four sides of the plot.

                    Type:     logical [0-1]

                    Default:  0 (not boxed)

                    Example:  -box 1 -- sets the box to showing
                              for all plot areas.
                              -box1 0 -- sets the box to showing
                              for plot area #1.

          -numlabels[&]
                    Specify whether or not the numberical labels
                    on the x and y axes are showing.

                    Type:     logical [0-1]

                    Default:  1 (showing)

                    Example:  -numlabels 0 -- sets the numerical
                              labels on the x and y axes to not
                              showing for all plot areas.
                              -numlabels1 0 -- sets the numerical
                              labels on the x and y axes to not
                              showing for plot area #1.

          -axes[&]  Specify whether or not the x and y axis lines
                    are showing.

                    Type:     logical [0-1]

                    Default:  1 (showing)

                    Example:  -axes 0 -- sets the plot x and y
                              axis lines to not showing for all
                              plot areas.
                              -axes1 0 -- sets the plot sets the
                              x and y axis lines to not showing
                              for plot area #1.

          -grid[&]  Specify whether or not the plot grid is show-
                    ing.

                    Type:     logical [0-1]

                    Default:  0 (not showing)

                    Example:  -grid 1 -- sets the plot grid to
                              showing for all plot areas.
                              -grid1 1 -- sets the plot grid to
                              showing for plot area #1.

          -autoscale[&]
                    Specify whether or not the axes are labeled
                    "nice". This uses a hieristic algorithm to
                    compute the axes minimum, maximum and inter-
                    val values based on the give data. This is
                    used to make the axes labeling look "nice".

                    Type:     logical [0-1]

                    Default:  0 (autoscale off)

                    Example:  -autoscale 1 -- sets autoscale to
                              on for all plot areas.
                              -autoscale1 1 -- sets autoscale to
                              on for plot area #1.

          -clrls[&] Specify whether or not the all plot labels
                    are to be showing or not.  This effects the
                    title and x and y axis labels.

                    Type:     logical [0-1]

                    Default:  0 (do not clear lables)

                    Example:  -clrls 0 -- the plot labels will
                              not be showing for all plot areas.
                              -clrls1 0 -- the plot labels will
                              not be showing for plot area #1.

          -rsrl[&]  Specify whether or not the axes are in res-
                    cale (1) mode or relabel (2) mode. When in
                    relabel mode the axes are labeled as speci-
                    fied by the -xlmin, -xlmax, -xlint, -ylmin,
                    -ylmax and -ylint arguments.

                    Type:     integer [1-2]

                    Default:  1 (rescale)

                    Example:  -rsls 0 -- sets the axes to be
                              relabeled for all plot areas.
                              -rsls1 0 -- sets the axes to be
                              relabeled for plot area #1

          -xtics[&] Specify the number of minor inteval lines
                    between each major interval on the X-axis.

                    Type:     integer [0-20]

                    Default:  0 (no minor interval lines showing)

                    Example:  -xtics 5 -- sets all plots in all
                              areas to have 5 minor interval
                              lines between each major interval
                              on the X-axis.
                              -xtics1 5 -- sets area #1's X-axis
                              to have 5 minor interval lines
                              between each major interval.

          -ytics[&] Specify the number of minor inteval lines
                    between each major interval on the Y-axis.

                    Type:     integer [0-20]

                    Default:  0 (no minor interval lines showing)

                    Example:  -ytics 5 -- sets all plots in all
                              areas to have 5 minor interval
                              lines between each major interval
                              on the Y-axis.
                              -ytics1 5 -- sets area #1's Y-axis
                              to have 5 minor interval lines
                              between each major interval.

          -active[&][*]
                    Specify whether or not the plot should be
                    drawn or is active.

                    Type:     logical [0-1]

                    Default:  1 (active)

                    Example:  -active 0 -- sets all plots in all
                              areas not to be drawn.
                              -active1 0 -- sets all plots in
                              area #1 not to be drawn.
                              -active12 0 -- sets plot #2 in area
                              #1 not to be drawn.

          **** Plot Axes Values ***

          -xsmin[&] 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.

                    Type:     float

                    Default:  Plot area's data minimum value.

                    Example:  -xsmin -1.0 -- sets all plot areas
                              X-axis minimum value to -1.0.
                              -xsmin1 -1.0 -- sets plot area #1
                              X-axis minimum value to -1.0.

          -xsmax[&] 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.

                    Type:     float

                    Default:  Plot area's data maximum value.

                    Example:  -xsmax 1.0 -- sets all plot areas
                              X-axis maximum value to 1.0.
                              -xsmax1 1.0 -- sets plot area #1
                              X-axis maximum value to 1.0.

          -xsint[&] 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.

                    Type:     float

                    Default:  some "nice" value

                    Example:  -xsint 1.0 -- sets all plot areas
                              X-axis major interval value to 1.0.
                              -xsmin1 -1.0 -- sets plot area #1
                              X-axis major interval value to 1.0.

          -xlmin[&] 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.

                    Type:     float

                    Default:  the current minimum value

                    Example:  -xlmin -1000.0 -- sets all plot
                              areas X-axis labeled minimum value
                              to -1000.0.
                              -xlmin1 1.0 -- sets plot area #1
                              X-axis labeled minimum value to
                              1.0.

          -xlmax[&] 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.

                    Type:     float

                    Default:  the current maximum value

                    Example:  -xlmax 1000.0 -- sets all plot
                              areas X-axis labeled maximum value
                              to 1000.0.
                              -xlmax1 1000.0 -- sets plot area #1
                              X-axis labeled maximum value to
                              1000.0.

          -xlint[&] 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 argu-
                    ments. If this argument is specifed, the
                    -xlmax  and -xlmin arguments must also be
                    specified.

                    Type:     float

                    Default:  the current interval value

                    Example:  -xlint 1.0 -- sets all plot areas
                              X-axis labeled major interval value
                              to 1.0.
                              -xlmin1 -1.0 -- sets plot area #1
                              X-axis labeled major interval value
                              to 1.0.

          -ysmin[&] 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.

                    Type:     float

                    Default:  Plot area's data minimum value.

                    Example:  -ysmin -1.0 -- sets all plot areas
                              Y-axis minimum value to -1.0.
                              -ysmin1 -1.0 -- sets plot area #1
                              Y-axis minimum value to -1.0.

          -ysmax[&] 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.

                    Type:     float

                    Default:  Plot area's data maximum value.

                    Example:  -ysmax 1.0 -- sets all plot areas
                              Y-axis maximum value to 1.0.
                              -ysmax1 1.0 -- sets plot area #1
                              Y-axis maximum value to 1.0.

          -ysint[&] 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.

                    Type:     float

                    Default:  some "nice" value

                    Example:  -ysint 1.0 -- sets all plot areas
                              Y-axis major interval value to 1.0.
                              -ysmin1 -1.0 -- sets plot area #1
                              Y-axis major interval value to 1.0.

          -ylmin[&] 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.

                    Type:     float

                    Default:  the current minimum value

                    Example:  -ylmin -1000.0 -- sets all plot
                              areas Y-axis labeled minimum value
                              to -1000.0.
                              -ylmin1 1.0 -- sets plot area #1
                              Y-axis labeled minimum value to
                              1.0.

          -ylmax[&] 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.

                    Type:     float

                    Default:  the current maximum value

                    Example:  -ylmax 1000.0 -- sets all plot
                              areas Y-axis labeled maximum value
                              to 1000.0.
                              -ylmax1 1000.0 -- sets plot area #1
                              Y-axis labeled maximum value to
                              1000.0.

Version: 0                 Release: 1                           1

XPRISM2(HELP)                Khoros                 XPRISM2(HELP)

          -ylint[&] 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 argu-
                    ments. If this argument is specifed, the
                    -ylmax  and -ylmin arguments must also be
                    specified.

                    Type:     float

                    Default:  the current interval value

                    Example:  -ylint 1.0 -- sets all plot areas
                              Y-axis labeled major interval value
                              to 1.0.
                              -ylmin1 -1.0 -- sets plot area #1
                              Y-axis labeled major interval value
                              to 1.0.

          ****  Plot Data Windowing and Sampling ***

          -xb[&][*] 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.

                    Type:     integer

                    Default:  0 (all data points)

                    Example:  -xb 10 -- sets all plot data in all
                              areas to start with the 10th data
                              point.
                              -xb11 10 -- sets plot #1's data in
                              area #1 to start with the 10th data
                              point.

          -xe[&][*] 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.

                    Type:     integer

                    Default:  0 (the last data point)

                    Example:  -xe 20 -- sets all plot data in all
                              areas to end with data point number
                              20.
                              -xe11 20 -- sets plot #1's data in
                              area #1 to end with data point
                              number 20.

          -xs[&][*] 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.

                    Type:     integer

                    Default:  1 (every data point)

                    Example:  -xs 2 -- sets all plot data in all
                              areas to skip every other point
                              before displaying.
                              -xs11 2 -- sets plot #1's data in
                              area #1 to skip every other point
                              before displaying.

          ****  Plot  Labels  ***

          -title[&] Specify string for title of plot.

                    Type:     sting

                    Default:  "Xprism2 Plot"

                    Example:  -title "Frequency_Plot" -- sets the
                              plot title to that specified for
                              all plot areas.
                              -title1 "Frequency_Plot" -- sets
                              the plot title to that specified
                              for plot area #1.

          -xaxis[&] Specify string for the label on the X-axis.

                    Type:     sting

                    Default:  "X-Axis"

                    Example:  -xaxis "Time" -- sets the plot X-
                              axis label to that specified for
                              all plot areas.
                              -xaxis1 "Time" -- sets the plot X-
                              axis label to that specified for
                              plot area #1.

          -yaxis[&] Specify string for the label on the Y-axis.

                    Type:     sting

                    Default:  "Y-Axis"

                    Example:  -yaxis "Response" -- sets the plot
                              Y-axis label to that specified for
                              all plot areas.
                              -yaxis1 "Response" -- sets the plot
                              Y-axis label to that specified for
                              plot area #1.

          -legendstr[&][*]
                    Specify the legend label for a plot.

                    Type:     string

                    Default:  plot #

                    Example:  -legendstr11 "sin wave" -- sets the
                              legend label to "sin wave" for plot
                              #1 in area #1.
                              -legendstr12 "cos wave" -- sets the
                              legend label to "cos wave" for plot
                              #2 in area #1.

          ****  Color Options ***

          Available Colors For The Plot Arguments
                    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),

                        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

                    NOTE, specifying colors on a monochrome moni-
                    tor has no effect. Specifying colors on a
                    display of less than 256 colors may or may
                    not be available for use.

          -pc[&][*] 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).

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -pc11 18 -- sets the plot color to
                              Red for plot #1 in area #1.
                              -pc 18 -- sets all plots in all
                              areas to Red.

          -color[&] Specify the color for all axes, grid, box,
                    and labels. This is a master argument for
                    setting the color.

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -color 18 -- sets the "global"
                              color to Red for all plot areas.
                              -color1 18 -- sets the "global"
                              color to Red for plot area #1.

          -tc[&]    Specify the color for plot title.

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -tc 18 -- sets the title color to
                              Red for all plot areas.
                              -tc1 18 -- sets the title color to
                              Red for plot area #1.

          -xalc[&]  Specify the color for the x-axis labels.

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -xalc 18 -- sets the x-axis label
                              color to Red for all plot areas.
                              -xalc1 18 -- sets the x-axis label
                              color to Red for plot area #1.

          -yalc[&]  Specify the color for the y-axis label.

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -yalc 18 -- sets the y-axis label
                              color to Red for all plot areas.
                              -yalc1 18 -- sets the y-axis label
                              color to Red for plot area #1.

          -xac[&]   Specify the color for x-axis line.

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -xac 18 -- sets the x-axis line
                              color to Red for all plot areas.
                              -xac1 18 -- sets the x-axis line
                              title color to Red for plot area
                              #1.

          -yac[&]   Specify the color for the y-axis line.

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -yac 18 -- sets the y-axis line
                              color to Red for all plot areas.
                              -yac1 18 -- sets the y-axis line
                              color to Red for plot area #1.

          -nxac[&]  Specify the color for numerical labels on the
                    x-axis.

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -nxac 18 -- sets the x-axis numeri-
                              cal lables color to Red for all
                              plot areas.
                              -nxac1 18 -- sets the x-axis numer-
                              ical lables color to Red for plot
                              area #1.

          -nyac[&]  Specify the color for numerical labels on the
                    y-axis.

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -nyac 18 -- sets the y-axis numeri-
                              cal labels color to Red for all
                              plot areas.
                              -nyac1 18 -- sets the y-axis numer-
                              ical labels color to Red for plot
                              area #1.

          -gc[&]    Specify the color for plot grid.

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -gc 18 -- sets the grid color to
                              Red for all plot areas.
                              -gc1 18 -- sets the grid color to
                              Red for plot area #1.

          -lc[&]    Specify the color for plot legend.

                    Type:     integer [0-23]

                    Default:  0 (white)

                    Example:  -lc 18 -- sets the legend color to
                              Red for all plot areas.
                              -lc1 18 -- sets the legend color to
                              Red for plot area #1.

          *** Label Font Types ***

          Available fonts For The Plot Options
                    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).

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

          -font[&]  Specify font type for all text.  Default is
                    DoubleRoman.

                    Type:     integer [0-6]

                    Default:  0 (DoubleRoman)

                    Example:  -font 3 -- sets all the labels in
                              all areas to the TimesItalics font.
                              -font1 3 -- sets all the labels in
                              area #1 to the TimesItalics font.

          -xaf[&]   Specify font type for the X-axis label.
                    Default is DoubleRoman.

                    Type:     integer [0-6]

                    Default:  0 (DoubleRoman)

                    Example:  -xaf 3 -- sets the 's X-axis label
                              in all areas to the TimesItalics
                              font.
                              -xaf1 3 -- sets the X-axis label in
                              area #1 to the TimesItalics font.

          -yaf[&]   Specify font type for the Y-axis label.
                    Default is DoubleRoman.

                    Type:     integer [0-6]

                    Default:  0 (DoubleRoman)

                    Example:  -yaf 3 -- sets the Y-axis label in
                              all areas to the TimesItalics font.
                              -yaf1 3 -- sets the Y-axis label in
                              area #1 to the TimesItalics font.

          -numf[&]  Specify font type for the axes numerical
                    labels.  Default is DoubleRoman.

                    Type:     integer [0-6]

                    Default:  0 (DoubleRoman)

                    Example:  -numf 3 -- sets the numerical axes
                              labels in all areas to the TimesI-
                              talics font.
                              -numf1 3 -- sets numerical axes
                              labels in area #1 to the TimesItal-
                              ics font.

          -lf[&]    Specify font type for legend labels.  Default
                    is DoubleRoman.

                    Type:     integer [0-6]

                    Default:  0 (DoubleRoman)

                    Example:  -lf 3 -- sets the legend labels in
                              all areas to the TimesItalics font.
                              -lf1 3 -- sets the legend labels in
                              area #1 to the TimesItalics font.

          -tf[&]    Specify font type for the plot title. Default
                    is DoubleRoman.

                    Type:     integer [0-6]

                    Default:  0 (DoubleRoman)

                    Example:  -tf 3 -- sets the plot title in all
                              areas to the TimesItalics font.
                              -tf1 3 -- sets the plot title in
                              area #1 to the TimesItalics font.

          ****  Default Global Input and Ouput Directories ***

          -indir
               Secifies the global input directory to read files
               in from within xprism2.

               Type:     string

               Default:  none

               Example:  -indir /research/data/plots -- sets the
                         input global directory to the specified
                         file.

          -outdir
               Secifies the global output directory to write
               files to from within xprism2.

               Type:     string

               Default:  none

               Example:  -outdir /research/data/plots -- sets the
                         output global directory to the specified
                         file.

          ****  Default Output Answer File ***

          -outans
               Secifies the ouput file to write the answer file
               to from within xprism2.

               Type:     string

               Default:  none

               Example:  -outans /research/data/xprism2.ans --
                         sets the output answer file name to the
                         specified file in the xprism2 form.
                         file.

          ****  Default Filenames for VIFF Image Output Files ***

          -expifile Specifies the name of output file for an
                    explicit image file.

                    Type:     string

                    Default:  none

                    Example:  -expifile plot1.expl -- sets the
                              explicit image file to
                              ./plot1.expl.

          -impifile Specifies the name of output file for an
                    implicit image file.

                    Type:     string

                    Default:  none

                    Example:  -impifile plot1.impl -- sets the
                              implicit image file to
                              ./plot1.impl.

          -cmifile  Specifies the name of output file for a
                    Khoros VIFF file colormap.

                    Type:     string

                    Default:  none

                    Example:  -cmifile plot1.cm -- outputs the z
                              data values in th map of a Khoros
                              VIFF file.

          -sdumpfile
                    Specifies the name of output file for a VIFF
                    image screen dump file.

                    Type:     string

                    Default:  none

                    Example:  -sdumpfile screendump.xv -- sets
                              the screen dump file to
                              screendump.xv.

          ****  Default Values for Postscript Output ***

          -pslp     Specify name of Postscript printer to be used
                    for output.

                    Type:     string

                    Default:  none

                    Example:  -pslp borris -- the post-script
                              printer is called "borris"

          -psfile   Specifies the name of output file for
                    postscript output of a workspace.

                    Type:     string

                    Default:  none

                    Example   -psfile plot1.ps -- sets the output
                              file for postscript output of a
                              workspace to plot1.ps.

          -psflush  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.

                    Type:     logical [0-1]

                    Default:  1 (on)

                    Example:  -psflush 0 -- sets it so that the
                              printer will not page after each
                              plot sent to the printer.

          -psinvert 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.

                    Type:     logical [0-1]

                    Default:  1 (on)

                    Example:  -psinvert 0 -- Sets the postscript
                              output to be white plot on black
                              background.

          -pslandscape
                    Indicates whether or not the postscript out-
                    put should be printed in landscape mode or in
                    document mode. The default is OFF document
                    mode.

                    Type:     logical [0-1]

                    Default:  0 (off)

                    Example:  -pslandscape 1 -- sets the
                              postscript output to print in
                              landscape mode.

          -psmono   Indicates whether or not the postscript out-
                    put should be printed as a black and white or
                    color plot. The default is black and white.

                    Type:     logical [0-1]

                    Default:  1 (mono)

                    Example:  -psmono 0 -- sets the postscript
                              output to print color.

          -psw      Specify width of printed plot, in inches.
                    Default is 7 inches.  Minimum value is 1.0,
                    Maximum value is 11.0.

                    Type:     float

                    Defaults: 7 (inches)

                    Example:  -psw 5.0 -- sets the output
                              postscript plot width to 5 inches.

          -psh      Specify height of printed plot, in inches.
                    Default is 7 inches.  Minimum value is 1.0,
                    Maximum value is 11.0.

                    Type:     float

                    Defaults: 7 (inches)

                    Example:  -psh 5.0 -- set the output
                              postscript plot height to 5".

          -psx      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!

                    Type:     float

                    Default:  1.0 (inches)

                    Example:  -psx 1.0 -- set the output
                              postscript x-offset to 1".

          -psy      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!

                    Type:     float

                    Default:  3.0 (inches)

                    Example:  -psy 1.0 -- set the output
                              postscript y-offset to 1".

          -psotype  Xprism2 offers vector output (1) or raster
                    output (2).  Raster output is a screen dump
                    of the workspace.  Default is (1).

                    Type:     integer [1-2]

                    Default:  1 (vector)

                    Example:  -psotype 2 -- set output postscript
                              to raster output.

          ****  Default Values for Imagen Output ***

          -imlp     Specify name of Imagen printer to be used.

                    Type:     string

                    Default:  none

                    Example:  -imlp eelaser -- set the printer
                              name to "eelaser"

          -imfile   Specifies the name of output file for an
                    Impress output file.

                    Type:     string

                    Default:  none

                    Example:  -imfile plot1.im -- set the impress
                              output filename to "plot1.in"

          -imflush  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.

                    Type:     logical [0-1]

                    Default:  1 (page)

                    Example:  -imflush 0 -- set the printer to
                              not flush the page after a plot is
                              sent to it.

          -iminvert 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.

                    Type:     logical

                    Default:  1 (black on white)

                    Example:  -iminvert 0 -- sets the plot to be
                              printed on a black background.

          -imw      Specify width of printed plot, in inches.
                    Default is 7 inches.  Minimum value is 1.0,
                    Maximum value is 11.0.

                    Type:     float

                    Default:  7 (inches)

                    Example:  -imw 4.0 -- set the plot width to
                              4.0".

          -imh      Specify height of printed plot, in inches.
                    Default is 7 inches.  Minimum value is 1.0,
                    Maximum value is 11.0.

                    Type:     float

                    Defaults: 7 (inches)

                    Example:  -imh 5.0 -- set the output Impress
                              plot height to 5".

          -imx      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!

                    Type:     float

                    Default:  1.0 (inches)

                    Example:  -imx 1.0 -- set the output
                              postscript x-offset to 1".

          -imy      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!

                    Type:     float

                    Default:  3.0 (inches)

                    Example:  -imy 1.0 -- set the output
                              postscript y-offset to 1".

          -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).

                    Type:     integer [1-2]

                    Default:  1 (vector)

                    Example:  -imotype 2 -- set output postscript
                              to raster output.

          ****  Default Values for LN03 Output ***

          -ln03lp   Specify name of LN03 printer to be used.

                    Type:     string

                    Default:  none

                    Example:  -ln03lp laser -- set the printer
                              name to "laser"

          -ln03file Specifies the name of output file for an LN03
                    output file.

                    Type:     string

                    Default:  none

                    Example:  -ln03file plot1.ln03 -- set the
                              LN03 output filename to "plot1.in"

Version: 0                 Release: 1                           2

XPRISM2(HELP)                Khoros                 XPRISM2(HELP)

          -ln03invert
                    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.

                    Type:     logical

                    Default:  1 (black on white)

                    Example:  -ln03invert 0 -- sets the plot to
                              be printed on a black background.

          ****  Default Values for HPGL Output ***

          -hpgllp   Specify name of HPGl printer to be used for
                    output.

                    Type:     string

                    Default:  none

                    Example:  -hpgllp borris -- the HPGL printer
                              is called "borris"

          -hpglfile Specifies the name of output file for HPGL
                    output of a workspace.

                    Type:     string

                    Default:  none

                    Example   -hpglfile plot1.hpgl -- sets the
                              output file for HPGL output of a
                              workspace to plot1.hpgl.

          -hpglflush
                    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.

                    Type:     logical [0-1]

                    Default:  1 (on)

                    Example:  -hpglflush 0 -- sets it so that the
                              printer will not page after each
                              plot sent to the printer.

          -hpgllandscape
                    Indicates whether or not the HPGl output
                    should be printed in landscape mode or in
                    document mode. The default is OFF document
                    mode.

                    Type:     logical [0-1]

                    Default:  0 (off)

                    Example:  -hpgllandscape 1 -- sets the HPGL
                              output to print in landscape mode.

          -hpglw    Specify width of printed plot, in inches.
                    Default is 7 inches.  Minimum value is 1.0,
                    Maximum value is 11.0.

                    Type:     float

                    Defaults: 7 (inches)

                    Example:  -hpglw 5.0 -- sets the output HPGL
                              plot width to 5 inches.

          -hpglh    Specify height of printed plot, in inches.
                    Default is 7 inches.  Minimum value is 1.0,
                    Maximum value is 11.0.

                    Type:     float

                    Defaults: 7 (inches)

                    Example:  -hpglh 5.0 -- set the output HPGL
                              plot height to 5".

          -hpglx    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!

                    Type:     float

                    Default:  1.0 (inches)

                    Example:  -hpglx 1.0 -- set the output HPGL
                              x-offset to 1".

          -hpgly    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!

                    Type:     float

                    Default:  3.0 (inches)

                    Example:  -hpgly 1.0 -- set the output HPGL
                              y-offset to 1".

          ****  Annotation Files  ***

          -anin     Because of the variety and unlimited number
                    of potentially desired annotations, annota-
                    tions are not available individually from the
                    command line.  However, if one has an annota-
                    tion 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 "."

                    Type:     string

                    Default:  none

                    Example:  -anin
                              ~khoros/data/annotation/sample.ov
                              -- loads the annotations from the
                              specifiec file.

          -anout    Specifies the name of output file for an
                    annotataion file.

                    Type:     string

                    Default:  none

                    Example:  -anout ./annotaions.out -- sets the
                              xprism form to have the output
                              annotations file as specified.

     Copyright 1991, University of New Mexico. All rights
     reserved.

Version: 0                 Release: 1                           3

