; SYPRT
;---------------------------------------------------------------
;! Task to print values from the SY table
;# TASK EXT-APPL CALIBRATION VLA
;-----------------------------------------------------------------------
;;  Copyright (C) 2020
;;  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
;-----------------------------------------------------------------------
SYPRT     LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
SYPRT:  Task to print SY table values
INNAME                             Image name(name).
INCLASS                            Image name(class).
INSEQ           0.0      9999.0    Image name(seq. #). 0=>high
INDISK                             Disk drive #. 0=>any
INVERS          0.0     46655.0    SY table version number
SOURCES                            Source names to include
QUAL            -10.0              Qualifier -1=>all
CALCODE                            Restrict to this calcode
SELBAND                            Bandwidth to select (kHz)
SELFREQ                            Frequency to select (MHz)
FREQID                             Freq. ID to select.
SUBARRAY          0.0     1000.0   Subarray, 0 => 1
TIMERANG                           Time range to use
ANTENNAS                           Desired or unwanted antennas
FLAGVER          -1.0              > 0 => apply flags to SY
DOCRT            -3.0     132.0    > 0 -> use the terminal,
                                   else use the line printer
                                   > 72 => terminal width
OUTPRINT                           Printer disk file to save
BIF                                First IF to print
EIF                                Last IF to print
OPTYPE                             'DIFS','SUMS','TSYS' list
NDIG                               Number of digits to use 0->4
FACTOR                             Scale print by FACTOR 0 -> 1
DOSCALE                            > 0 scale antennas separately
BADDISK                            Disks to avoid for scratch
----------------------------------------------------------------
SYPRT
Type: Task
Use:  SYPRT reads EVLA SY and CD tables and prints the selected data
      as a table with columns being separate IFs.  PRTSY is another
      task that prints scan and statistical summaries of SY data.
Adverbs:
  INNAME.....Image name (name).       Standard defaults.
  INCLASS....Image name (class).      Standard defaults.
  INSEQ......Image name (seq. #).     0 => highest.
  INDISK.....Disk unit #.             0 => any.
  INVERS.....Version number of SY table to be examined.
  SOURCES....List of sources to be printed. '  '=> all; if any
             starts with a '-' then all except ANY source named.
  QUAL.......Qualifier of source to be printed.    -1 => all.
  CALCODE....Calibrator code of sources to print.  ' '=> all.
                  '*   ' => any non blank code (cal. only)
                  '-CAL' => blank codes only (no calibrators)
                  anything else = calibrator code to select.
  SELBAND....Bandwidth of data to be selected. If more than one IF is
             present SELBAND is the width of the first IF required.
             Units = kHz. For data which contain multiple
             bandwidths/frequencies the task will insist that some form
             of selection be made by frequency or bandwidth.
  SELFREQ....Frequency of data to be selected. If more than one IF is
             present SELFREQ is the frequency of the first IF required.
             Units = MHz.
  FREQID.....Frequency identifier to select (you may determine which is
             applicable from the OPTYPE='SCAN' listing produced by
             LISTR). If either SELBAND or SELFREQ are set, their values
             overide that of FREQID.  However, setting SELBAND and
             SELFREQ may result in an ambiguity.  In that case, the task
             will request that you use FREQID.  If all SELBAND, SELFREQ
             and FREQID are not specified (.le. 0) then all FQ ids will
             be selected.
  SUBARRAY...Subarray number to print.       0 => 1.
  TIMERANG...Time range of the data to be plotted. In order:
             Start day, hour, min. sec, end day, hour, min. sec.
             Days relative to reference date.
  ANTENNAS...A list of the antennas to be printed.  If any number is
             negative then all antennas listed are NOT to be printed
             and all others are.
  FLAGVER....> 0 => apply flag table version FLAGVER to SY table
  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.  When OUTPRINT is blank, the line
                 printer will be used.  PRTSY now counts the lines
                 to be printed before printing any and asks for
                 permission to continue if the count > 500.
             True  (> 0) 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.
  OPTYPE.....'DIFS' print only Pdif information
             'SUMS' print only Psum information
             'TSYS' print only Tcal*Psum/Pdif information
             'PDIF' print only Pdif information
             'PSUM' print only Psum information
             'PSYS' print only Tcal*Psum/Pdif information
  NDIG.......Number of digits to use (2-7)  0 -> 4  (max ' 9999'
  FACTOR.....The display prints normalized values but the
             normalization may be seriously affected by a few high
             values.  You may scale those displays by a factor
             (0 -> 1, values > 1 are useful).  If you do this, the
             very high values will show as "*****".  Blanked values
             show as " ----".  TSYS gets blanked if Tcal, Psum, or
             Pdif are blanked or have values out of range.
  DOSCALE....> 0  => scale each antenna by its range of values
             <= 0 => scale all antennas the same by the overall
                     range of values
  BADDISK....The disk numbers to avoid for scratch files (sorting
             tables mostly).
----------------------------------------------------------------
