AIPS HELP file for BLSUM in 31DEC09
As of Sat Nov 21 18:30:47 2009
BLSUM: Sums images over blotch regions including spectra
INPUTS
INNAME Input image name (name)
INCLASS Input image name (class)
INSEQ 0.0 9999.0 Input image name (seq. #)
INDISK 0.0 9.0 Input image disk unit #
IN2NAME Blotch image name (name)
' ' => blotch = 1st image
IN2CLASS Blotch image name (class)
IN2SEQ 0.0 9999.0 Blotch image name (seq. #)
IN2DISK 0.0 9.0 Blotch image disk unit #
BLC Bottom left corner of input
TRC Top right corner of input
BCHAN -1.0 4096.0 Plane in IN2NAME for blotch
DOALIGN -2.0 1.0 > 0 => alignment of input and
clip images required
DOINVERS -1.0 1.0 > 0 => sum outside blotch
<= 0 => sum inside blotch
PRTLEV 0.0 3.0 >= 1 => printer plot
>= 2 => print pixel ranges
DOCRT -3.0 132.0 <= 0 use line printer
> 72 => terminal width
OUTPRINT
Printer disk file to save
OUTTEXT
Make file for input to PLOTR
DOSLICE -1.0 2.0 > 0 => save as SLice file
TVCHAN 1.0 4.0 TV channel to use
PIXRANGE Min,Max of image intensity
Max <= Min => entire range
FUNCTYPE Image intensity transfer func
'LN' Linear. unknown=>'LN'
'LG' Logarithmic
'SQ' Square root
'NE' Negative linear
'NG' Negative logarithmic
'NQ' Negative square root
TXINC 0.0 32.0 load every TXINCth pixel on x
axis
TYINC 0.0 32.0 load every TYINCth pixel on y
axis
BADDISK 0.0 15.0 Disk to avoid for scratch
HELP SECTION
BLSUM
Task: Interactive task to sum images over blotch regions and print (and
plot) the results. It will do single-plane images or each plane
of a 3+ dimensional image. In the latter case, some one plane of
the image OR of another image is used to set the blotch area(s).
A blotch is a set of one or more polygonal regions which the user
indicates to the task via the TV cursor. The task will loop to
do separate sums over separately indicated blotch regions until
the user tells it to quit. The new blotch regions are shown on
TV graphics plane 3 (usually pink) while the previous ones are
shown on graphics plane 2 (usually green).
The plots are in Jy for Clean images or average brightness for
other sorts of images.
Adverbs:
INNAME.....Input image name (name). Standard defaults.
INCLASS....Input image name (class). Standard defaults.
INSEQ......Input image name (seq. #). 0 => highest.
INDISK.....Disk drive # of input image. 0 => any.
IN2NAME....Blotch image name (name) Standard defaults --
except that blank => no second image.
IN2CLASS...Blotch image name (class) Standard defaults.
IN2SEQ.....Blotch image name (seq. #) 0 => highest.
IN2DISK....Disk drive # of blotch image. 0 => any.
BLC........Bottom right corner in input image of desired subimage.
Default is entire image.
TRC........Top right corner in input image of desired subimage.
Default is entire image.
BCHAN......Plane in IN2NAME to use for blotching.
DOALIGN....Controls how the input and blotch images are to be
aligned (see HELP DOALIGN). True (>.1) means that the
images must agree in their coordinates. Note that a
2-dim image (e.g. RA-Dec) may be used to blotch a 3-dim
image in several of the possible transpositions (e.g.,
RA-Dec-V, V-RA-Dec, RA-V-Dec, but not V-Dec-Ra, for
example) when the headers match. DOALIGN = -2 means to
ignore the headers and align at (1,1,...).
DOINVERS...> 0 => sums are taken outside the blotch regions;
<= 0 => sums are taken inside the blotch regions.
PRTLEV.....>= 2 => print the x-pixel range(s) included in the blotch
for each row of the blotch image. >= 1 => do a printer
plot of the results. 0 => print only the sums.
DOCRT......<= 0.0 => use the line printer (or OUTPRINT).
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.
> 0 use CRT and the message file (at level 5). The task
will use the width of the terminal for its display unless
72 < DOCRT <= width, in which case the display will be
limited to 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.
OUTTEXT....Disk file name to save the output in a format suitable to
AIPS task PLOTR. ' ' => none
DOSLICE....> 0 => save each spectrum as a SLice file suitable for
the usual plotting and fitting done on slices.
TVCHAN.....TV channel to use (<= 0 -> 1). Lowest channel is used if
more than one specified (via decimal code).
PIXRANGE...Min,Max of image intensity for scaling to the TV.
0 => full range of image.
FUNCTYPE...Image intensity transfer function
'LN' => linear; 'LG' => log; 'NE' => negative lin.
'NG' => negative log; 'SQ' => square root,;
'NQ' => negative square root; others => linear.
TXINC......Load only every TXINC'th x-pixel to the TV. 0 -> 1.
(It is used to avoid many separate loads of sub-images when
the input image is large.)
TYINC......Load only every TYINC'th y-pixel to the TV. 0 -> 1.
BADDISK....Disk number(s) to avoid for the scratch file.
EXPLAIN SECTION