; BLSUM
;---------------------------------------------------------------
;! sums images over irregular sub-images, displays spectra
;# TASK TV-APPL ANALYSIS SPECTRAL PLOT
;-----------------------------------------------------------------------
;;  Copyright (C) 1995-1996, 1999-2000, 2004, 2008-2009
;;  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
;-----------------------------------------------------------------------
BLSUM     LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
BLSUM     Sums images over blotch regions including spectra
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
----------------------------------------------------------------
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.
----------------------------------------------------------------
