
XPRISM2(INPUT_FILE)          Khoros           XPRISM2(INPUT_FILE)

     OVERVIEW

     Plots are input and displayed using the "Input File" pane of
     the "Plot" subform.  The first plot to be created and
     displayed causes the graphics workspace to be created. The
     plot is drawn in the Black workspace area.

     More than one plot may be displayed in the same window;
     each time the user fills in the "filename" parameter and
     clicks on "Plot File", the new plot will be added to the
     graphics workspace. Plots may be hidden using the "HIDE"
     action button on the guide pane of the main Xprism2 form, or
     deleted using the "DELETE" action button.  Until the graph-
     ics workspace is destroyed using the "CLEAR" action button,
     each new plot will continue to be added to the existing
     graphics workspace.

     Twenty (20) plots may be displayed in a workspace; however,
     for readability, five (5) is the recommended limit.  If one
     has access to a color workstation, it is much easier to dis-
     tinguish plots from each other than if one is working on a
     monochrome workstation.

     The following list describes the options available on the
     "Input File" pane.

     Filename
          The file to be plotted must be specified in the
          Filename parameter box.  To used the file browser to
          find/select a file, click the mouse in the word
          "Filename" on the pane.  The following file types may
          be used as input:

          VIFF Image Files    image files created by Khoros

          Ascii Files         2D data points entered into an
                              Ascii File.

          Raw Data Files      raw data files created from a pro-
                              gram or application.

          Functions           function definitions stored in an
                              Ascii File.

     Points to Be Displayed

          The option labeled "Points to be Displayed" allows the
          user to window on a specified portion of the data. In
          addition to windowing, the user may also subsample the
          data to be displayed. All data is read in when the
          "Plot File" button is clicked with the mouse; the
          "Points to be Displayed" option works on that data.
          Once plotted, the window and subsampling parameters may
          be changed for each currently displayed plot using the
          "Attributes" subform. The "Points to be Displayed"
          option has three items that can be changed. The follow-
          ing explains these options:

          Step Size
               This "Step Size" option specifies how the data
               should be subsampled between the begin point and
               the end point. The default value is 1; ie, every
               point is used.

          Begin Point
               The "Begin Point" specifies 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.

          End Point
               The "End Point" specifies 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.

     Plot Type

          Each plot that is input will be displayed as the plot
          type that is indicated by the "plot type" toggle in the
          "Input File" pane.  Thus, by changing the plot type
          before each new plot is displayed, any of the five plot
          types may be displayed simultaneously in the graphics
          workspace.

     Data Format

          Data format is only used when the input file is an
          Ascii data file or a Raw data file. Two formats can be
          specified, XY Pairs or Y Only. In he case of Y Only
          data, the X values are generated starting at 0.

     Raw Data Type

          Raw Data Type is only used with raw data files. This
          specifies the data type of how the data is stored.

     Raw Data Machine Type

          Raw Data Machine Type specifies the machine type that
          the data was originally created on. If the byte order-
          ing of the data is different than the machine running
          Xprism2 on, the data will be converted.

     See the associated HELP for each of the file types for more
     detailed information.

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

Khoros                    Release: 1.0                          1

