; TAPLT
;---------------------------------------------------------------
;! Plots data from a Table extension file
;# TASK TABLE PLOT
;-----------------------------------------------------------------------
;;  Copyright (C) 1995
;;  Associated Universities, Inc. Washington DC, USA.
;;
;;  This program is free software; you can redistribute it and/or
;;  modify it under the terms of the GNU General Public License as
;;  published by the Free Software Foundation; either version 2 of
;;  the License, or (at your option) any later version.
;;
;;  This program is distributed in the hope that it will be useful,
;;  but WITHOUT ANY WARRANTY; without even the implied warranty of
;;  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;  GNU General Public License for more details.
;;
;;  You should have received a copy of the GNU General Public
;;  License along with this program; if not, write to the Free
;;  Software Foundation, Inc., 675 Massachusetts Ave, Cambridge,
;;  MA 02139, USA.
;;
;;  Correspondence concerning AIPS should be addressed as follows:
;;         Internet email: aipsmail@nrao.edu.
;;         Postal address: AIPS Project Office
;;                         National Radio Astronomy Observatory
;;                         520 Edgemont Road
;;                         Charlottesville, VA 22903-2475 USA
;-----------------------------------------------------------------------
;---------------------------------------------------------------
TAPLT     LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
TAPLT     Plots data from a Table extension file
USERID       -32000.0    32000.0   Data base owner number
INNAME                             Input file name (name)
INCLASS                            Input file name (class)
INSEQ             0.0     9999.0   Input file name (seq. #)
INDISK            0.0        9.0   Input file disk unit #
INEXT                              Input table type.
INVERS            0.0    46655.0   Input table version #.
BCOUNT            0.0    99999.0   Beginning row in plot
ECOUNT            0.0    99999.0   Last row in plot: 0 => end
XINC              0.0     9999.0   Increment between plotted
                                   rows
DOHIST           -1.0        1.0   Plot as histogram
APARM                              Column selection parameters:
                                   1: X-axis col A, no default
                                   2: X-axis col A subscript
                                   3: X-axis col B, no default
                                   4: X-axis col B subscript
                                   5: X-axis function type
                                          SEE the HELP !
                                   6: Y-axis col A, no default
                                   7: Y-axis col A subscript
                                   8: Y-axis col B, no default
                                   9: Y-axis col B subscript
                                   10: Y-axis function type
BPARM                              Control parameters
                                   1 : Number of bins in plot
                                   2 : Print binned results?
                                   3 : > 0.0 => fixed scale
                                       < 0.0 => fixed range
                                   4 : Xmin (fixed scale)
                                   5 : Xmax (fixed scale)
                                   6 : Ymin (fixed scale)
                                   7 : Ymax (fixed scale)
                                   9: Exponent for X-axis
                                   10: Exponent for Y-axis
CPARM                              1: X-axis col A factor
                                   2: X-axis col A offset
                                   3: X-axis col B factor
                                   4: X-axis col B offset
                                   5: Y-axis col A factor
                                   6: Y-axis col A offset
                                   7: Y-axis col B factor
                                   8: Y-axis col B offset
                                   9: X-axis overall factor
                                   10: X-axis overall offset
LTYPE         -10.0        10.0    Type of labeling: 1 border,
                                   2 no ticks, 3 - 6 standard,
                                   7 - 10 only tick labels
                                   <0 -> no date/time
DOTV           -1.0         1.0    > 0 Do plot on the TV, else
                                   make a plot file
GRCHAN          0.0         8.0    Graphics channel 0 => 1.
----------------------------------------------------------------
TAPLT
Type: Task
Use:  Plots data from an AIPS table-format extension file.
Adverbs:
  USERID.....Input file user number.  0 => logon user,
             32000 => any user.
  INNAME.....Input file name (name)    Standard defaults.
  INCLASS....Input file name (class)   Standard defaults.
  INSEQ......Input file name (seq. #)  0 => highest.
  INDISK.....Disk drive # of input file.  0 => any.
  INEXT......Type of input table extension.  '  ' = 'CC'
  INVERS.....Version number of table extension.  0 => highest.
  BCOUNT.....Beginning row number to be included in plot. 0 = 1.
  ECOUNT.....Ending row number included in plot.  0 = highest.
  XINC.......Increment in row number between rows included in
             plot.    0 => 1.
  DOHIST.....> 0 => plot as histogram in the X-axis parameter.
             <= 0 plot two columns against each other.
  APARM......Column selection parameters:
     1 = X-axis logical column number A:  0 => row number.
         < 0 => use absolute value of col. abs(APARM(1))
     2 = The subscript of the X-axis column A data to use if the
         column is an array.  0 => 1.
     3 = X-axis logical column number B:  0 => row number.
         < 0 => use absolute value of col. abs(APARM(1))
     4 = The subscript of the X-axis column B data to use if the
         column is an array.  0 => 1.
     5 = X-axis function number: Various functions may be
         performed on column A only or on a pair of columns A
         and B before plotting.  Functions which use column A
         only are 0 = no function, 1 = sum, 2 = asin, 3 = Log10,
         4 = ln, 5 = exp, 6 = sin, 7 = cos, 8 = tan, 9 = atan.
         In these cases, APARM(3) and (4) are ignored.  Sum
         includes those rows which are not plotted due to XINC
         and BCOUNT.  Functions which use both columns are
         10 = +, 11 = -, 12 = *, 13 = /, 14 = **, 15 = mod,
         16 = Modulus, 17 = atan2, 18 = max, and 19 = min.
     6 = Y-axis logical column number A:  as for X-axis.
     7 = The subscript of the Y-axis column A data to use if the
         column is an array.  0 => 1.
     8 = Y-axis logical column number B:  as for X-axis.
     9 = The subscript of the Y-axis column B data to use if the
         column is an array.  0 => 1.
     10 = Y-axis function number: as for X-axis.  The Y-axis
         parms 6-9 are ignored if DOHIST > 0.  APARM(10) will
         be used for the histogram counts if it is 2 = sqrt,
         3 = log10, or 4 = ln.  Otherwise it is ignored too.
  BPARM......Plot control parameters:
     1 = If DOHIST > 0, the number of bins in the histogram
         (0 => 50).  If DOHIST <= 0 and BPARM(1) > 0, the plot
         will be of bin averages in X of the specified quantity.
         There will be BPARM(1) number of bins in the plot.  For
         bins with more than 2 samples the vertical height of
         the symbol represents the standard deviation of the
         mean of the distribution in the bin.  In this case, 0
         means to plot all points rather than the binned
         average.
     2 = If DOHIST <= 0 and BPARM(1) > 0 and BPARM(2) > 0, the
         bin averages will be printed in the message file at
         message level 4.
     3 = If greater than zero, use BPARM(4) - BPARM(7) as
         the ranges of the axes.  If less than zero, use the
         BPARMs to limit the range of the axes, but self-
         scale the axes within that range.  If 0.0, fully
         self-scaling.
     4 = Minimum of X-axis.
     5 = Maximum of X-axis (if = BPARM(4) do self-scale in X).
     6 = Minimum of Y-axis.
     7 = Maximum of Y-axis (if = BPARM(6) do self-scale in Y).
     9 = The exponent to which to take the X-axis result value
         before plotting.   0 => 1.
     10 = The exponent to which to take the Y-axis result value
         before plotting.   0 => 1.
  CPARM......After the value or absolute value of a column is
          found, it may be scaled and offset before other
          functions are applied to it.
     1 = X-axis logical column number A scale factor: 0 -> 1.
     2 = X-axis logical column number A offset.
     3 = X-axis logical column number B scale factor: 0 -> 1.
     4 = X-axis logical column number B offset.
     5 = Y-axis logical column number A scale factor: 0 -> 1.
     6 = Y-axis logical column number A offset.
     7 = Y-axis logical column number B scale factor: 0 -> 1.
     8 = Y-axis logical column number B offset.
  LTYPE.......Labelling type: 1 = border, 2 = no ticks,
              3 - 10 = standard, with  7-10 all labels other
              than tick numbers and axis type are omitted.
              Less than 0 is the same except that the plot file
              version number and create time are omitted.
  DOTV........> 0 => plot directly on the TV device, otherwise
              make a plot file for later display on one or
              more devices (including the TV if desired).
  GRCHAN......Graphics channel (1 - 7) to use for line drawing.
              0 => 1.
----------------------------------------------------------------
