home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 25 / CD_ASCQ_25_1095.iso / dos / educ / plotr73 / plotter.doc < prev    next >
Text File  |  1995-07-10  |  31KB  |  542 lines

  1.                             PLOTTER INSTRUCTIONS
  2.  
  3.      PLOTTER is a data plotting and evaluation program that can be run
  4.      on any PC/AT compatible computer with at least 640K bytes of RAM and
  5.      a standard CGA, EGA or VGA color monitor. Both Epson compatible and
  6.      HP LaserJet compatible printers are supported for hard copy. Screen
  7.      images of EGA and VGA plots can be saved to disk in PCX format for
  8.      importing to word processors. If a MOUSE is detected in the system,
  9.      it is automatically supported.
  10.  
  11.      If you want PLOTTER to load a data file at start-up time, you can
  12.      type PLOTTER FILENAME at the DOS prompt. The file will be read
  13.      as DATA FILE TYPE #1, and the program will start at the Options
  14.      Menu (see below). The DOS command line option makes it possible to
  15.      call PLOTTER from inside your own programs. For example, in BASIC
  16.      you would include the program line: SHELL "PLOTTER FILENAME".
  17.  
  18.      In general, default input responses are indicated by an asterisk
  19.      (*). Inputs that require key strokes not followed by RETURN are
  20.      indicated by square brackets []. Inputs that require RETURN to
  21.      complete the entry are indicated by parentheses (). You can back
  22.      out of most prompts in the program by pressing the ESCAPE key.
  23.  
  24.      The use of the MOUSE is intuitive throughout the program. Place
  25.      the MOUSE CURSOR on the item to be selected and click the LEFT
  26.      BUTTON. In general, the LEFT BUTTON is treated as a RETURN key
  27.      press, and the RIGHT BUTTON is treated as an ESCAPE key press.
  28.      You can use the MOUSE to answer single key prompts, such as [Y/*N]
  29.      or F2=LABEL, but most program inputs require use of the keyboard.
  30.  
  31.      For the menus in PLOTTER, you can use the UP and DOWN ARROW keys
  32.      to scroll through the items and press RETURN for your selection.
  33.      Or you can press the highlighted "hot key." To use your MOUSE,
  34.      place the CURSOR on the desired item and click the LEFT BUTTON.
  35.  
  36.      When you start PLOTTER you will see the Main Menu, consisting of
  37.      the following selections:
  38.  
  39.                          (R)ead Data File from Disk
  40.                          Create or (E)dit Data Files
  41.                          Change Plotter (S)etup
  42.                          (I)nstructions for Plotter
  43.                          Shell to D(O)S Environment
  44.                          (Q)uit the Program
  45.  
  46.      Press the (O) key to shell to DOS, and enter "exit" to return to
  47.      PLOTTER. Press (Q), ESCAPE, or the RIGHT MOUSE BUTTON to quit.
  48.  
  49.      Pressing (I) will let you read through the instructions for PLOTTER
  50.      contained in the ASCII text file PLOTTER.DOC (which is the document
  51.      you are presently reading). Use the UP and DOWN ARROW or PAGE keys
  52.      to move through the document. Place the MOUSE CURSOR on the top or
  53.      bottom border lines and click the LEFT BUTTON to scroll up or down 
  54.      one line, or place the MOUSE CURSOR on the ARROW ICONS and click the
  55.      LEFT BUTTON to move up or down one page. The (I)nstructions feature
  56.      requires PLOTTER.DOC to be in the default directory.
  57.  
  58.                          (R)ead Data File from Disk
  59.  
  60.      Use this option to read your data file(s) into PLOTTER. The program
  61.      can plot up to a total of 60,000 data values (for example, 30000 X-Y 
  62.      pairs in one data set). The path and file name(s) you enter will
  63.      become the default(s) for the current session of PLOTTER. The (R)ead
  64.      option prompts depend on which DATA FILE TYPE you have selected in
  65.      the (S)etup option. The default is DATA FILE TYPE #1.
  66.  
  67.      DATA FILE TYPE #1: You will be asked to "Enter the FILE NAME of your
  68.      DATA SET." Press ESCAPE, or click the RIGHT MOUSE BUTTON, to cancel
  69.      the (R)ead option. The number of columns in your data file, and the
  70.      length of the file, will be automatically determined as the data is
  71.      read. The program will then take you to the Options Menu (see below).
  72.  
  73.      DATA FILE TYPE #2: The first prompt is "Select NUMBER OF DATA FILES
  74.      to read:[ *1-9 ]." PLOTTER can read up to 9 separate data files,
  75.      each with different numbers of points and different X axis values.
  76.      You can press ESCAPE at this point to return to the Main Menu. You
  77.      are then asked to "Enter the FILE NAME of DATA SET # " for the
  78.      number of files you have selected. Press ESCAPE, or click the RIGHT
  79.      MOUSE BUTTON, to cancel and return to the Main Menu. When you are
  80.      done, the program will take you to the Options Menu (see below).
  81.  
  82.                          Create or (E)dit Data Files
  83.  
  84.      Use this option to manually create or edit small data files. You
  85.      will first be asked to "Enter the FILE name for your DATA SET."
  86.      Press ESCAPE, or the RIGHT MOUSE BUTTON, to cancel. If the requested 
  87.      file does not exist, you will be asked if you want to create it. You 
  88.      are then presented with the data editing screen.
  89.  
  90.      Use the MOUSE CURSOR to position the editing cursor, scroll the data
  91.      screen (by clicking on the ARROW ICONS or the BORDER LINES) and select
  92.      options from the bottom status bar. The editing keys are as follows:
  93.  
  94.              ARROW KEYS .......... MOVE CURSOR OR SCROLL DATA
  95.              PAGE UP/DN .......... PREVIOUS/NEXT SCREEN
  96.              HOME/END ............ START/END OF A LINE
  97.              CTRL-HOME/END ....... START/END OF THE FILE
  98.              INSERT .............. TOGGLE INSERT/TYPEOVER
  99.              ENTER ............... START A NEW LINE
  100.              TAB ................. INSERT OR TYPEOVER 5 SPACES
  101.              DEL/BACKSPACE ....... DELETE DATA AND LINES
  102.              CTRL-Y .............. CUT CURRENT LINE INTO BUFFER
  103.              SHIFT-INS ........... PASTE SINGLE LINE FROM BUFFER
  104.              CTRL-X .............. SORT DATA BY X AXIS VALUES
  105.              ESCAPE .............. SAVE FILE AND OPTIONALLY QUIT
  106.  
  107.      Enter your data according to the format shown below in the des-
  108.      cription of the Change Plotter (S)etup option. The data on each line
  109.      must be separated by AT LEAST ONE SPACE. Note that PLOTTER cannot
  110.      use more than 10 columns of data, and that the maximum file length
  111.      is about 1200 lines. Make sure that your data is entered correctly.
  112.      For example, DO NOT include commas or non-numerical characters.
  113.      Press ESCAPE, or click the RIGHT MOUSE BUTTON, to the quit editor.
  114.      You will then have the chance to save any changes you have made.
  115.      Finally, the program takes you to the Options Menu (see below).
  116.  
  117.                          Change Plotter (S)etup
  118.  
  119.      Use this option to change the default settings in PLOTTER. The new
  120.      settings will remain in effect while the current session of PLOTTER
  121.      is running. The first prompt is "Select DATA FILE TYPE to read:"
  122.      PLOTTER can read two different file formats, as shown below. The
  123.      program initially defaults to DATA FILE TYPE #1. Note that all data
  124.      files must have the data separated by AT LEAST ONE SPACE.
  125.  
  126.      DATA FILE TYPE #1: Plot up to 10 columns of data from one file.
  127.  
  128.      X1   Y11   Y12  ..  Y1m   Data columns have a common X axis and
  129.      X2   Y21   Y22  ..  Y2m   the same number of points. You can
  130.      :     :     :   ..   :    redefine the X axis column. Max size
  131.      Xn   Yn1   Yn2  ..  Ynm   for the data is 60,000 real values.
  132.  
  133.      DATA FILE TYPE #2: Plot up to 9 separate data files.
  134.  
  135.      X1   Y1
  136.      X2   Y2    Data sets can have different X axis values and numbers
  137.      :    :     of points. Max data size for ALL sets is 60,000 values.
  138.      Xn   Yn
  139.  
  140.      The next prompt is "Select [X]-Y or [S]EMI-LOG plot:" PLOTTER de-
  141.      faults to X-Y plots. Press [S] to plot the X axis values as BASE
  142.      10 LOGARITHMS. Semi-Log plots are useful for data whose X axis
  143.      values span a range from small decimals to large whole numbers.
  144.      Note that PLOTTER automatically reverts to the default X-Y plot
  145.      type when you select the Curve Fitting or Signal Processing Menus.
  146.  
  147.      The third prompt is "Show GRID LINES on plots?" You will auto-
  148.      matically get dashed grid lines on your plots indicating the
  149.      axis divisions. Press [N]o to get tick marks instead of lines.
  150.  
  151.      The final prompt is "Select maximum FFT size:" The (S)etup module
  152.      asks for the maximum FFT size, with the default being AUTO. Legal
  153.      FFT sizes for PLOTTER are integer powers of two: (256, 512, 1024,
  154.      2048, 4096, 8192, 16384). Entering the word AUTO causes the program
  155.      to select the largest FFT size that can fit your data size.
  156.  
  157.      After you have loaded your data, the Options Menu is presented:
  158.  
  159.                          (P)lot the Data Only
  160.                          (S)ignal Processing Menu
  161.                          (C)urve Fitting Menu
  162.                          Return to (M)ain Menu
  163.  
  164.      Press (M), ESCAPE, or click the RIGHT MOUSE BUTTON, to return to
  165.      the Main Menu. You can also press ESCAPE in answer to any prompt
  166.      described below to return to the Options Menu. NOTE: If you have a 
  167.      data file already loaded, and you Return to (M)ain Menu to review
  168.      the (I)nstructions or change the (S)etup, you will be returned to
  169.      the Options Menu so you can continue evaluating your data.
  170.  
  171.                          (P)lot the Data Only
  172.  
  173.      Use this option to plot your raw data. The option has slightly
  174.      different prompts for each DATA FILE TYPE.
  175.  
  176.      DATA FILE TYPE #1: You are first asked "Which COLUMN of DATA is the 
  177.      X AXIS?" The default selection is column 1. If you choose a different 
  178.      column, then all the curves will be plotted using that column as the 
  179.      common X axis. This is done by SWAPPING the current X axis column with 
  180.      the selected column while the plot is made. It is your responsibility 
  181.      to know the structure of your data so that you end up plotting the 
  182.      curves that you want. If your data file contains more than 2 columns
  183.      (X and Y), then you are asked "How many CURVES do you want to PLOT?"
  184.      The default is the total number of curves that were detected in your
  185.      data file. If you select less than the default number you are asked 
  186.      "PLOT which CURVE(S)?" Enter the column numbers you want to plot.
  187.  
  188.      DATA FILE TYPE #2: If you have read more than one data set, you are
  189.      first asked "How many CURVES do you want to PLOT?" The default is
  190.      the number of data files you have read. If you select less than the
  191.      default number then you are asked "PLOT which CURVE(S)?" Enter the
  192.      numbers of the data sets you want to plot. Recall that for this DATA 
  193.      FILE TYPE each curve can have a different X axis.
  194.  
  195.      You are then asked if the plot should "SHOW original DATA points?"
  196.      The default answer is [N]o. If you select [Y]es then small symbols
  197.      will be plotted indicating your original data. PLOTTER will pause
  198.      after showing the data points. Press ESCAPE, or the RIGHT MOUSE 
  199.      BUTTON, to leave the points unconnected. Press ANY OTHER KEY, or the 
  200.      LEFT MOUSE BUTTON, to connect the points with lines.
  201.  
  202.      If you are plotting just two curves, you will be asked "Do you want
  203.      a DUAL PLOT?" The default answer is [N]o. Selecting [Y]es will plot
  204.      the first curve on the upper half of the screen and the second curve
  205.      on the lower half of the screen. Press RETURN to continue plotting
  206.      your selected curves. After the last curve has been plotted, press
  207.      ESCAPE to return to the Options Menu. See the PLOTTING OPTIONS below
  208.      for details of the features available during plotting.
  209.  
  210.      The Signal Processing Menu consists of the following options:
  211.  
  212.                          Calculate (F)FT of the Data
  213.                          (D)igitally Filter the Data
  214.                          Return to (O)ptions Menu
  215.  
  216.      Press (O), ESCAPE, or click the RIGHT MOUSE BUTTON, to return to
  217.      the Options Menu. You can also press ESCAPE in answer to any of
  218.      the prompts below to return to the Signal Processing Menu.
  219.  
  220.                          Calculate (F)FT of the Data
  221.  
  222.      PLOTTER has a valuable feature that lets you evaluate the frequency
  223.      content of time domain data, for example from a data acquisition 
  224.      system, using the Fast Fourier Transform (FFT). At least 256 data 
  225.      values are required. Also, the X axis time data must be all positive, 
  226.      and must have a constant time step. Due to the numerical processing
  227.      required, the maximum FFT size for data files containing more than
  228.      20,000 pairs is 8192 points.
  229.  
  230.      If you have read more than one data set, you are asked "FFT which
  231.      DATA SET?" The default is set #1. If the size of your data set
  232.      is EXACTLY the size of a legal FFT window (256, 512, 1024, 2048,
  233.      4096, 8192 or 16384 points), then the program will prompt "Select
  234.      HANNING, FLAT TOP or RECTANGULAR window: [H/F/*R]" (see below).
  235.  
  236.      If the amount of data is not an even FFT size, you will be asked to
  237.      "Select START of TIME WINDOW for NMAX point FFT," where NMAX is the
  238.      currently selected FFT size. PLOTTER will automatically select the
  239.      largest FFT that will fit your data set, unless you have specified
  240.      the FFT size in the (S)etup module. This prompt lets you tell the
  241.      program where in your data set to locate the NMAX number of points
  242.      that will be sent to the FFT subroutine.
  243.  
  244.      The final prompt is "Select HANNING, FLAT TOP or RECTANGULAR window:
  245.      [H/F/*R]." The default answer is [R]ectangular, which is the same as
  246.      applying no window. The [H]anning window is used for identifying
  247.      closely spaced frequency components in the spectrum. The [F]lat Top
  248.      window produces magnitudes in the spectrum that more accurately
  249.      show the amplitudes of the components in the original time domain 
  250.      data. Consult a text on Digital Signal Processing for details.
  251.  
  252.      The time domain data is plotted on the upper half of the screen. Note 
  253.      that the F6=MATH option can be used to SMOOTH or SCALE the data in the 
  254.      window before computing the FFT (the original full data set is not 
  255.      affected). Press Q to quit without an FFT. Press RETURN to compute the 
  256.      FFT. The frequency spectrum is then plotted on the lower half of the 
  257.      screen. The PLOTTING OPTIONS are again available. Press ESCAPE, or
  258.      click the RIGHT MOUSE BUTTON, to quit the plot.
  259.  
  260.      Before you are returned to the Signal Processing Menu, you are
  261.      asked if you want to "Save FREQUENCY and MAGNITUDE values to disk?"
  262.      This allows you to store the spectrum that has just been computed.
  263.      The default answer is [N]o. If you select [Y]es, you will be asked
  264.      to "Enter a NAME for your FREQUENCY FILE." Press ESCAPE, or the
  265.      RIGHT MOUSE BUTTON, to cancel the file save option.
  266.  
  267.                          (D)igitally Filter the Data
  268.  
  269.      This feature lets you apply a LOW PASS, HIGH PASS or NOTCH filter
  270.      to your data set(s). Consult a text on Digital Signal Processing for
  271.      details. At least 256 data values are required for filtering. Also,
  272.      the X axis time data must be all positive and must have a constant
  273.      time step. Due to the numerical processing required, a maximum of
  274.      20000 Y axis data values can be filtered. If you have read more than 
  275.      one data set, you are asked "FILTER which DATA SET?" The default is 
  276.      set #1. The Filter Design Screen then appears.
  277.  
  278.      The first prompt is "Select LOW PASS, HIGH PASS or NOTCH FILTER:
  279.      [L/H/*N]." The default is a [N]OTCH filter, which can be used to
  280.      remove specific frequencies from your data.
  281.  
  282.      If you select a NOTCH filter, you will be asked to "Enter CENTER
  283.      FREQUENCY for the FILTER: (0 to FMAX Hz)" where FMAX is one half
  284.      of the sampling frequency detected in your data. This value is the
  285.      center of the frequency range where the filter will operate. You are
  286.      then asked to "Enter BANDWIDTH for the FILTER: (FRQ Hz)" where an
  287.      arbitrary default value, FRQ, is offered. This value defines the
  288.      frequency range over which the filter will operate. The NOTCH filter 
  289.      is a 2nd order INFINITE IMPULSE RESPONSE (IIR) filter.
  290.  
  291.      For a LOW or HIGH PASS filter, you are asked to "Enter CUTOFF
  292.      FREQUENCY for the FILTER: (0 to FMAX Hz)." This value determines
  293.      the range of frequencies to be passed. The next prompt is "Enter
  294.      the ORDER of the FILTER: (50)." This value determines the "rolloff"
  295.      characteristics of the filter. The PASS-type filters in PLOTTER are 
  296.      FINITE IMPULSE RESPONSE (FIR) filters, and use a VON HANN window to
  297.      compensate for amplitude loss. Note that your data can be filtered 
  298.      multiple times (allowing you to create, for example, a BAND PASS 
  299.      filter effect). However, be aware that LOW PASS digital filtering 
  300.      will NOT remove any ALIAS signals that are already in the data.
  301.  
  302.      After some processing time, you are presented with a frequency plot
  303.      showing the attenuation (in dB) of your filter. This lets you verify
  304.      that the filter will perform as expected. Press Q to quit without
  305.      implementing the filter, and return to the Signal Processing Menu.
  306.      Press ESCAPE to continue. After more processing, the filtered data
  307.      is plotted on the upper half of the screen. To let you evaluate the 
  308.      spectrum of the filtered data, an FFT is computed from the first NMAX 
  309.      points, where NMAX is the largest FFT size that can be fitted to the 
  310.      data. Press Q to quit without the FFT. Press RETURN to calculate the 
  311.      FFT and display the spectrum on the lower half of the screen. The 
  312.      PLOTTING OPTIONS are available for evaluating the plots.
  313.  
  314.      Before you are returned to the Signal Processing Menu, you are
  315.      asked if you want to "Save TIME and FILTERED DATA values to disk?"
  316.      The default answer is [N]o. If you select [Y]es, you will be asked
  317.      to "Enter a NAME for the FILTERED DATA FILE." Press ESCAPE, or click
  318.      the RIGHT MOUSE BUTTON, to cancel the file save option.
  319.  
  320.      The Curve Fitting Menu consists of the following options:
  321.  
  322.                          (C)ubic Spline Curve Fit
  323.                          (P)olynomial Curve Fit
  324.                          (A)utomatic Curve Fit
  325.                          Return to (O)ptions Menu
  326.  
  327.      Press (O), ESCAPE, or click the RIGHT MOUSE BUTTON, to return to
  328.      the Options Menu. You can also press ESCAPE in answer to any of
  329.      the prompts below to return to the Curve Fitting Menu.
  330.  
  331.      If you have read more than one data set, you are first asked "How
  332.      many CURVES do you want to FIT?" The default is the number of data
  333.      sets you have read. If you enter less than the default number,
  334.      you are asked "FIT which CURVE(S)?" You are then asked if the plot
  335.      should "SHOW original DATA points?" The default answer is [N]o. If
  336.      you select [Y]es then small symbols will be plotted indicating your
  337.      original data. PLOTTER will pause after showing the data points.
  338.      Press ESCAPE, or the RIGHT MOUSE BUTTON, to leave the points
  339.      unconnected. Press ANY OTHER KEY, or the LEFT MOUSE BUTTON, to
  340.      connect the points with the curve fit.
  341.  
  342.      If you have selected JUST ONE DATA SET for curve fitting, after the
  343.      plot of the curve fit has been presented you will be asked if you
  344.      want to "Save X and Y CURVE FIT values to disk?" The default answer
  345.      is [N]o. If you select [Y]es, you will be asked to "Enter a NAME for
  346.      the CURVE FIT DATA FILE." Press ESCAPE, or click the RIGHT MOUSE
  347.      BUTTON, to cancel the file save and return to the Curve Fitting Menu.
  348.  
  349.                          (C)ubic Spline Curve Fit
  350.  
  351.      This option will perform a CUBIC SPLINE curve fit of your data
  352.      set(s). The cubic splines will always pass through your original
  353.      data points. The most data that can be handled is 1000 points for
  354.      a single data set, or 500 points each for multiple data sets. Press
  355.      RETURN to continue plotting your selected curves. After the last
  356.      curve has been plotted, press ESCAPE to return to the Curve Fitting
  357.      Menu. Note that for this kind of curve fit, the F6=MATH option is
  358.      not available. This is because you can modify your original data
  359.      first, and then perform the curve fit. See the PLOTTING OPTIONS
  360.      below for details of the features available during plotting.
  361.  
  362.                          (P)olynomial Curve Fit
  363.  
  364.      This feature performs a least squares polynomial curve fit on your
  365.      data set(s). The most data that can be handled is 500 points per data
  366.      set. For each of the data sets you have selected, you will be asked
  367.      to "Enter the DEGREE for POLYNOMIAL #." Each data set can be fitted
  368.      with a different order polynomial. The legal range for the DEGREE
  369.      of each polynomial is from 1 to 19 (integer values).
  370.  
  371.      You can use the F6=MATH key to view the coefficients of the poly-
  372.      nomials for each data set (see the description of the PLOTTING
  373.      OPTIONS below). Press RETURN to continue plotting your selected
  374.      curves. After the last curve has been plotted, press ESCAPE, or the
  375.      RIGHT MOUSE BUTTON, to return to the Curve Fitting Menu.
  376.  
  377.                          (A)utomatic Curve Fit
  378.  
  379.      This option automatically selects the curve fit that best describes
  380.      your data set(s). The following three types of curves are used:
  381.  
  382.                         Linear:      Y = A + B * X
  383.                         Exponential: Y = A * EXP(B*X)
  384.                         Power:       Y = A * X^B
  385.  
  386.      The fit that produces the highest correlation coefficient (R^2) is
  387.      selected. The most data that can be handled is 500 points per data
  388.      set. Use the F6=MATH key during plotting to view the equation and
  389.      coefficients for the curve. For each of the selected data sets, the
  390.      best curve fit will be plotted. Press RETURN to continue plotting
  391.      your curves. After the last curve has been plotted, press ESCAPE, 
  392.      or the RIGHT MOUSE BUTTON, to return to the Curve Fitting Menu.
  393.  
  394.                             PLOTTING OPTIONS
  395.  
  396.      During plotting you can press Q to QUIT the plot screen and return
  397.      IMMEDIATELY to the previous menu. If you are plotting multiple
  398.      curves, press RETURN, or click the LEFT MOUSE BUTTON, to CONTINUE
  399.      with the next plot. After the last curve has been plotted, press
  400.      ESCAPE, or click the RIGHT MOUSE BUTTON, to QUIT the plotting screen
  401.      and return to the previous menu. You can also press the ESCAPE or
  402.      Q keys while a curve is being generated to stop the plotting.
  403.  
  404.      After each curve has been plotted, you will see a list of options
  405.      (F1 through F7) presented at the bottom of the screen. They can
  406.      be selected by the corresponding function key, or by positioning
  407.      the MOUSE CURSOR on the item and clicking the LEFT MOUSE BUTTON.
  408.      Each option contains a number of utilities.
  409.  
  410.      F1=LIMITS: You can select the upper and lower limits, and the
  411.      number of axis divisions, for both the X and Y axes. Press RETURN
  412.      alone to retain the current value. Note that you can select the
  413.      lower limits (XLOW or YLOW) to be greater than the upper limits
  414.      (XMAX or YMAX) if you so choose. If you are plotting multiple
  415.      curves, the plots will be regenerated starting at the first curve.
  416.  
  417.      F2=LABEL: This key activates one of the best features of PLOTTER.
  418.      It allows you to type ASCII text ANYWHERE on the plot screen. You
  419.      can type axis labels, plot titles, and identifying labels for your
  420.      curve(s). The cursor is originally placed above the upper left
  421.      corner of the plot. Use the ARROW keys, HOME, END, PAGE UP and PAGE
  422.      DOWN keys to move the cursor around, or you can use the MOUSE CURSOR
  423.      to position the text cursor by clicking the LEFT MOUSE BUTTON. Press
  424.      the ESCAPE key when you are done labeling. Note that the F1=LIMITS,
  425.      F3=REPLOT, F4=SINGLE and F6=MATH functions will redraw the plots and
  426.      wipe out your labels, so it's best to wait until you have the plot
  427.      just the way you like it before labeling.
  428.  
  429.      F3=REPLOT: This function acts like an "oops" key. It replots the
  430.      curve(s) with the plot limits reset to the original autoscaled
  431.      values. If you are plotting multiple curves, the plots will be
  432.      regenerated starting at the first curve.
  433.  
  434.      F4=SINGLE: If you are plotting multiple curves, or have a dual plot
  435.      (as in the FFT option), this key will plot the current curve on a
  436.      single plot of its own. If you are plotting a curve fit, the plot
  437.      will be autoscaled according to the maximum and minimum values in
  438.      the curve fit. Press ESCAPE to return to the multiple curve plot
  439.      (the plots will be regenerated beginning with the first curve).
  440.  
  441.      F5=CURSOR: The data cursor function allows you to examine the
  442.      numerical values in your data. The X and Y data values of the
  443.      current curve are printed below the lower left corner of the plot.
  444.      The LEFT and RIGHT ARROW keys move the cursor. Press CTRL-ARROW
  445.      keys for a faster cursor. Alternatively, you can drag the data
  446.      cursor by holding down the LEFT MOUSE BUTTON and moving the MOUSE.
  447.      If the cursor is near a LOCAL MAXIMUM in the data, selecting
  448.      F1=LOCAL MAX will make the cursor jump to that maximum. If the
  449.      cursor is near a LOCAL MINIMUM in the data, selecting F2=LOCAL
  450.      MIN will make the cursor jump to that minimum. Each time you select
  451.      F3=STORE, the current data values are appended to an ASCII data
  452.      file that is automatically created in the default directory. For
  453.      DATA FILE TYPE #1, the file name is the prefix of your data file
  454.      with a ".CSR" extension. For DATA FILE TYPE #2, the file name is
  455.      "PLOT.CSR". Press ESCAPE to quit the data CURSOR option.
  456.  
  457.      F6=MATH: This function provides several features. If you are
  458.      plotting (P)olynomial or (A)utomatic curve fits, you will be
  459.      shown the coefficients for the current curve (the plots will then
  460.      be regenerated beginning with the first curve). The other F6=MATH
  461.      options are not allowed for curve fits since you can modify the
  462.      data first, and then perform the curve fit. S=SMOOTH will smooth
  463.      the current data set by passing it once through a five point
  464.      approximation algorithm. Data smoothing can remove jagged peaks
  465.      often caused by signal noise. X=SCALE X AXIS and Y=SCALE Y AXIS
  466.      allow you to multiply the current data set by some scaling value.
  467.      This is especially useful for converting raw data (say volts) from
  468.      data acquisition systems to engineering units. You can also add
  469.      (or subtract) a constant offset to the data. If you are plotting
  470.      multiple curves, the plots will be regenerated starting at the
  471.      first curve. Press ESCAPE to quit the MATH option.
  472.  
  473.      F7=PRINT: This function allows you to generate hard copy of your
  474.      plots, and save EGA or VGA plot screens to disk in PCX format.
  475.      Any printers capable of emulating either an EPSON dot matrix or
  476.      a HEWLETT PACKARD LaserJet are supported for hard copy. Note that
  477.      many brands of printers can automatically emulate an EPSON printer
  478.      (the IBM laser printer is an example). The printer MUST be connected
  479.      to LPT1. The default options are H=HP LASERJET and L=LANDSCAPE.
  480.      Select H=HP LASERJET or E=EPSON to choose the printer you want (be
  481.      careful, since choosing the wrong type will cause garbage to be sent
  482.      to the printer). Select L=LANDSCAPE to print your plot sideways,
  483.      using the full paper size. Select P=PORTRAIT to print the plot
  484.      straight on using half of the paper size. When you are ready, and
  485.      the printer is turned on, select G=GO to print your plot. If you
  486.      want to save an EGA or VGA plot to disk, instead of printing, press
  487.      X=PCX. Your PCX files will be saved in the default directory with
  488.      names of the form PLOT#.PCX, where # is a number that is incremented
  489.      each time you save a screen (while the current session of PLOTTER is
  490.      running). Many word processors can import PCX files as figures into
  491.      documents. The prompt line at the bottom of the screen and the MOUSE
  492.      CURSOR are automatically blanked while the plot is being sent to the
  493.      printer or to disk. Press ESCAPE to quit the PRINT option.
  494.  
  495.      Q: You are not prompted for this key, but pressing Q will quit the
  496.      plot screen and return IMMEDIATELY to the previous menu. Also, you
  497.      can press Q as a curve is being generated to stop the plotting.
  498.  
  499.      RET=CONTINUE: This prompt is displayed in the lower right corner
  500.      of the plot screen. When you are plotting multiple curves, press
  501.      RETURN to continue to the next plot. After the last curve has been
  502.      plotted, the RET=CONTINUE prompt is replaced with the ESCAPE=QUIT
  503.      prompt. This keeps you from accidentally pressing RETURN too many
  504.      times and quitting the plot screen before you are ready. Recall
  505.      also that the LEFT MOUSE BUTTON is treated as a RETURN key press.
  506.  
  507.      ESCAPE=QUIT: This prompt is also displayed in the lower right
  508.      corner of the screen. The ESCAPE key is the principal means of
  509.      quitting each of the options described above. Press ESCAPE after
  510.      the last curve has been plotted to quit the plot screen and return
  511.      to the previous menu. Recall that, in general, the RIGHT MOUSE
  512.      BUTTON is treated as ESCAPE. Also, you can press ESCAPE when a 
  513.      curve is being generated to stop the plotting.
  514.  
  515.      SPACE: You can press SPACE to mask the prompt line on the bottom of
  516.      the plot screen. This is useful if you want to use screen grabbing
  517.      software to import the plots into a word processor. You can hide
  518.      the MOUSE CURSOR by moving it to the far right side of the screen.
  519.  
  520.                                  SHAREWARE
  521.  
  522.      PLOTTER is distributed as Shareware. Feel free to share the program
  523.      and its files with others. However, if you continue to use PLOTTER,
  524.      you must register the program by sending $15.00 US to:
  525.  
  526.                          Robert Lindsay Wells, Ph.D.
  527.                          1405 Lynn Avenue
  528.                          Clearwater, FL 34615
  529.  
  530.      When you register, you will receive the latest version of PLOTTER,
  531.      a free instruction manual, and three months of technical support by 
  532.      telephone or E-Mail. Please register today!
  533.  
  534.                  AND FINALLY ... THE INEVITABLE DISCLAIMER
  535.  
  536.      Although all reasonable efforts have been made to ensure the
  537.      accuracy of the algorithms used in PLOTTER, the author of this
  538.      software makes no guarantee of, and takes no responsibility for,
  539.      the correctness of the plots or the data presented by PLOTTER.
  540.      Any decisions or judgements made by the user based on the plots or
  541.      data output by PLOTTER are solely the responsibility of the user.
  542.