AIPS NRAO AIPS HELP file for TXPL in 31DEC24



As of Fri Mar 29 8:27:45 2024


TXPL: Task to send a plot file to a text file or terminal

INPUTS

INNAME                             File name (name)
INCLASS                            File name (class)
INSEQ           0.0      9999.0    File name (seq. #)
INDISK          0.0         9.0    Disk drive #
PLVER           0.0     46655.0    Version # of PL file. 0=>last
DOCRT          -3.0       132.0    <=0, Printer; >0, Terminal;
                                   =2, History File; =3 MSG File
OUTPRINT
                                   Printer disk file to save

HELP SECTION

TXPL
Type: Task
Use:  TXPL will find an extension file of type PL and use the graphics
      commands in that file to display the image on a dump terminal
      screen.  TXPL will also attempt grey scale plots.
Adverbs:
  INNAME......File name(name).          Standard defaults.
  INCLASS.....File name(class).         Standard defaults.
  INSEQ.......File name(seq. #).        0 => highest.
  INDISK......Disk drive # of image.     0 => any.
  PLVER.......Version # of the PL file.  0 => highest version #
  DOCRT......False (<= 0) use the line printer if OUTPRINT = ' '
                   else write named OUTPRINT file only.
                   When OUTPRINT is not blank, DOCRT=-2 suppresses the
                   page-feed character on page headers and DOCRT=-3
                   suppresses page headers and most other header
                   information.
             Special (= 2) write to history file
             Special (= 3) => write to message file
             True  (1, > 3) use the terminal interactively.  The task
                   will use the actual terminal width as a display limit
                   unless 72 < DOCRT < width.  In that case, the display
                   limit will be DOCRT characters.
  OUTPRINT...Disk file name in which to save the line printer output.
             ' ' => use scratch and print immediately for interactive
             jobs - batch jobs use OUTPRINT = 'PRTFIL:BATCHjjj.nnn'
             (jjj= job #, nnn = user #).  When OUTPRINT is not blank,
             multiple outputs are concatenated, and the file is not
             actually printed.
  DOCRT.......Use Terminal for Output.   0 <= => Printer
              > 0 => write to CRT,
              If 72 < DOCRT <= 132, the task will assume that
              the terminal is DOCRT characters wide.

EXPLAIN SECTION

TXPL is based on the TKPL task of aips, but writes Plot commands
to a terminal or line printer.  The plot may optionally be
written to the history file.


Because of the coarse sampling of the graphics screen, often
several lines of plot file output will map to the same dumb
terminal screen location.   Contour plots are almost useless in
this format, but UV plots and gain table plots are almost (?)
identical to tek plots.

GREY Scale intensities are translated into one of 11
characters, listed below:
Precent Intensity: Min  0 10 20 30 40 50 60 70 80 90 100
                 : Max  9 19 29 39 49 59 69 79 89 99 100
Character        :     ' ' .  :  ~  +  *  &   percent  #  @  M

The M character is only printed when the grey scale value is
the Maximum.

Programer:  Glen Langston, MIT and MPIfR  November 1987

AIPS