AIPS HELP file for PRTAB in 31DEC09
As of Sat Nov 21 13:09:28 2009
PRTAB: Task to print any table-format extension file
INPUTS
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 0.0 10.0 > 3 => extended precision
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 1.0 > 0 => list flagged rows too
HELP SECTION
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 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.
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.
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.
EXPLAIN SECTION