1 XPLOT
 XPLOT is a PPL program that lets you view a plot file on your terminal.
 Examples:
       $ XPLOT PLOTS.PLT
            or
       [$ DEFINE PLOT PLOTS.PLT  ]
       $ XPLOT
            or
       $ XPLOT PLOT/F=n
            or
       $ XPLOT PLOTS.PLT/T="text"
            or
       $ XPLOT/NOQ PLOTS.PLT

2 Unix

  For PPPL users: xplot is in $NTCCHOME/bin/
  ==============

  Set the environment variable PLOT

  To route plot output to your terminal:
        > unsetenv PLOT

  To route all plot output to the file "file.plt":
        > setenv PLOT file.plt

  To display plots on your terminal and save only those pages in the
  file "file.plt" where you type a "D" (or "d") at the beep:
        > setenv PLOT ",file.plt"

  To view the plots in "file.plt" on your terminal, if you have set PLOT
  to "file.plt" or ",file.plt":
        > xplot

  To view the plots in "file.plt" if you haven't set PLOT:
        > xplot file.plt

2 Command_Line
 The argument is the name of an existing plot file or a logical variable
 that translates to the file name.  The optional /F=n switch tells XPLOT
 to start at frame n; the /T=...  switch selects the first frame that
 contains that text string.  If there is no switch on the input file,
 XPLOT starts with the first plot frame in the file.

 Once the file is open, you can view the frames sequentially by typing a
 return at each beep, or skip around (see the Browsing section).  The
 "noquery" switch (/NOQ) causes XPLOT to exit when it reaches the end of
 the file.  The default is to ask you whether you want to go to another
 frame or exit.
2 Frame_Selection
 The frame select options to XPLOT are:
       filespec/F=n        !select the nth frame
       filespec/T="text"   !first frame with the string "text"

 The "text" to be matched can be any substring of a label (horizontal or
 vertical) or title in the plot.  The match must be exact, including
 upper vs lower case, spaces, and punctuation.
2 Browsing
 At the end of each frame, XPLOT beeps and waits for you to type a
 character.  If you hit RETURN, it goes to the next frame.  If you type
 any alphanumeric character, it switches back to your VT100 screen and
 processes the character as a command.  The legal commands are:
       T - go to frame n
       S - skip forward n frames
       B - skip backward n frames
       F - XPLOT will ask you for a new file to open
       X - exit
 On T, S, or B, XPLOT prompts you for the frame or skip number.  If the
 character you entered is not one of the above, you will be reprompted.
 When you are on the VT100 screen, you can type ahead; e.g., you can
 type "T 8" to go to frame 8.  Comma retains the default value (the
 value in brackets).

 Skip 0 goes to the next frame; Skip 1 skips past one frame; etc.  Back
 0 replots the same frame; Back 1 goes back one frame; etc.  When you
 get the "end of file" message, Back 0 plots the last frame of the file.

 When XPLOT reaches the end of the file it does a screen switch and
 prompts you for a command character.
2 40xx-41xx_Conversion
 If the input plot file has an extension .PLT or .PLOT, XPLOT assumes it
 contains Tektronix 4014 mode commands.  XPLOT output is controlled by
 the TERMINAL_4105 logical.  To output in 4014 mode, be sure
 TERMINAL_4105 is deassigned.  To output in 4105 mode, which is
 appropriate for VersatermPro or the DW4125 terminal emulator, do:
        DEFINE TERMINAL_4105 YES
 before executing XPLOT.
2 41xx-40xx_Conversion
 If the input plot file has an extension .4105, XPLOT assumes it
 contains Tektronix 4105 mode commands.  To output in 4014 mode, which
 is appropriate for all terminals except VersatermPro, do:
        DEFINE TERMINAL_4105 NO
 before executing XPLOT.  This is how the TPLOT command converts a 4105
 file to 4014 mode for printing on a PPL laser printer.  When converting
 from 4105 to 4014, any fill areas (e.g., 4105 mode solid symbols and
 color fill between contour levels) are ignored.
2 Setup
  Define the environment TERMINAL_TYPE 
  e.g.: setenv TERMINAL_TYPE xterm

3 At PPPL

     module load ntcc (after you have loaded a compiler)

3 On VMS
 If you don't invoke TFTRLOG, you should have the following in your
 LOGIN.COM file:
       $ SETUP XPLOT

 Your LOGIN.COM must also contain (this is not in TFTRLOG):
       $ @USR:[COM]TERMLOG
             or
       $ @USR:[COM]TERMLOG xx
 where "xx" is the code for your terminal (e.g., MAC or V550) if you
 always use the same terminal.  If you do not specify the terminal type
 after TERMLOG, the procedure prompts you for a response.
2 Terminals
 Different terminals at PPL have different control sequences to switch
 between the VT100 emulation screen and the Tektronics graphics screen.
 For XPLOT to know what kind of terminal you have, and therefore how to
 do the screen switch, you must have logical variable TERMINAL_TYPE
 defined.  See Setup if you do not know how to do this.

 If you have a Macintosh with VersatermPRO version V3.0 B16 or higher
 and switch from looking at a .PLT (Tektronix 4014) file to a .4105 (Tek
 4105) and back, your Mac switches automatically to the proper graphics
 screen.  If you have Versaterm or an older version of VersatermPRO,
 after looking at a 4105 plot you must select "Tek 4014" in the
 Emulation menu to be able to view a 4014 file.  In either case
 switching from one Tek mode to the other causes VersatermPRO to clear
 its memory of previous plots.

 If you want more details on terminal types, see the "Terminals" section
 of the SG help file.
2 History
 XPLOT was substantially rewritten in November, 1988.  Send mail
 messages with bugs, kudos, etc., to Thompson.
                                                                               




