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.