AIPS HELP file for PRTIM in 31DEC24
As of Mon Oct 14 9:15:49 2024
PRTIM: Task to print the image intensities in digital form
INPUTS
INNAME Image name(name).
INCLASS Image name(class).
INSEQ 0.0 9999.0 Image name(seq. #). 0 => high
INDISK 0.0 9.0 Disk drive #. 0 => any
BLC 0.0 4096.0 Bottom left corner of image
0 => entire image
TRC 0.0 4096.0 Top right corner of image
0 => entire image
NDIG 0.0 7.0 Digits in display. 0 => 1
FACTOR Multiplication factor. 0 => 1
XINC 0.0 100.0 Display every XINC col. 0=> 1
YINC 0.0 100.0 Display every YINC rows. 0=>1
DOCRT -3.0 132.0 >0 -> use CRT, else printer
>72 => CRT width in chars
OUTPRINT
Printer disk file to save
HELP SECTION
PRTIM
Type: Task
Use: PRTIM displays an image on the line printer or the user's
terminal. The input parameters specify (1) any
rectangular solid in the image, (2) the number of digits
used for the display, (3) the skipping of pixels and (4)
the multiplication of the display after normalization.
Normalization is done using the larger of Datamax and
-10.0*Datamin rounded up to the next higher power of 10.
For NDIG=1, Datamin is used instead of 10 * Datamin. This
default scaling (FACTOR = 1) causes the numbers to be
printed in "natural" units (e.g. Jy/beam) scaled by some
power of 10. The output shows the scaling (e.g. 1000 =
1.0 Jy/beam on NDIG = 3).
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.
BLC.........The Bottom Left-hand pixel of the subarray of
the map to be displayed. The value (0,0) means
start at the bottom left of the entire image.
TRC.........The Top Right-hand pixel of the subarray of
the map to be displayed. The value (0,0) means
go to the top right of the entire image.
NDIG........The number of digits in the display. If NDIG <=
0, an NDIG of 1 is used.
FACTOR......The multiplication factor for the display. If
FACTOR <= 0.0, a FACTOR of 1.0 is used.
XINC........Display every XINC column(s) in the display.
If XINC <= 0, an XINC of 1 is used.
YINC........Display every YINC row(s) in the display.
If YINC <= 0, a YINC of 1 is used.
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. PRTIM 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.
EXPLAIN SECTION