; 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). ----------------------------------------------------------------