AIPS NRAO AIPS HELP file for BLSUM in 31DEC24



As of Mon Mar 18 21:16:44 2024


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
                                   = 0 no printer plot
                                   > 0 printer plot on terminal
                                   > 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
NPLOTS          -3.0         4.0   Number plots / plot file page
FACTOR                             Scale dots factor: < 0 ->
                                      do NOT connect dots
SYMBOL          0.0        24.0    Symbol to use when plotting.
LTYPE         -410.0       410.0   Plot file label type
XYRATIO          0.0               X/Y ratio: 0 -> 1.414
OPTYPE                             'WEIG' => weight sum with
                                             blotch image
                                   'WEI2' => weight sum with
                                             blotch image**2
APARM                              (1,2) APARM(1) < APARM(2)
                                      sets plot pixel range
                                   (3) Min blotch val for weight
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 on the printer and/or in real plot files) 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).

       If the third axis of the input image is FQID, any slices made
       will be interpolated onto a regular frequency grid.

       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 => do not make a printer-style plot of the spectrum
             > 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.
  NPLOTS.....Number of plots per plot file page (1 - 4).  0 means
             do not make plot files.  NPLOTS = -2 or -3 means to plot
             the subplots horizontally rather thanvertically.  NPLOTS
             = 4 is done as 2 x 2.
  FACTOR.....Scale dots by abs(FACTOR).  Dots will be connected unless
             FACTOR < 0.  0 -> 1.
  SYMBOL.....Symbol to use when plotting.
              1: Plus sign           13: Star of David
              2: Cross (X)           14: Seven-pointed star
              3: Circle              15: Eight-pointed star
              4: Box                 16: Nine-pointed star
              5: Triangle            17: Ten-pointed star
              6: Diamond             18: 11-pointed star
              7: Pentagon            19: 12-pointed star
              8: Hexagon             20: 13-pointed star
              9: Septagon            21: 14-pointed star
              10: Octagon            22: Plus (+) with gap
              11: Nine-gon           23: Cross (X) with gap
              12: Five pointed star  24: Vertical line
  LTYPE.......Labelling type, see HELP LTYPE for details:
              1 = border, 2 = no ticks, 3 or 7 = standard, 4 or 8 =
              relative to ref. pixel, 5 or 9 = relative to subimage
              (BLC, TRC) center, 6 or 10 = pixels.  7-10 all labels
              other than tick numbers and axis type are omitted.
              Less than 0 is the same except that the plot file
              version number and create time are omitted.
              Add n * 100 to alter the metric scaling.
  XYRATIO....Scale the X axis longer than the Y axis by XYRATIO.
             0 -> 1.414.
  OPTYPE.....'WEIG' => use the blotch image to provide weights for
                doing a weighted average over the blotch region.  Only
                points > APARM(3) will have weight > 0.
             'WEI2' => use the blotch image squared to provide weights
                for doing a weighted average over the blotch region.
                Only points > APARM(3) will have weight > 0.
             Anything else, no weighting.
  APARM......(1,2) If APARM(1) < APARM(2), then the real plots are
                 done from APARM(1) to APARM(2).  If APARM(2) <
                 APARM(1), then each page is self-scaled.  Otherwise
                 each plot is self-scaled.
             (3) Only include pixels that have the blotch image
                 brighter than APARM(3) when doing a weighted average.
  BADDISK....Disk number(s) to avoid for the scratch file.

EXPLAIN SECTION


AIPS