; PRTAB ;--------------------------------------------------------------- ;! prints any table-format extension file ;# Task Table Plot ;----------------------------------------------------------------------- ;; Copyright (C) 1995-1996, 1999, 2002, 2004, 2007, 2009, 2011-2012 ;; Copyright (C) 2014 ;; 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 ;----------------------------------------------------------------------- PRTAB LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC PRTAB: Task to print any table-format extension file INNAME Image name (name) INCLASS Image name (class) INSEQ 0.0 9999.0 Image name (seq. #) INDISK 0.0 9.0 Disk drive # INEXT Extension type INVERS -5.0 46655.0 Extension file version # BPRINT 0.0 First row number to print EPRINT 0.0 Last row number to print XINC 0.0 32767. Increment between rows NDIG -10.0 10.0 > 3 => extended precision <=0 => use F not exp format DOCRT -3.0 132.0 If > 0, write to CRT > 72 => CRT line width OUTPRINT Printer disk file to save DOHMS -1.0 2.0 If > 0 print times with hh:mm:ss.s format NCOUNT 0.0 Print the first NCOUNT values in a cell plus BDROP 0.0 values BDROP through EDROP 0.0 EDROP (if appropriate) BOX List of columns to be printed 0 -> all. DOFLAG -1.0 > 0 => list flagged rows too RPARM Limit print to rows matching (1) column, (2) subscript, (3) value, (4) allowed mismatch, (5-8) 2nd test (9-12) 3rd test, etc. KEYSTRNG String to match DOINVERS -1.0 1.0 > 0 print if not match, else print only if match ---------------------------------------------------------------- PRTAB Type: Task Use: PRTAB prints on the line printer or terminal the rows of any extension file having a tables format. Adverbs: INNAME.....Image name (name). Standard defaults. INCLASS....Image name (class). Standard defaults. INSEQ......Image name (seq. #). 0 => highest. INDISK.....Disk drive # of image. 0 => any. INEXT......Extension file type ' ' => 'TA' INVERS.....Extension file version # 0 => highest. BPRINT.....First row to list. 0 => 1. EPRINT.....Last row to list. < BPRINT => to end. XINC.......Increment in row number between listings. <= 0 => 1. NDIG.......If 0 < NDIG <= 3, the formats 1PE10.3 and 1PD13.6 are used for single and double precision floats. To see more digits, NDIG > 3 causes 1PE13.6 and 1PD17.10 to be used. The added digits may be significant in some tables. If -3 <= NDIG <= 0, suitable non-exponential formats will be used when possible. Exponential will still be used for numbers all of which are very small. NDIG < -3 can use additional digits if needed to reresent the smallest non-zero values. 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. 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. DOHMS......If DOHMS is false (<=0), the times in the output will be printed in days. If DOHMS > 0, they will be printed in the form hh:mm:ss.s. This is done for any column having units of DAYS and a header which starts with TIME. By default, PRTAB prints all elements in a cell of a table, one element per line. The next three adverbs may be used to print elements 1-n1 and n2-n3 only. **** Defaults for these 3 are set only if all 3 are zero or n1 <= 0 and n3= n2, then n1 = max (1, n1). **** NCOUNT.....Elements 1 through NCOUNT are printed for each selected cell in the table. 0 => 100000. BDROP......Additionally, elements BDROP through EDROP are also printed. 0 => 1. EDROP......Additionally, elements BDROP through EDROP are also printed. < BDROP => 100000. BOX........To select the column numbers to be printed including their order. Up to 40 may be selected. 0 => all columns in basic order. DOFLAG.....> 0 => list flagged rows (with an * in 1st col) as well as unflagged rows <= 0 => skip over flagged rows, listing only good ones. You can also limit the display to those rows which match or which do not match specified values. RPARM......(1-4) 1st test column, subscript, value, allowed error (5-8) 2nd test column, subscript, value, allowed error (9-12) 3rd test column, subscript, value, allowed error etc. up to 7 tests all of which are ANDed. KEYSTRNG...One test may be on character-valued column which must match this adverb - the match is checked only to the number of characters given in KEYSTRNG. Thus, for example, KEYSTR='RFLAG:'; DOINV 1; RPARM = 9,1 will print only those flags not generated by RFLAG ignoring the times shown in the RFLAG reasons when printing a flag table. DOINVERS...<= 0 => print only those rows match tests 1, 2, and 3 (how many of them have values) > 0 => print only those that do not match ----------------------------------------------------------------