AIPS NRAO AIPS HELP file for STACK in 31DEC18



As of Wed Jan 24 2:09:35 2018


STACK: Task to co-add a set of 2-D images with weighting

INPUTS

INNAME                             Input name(name).
INCLASS                            Input name(class).
INSEQ           0.0      9999.0    Input name(seq. #). 0=>high
INDISK                             Input disk drive #. 0=>any
IN2SEQ          0.0                Upper limit sequence number
OUTNAME                            Output name(name).
OUTCLASS                           Output name(class).
OUTSEQ         -1.0      9999.0    Output name(seq. #).
                                     0 => highest unique
OUTDISK                            Output image disk drive #
                                     0 => highest with room
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
OPCODE                             '   ' average INSEQ-IN2SEQ
                                   'MEDI' median INSEQ-IN2SEQ
                                   'CUBE' average BLC(3)-TRC(3)
                                   'MEDC' median BLC(3)-TRC(3)
INFILE                             Text file with weights

HELP SECTION

STACK
Type: Task
Use:  STACK will do a weighted average of two-dimensional images,
      either from a sequence of image files having the same name and
      class and sequence numbers from INSEQ through IN2SEQ or from the
      planes of a cube from BLC(3) through TRC(3).  The weights may be
      read in from a text file, taken from the ACTNOISE keyword in
      each file, or found by robust rms means on a per-plane basis.
      Not all images in the sequence INSEQ through IN2SEQ need be
      present and magic blanked pixels are ignored.  The old task
      SUMIM requires all images in the sequence to be present, does no
      weighting, and blanks any pixel for which one of the input
      pixels was blank.
Adverbs:
  INNAME......Input name of image(name).     Standard defaults.
  INCLASS.....Input name of image(class).    Standard defaults.
  INSEQ.......Input name of image(seq. #).   0 => highest.
  INDISK......Disk drive # of image.         0 => any.
  IN2SEQ......Upper limit for the liip over image sequence number.
  OUTNAME.....Output name of image(name).    Standard defaults.
  OUTCLASS....Output name of image(class).   Standard defaults.
  OUTSEQ......Output name of image(seq. #).  0 => highest unique
  OUTDISK.....Disk drive # of Output image.  0 => highest with
              space.
  BLC.........The bottom left-hand pixel of the input image
              which becomes the bottom left corner of the
              subimage.  The value (0,0) means (1,1).
  TRC.........The top right-hand pixel of the input image
              which becomes the top right corner of the
              subimage.  The value (0,0) means take the top
              right hand corner of the image.  The same BLC and TRC
              are applied to each input image and TRC(3) is forced to
              BLC(3) except in CUBE mode.
  OPCODE......'    ' = do weighted sum of images INSEQ-IN2SEQ
              'CUBE' = do weighted sum of planes BLC(3)-TRC(3)
  INFILE......If not blank, weights are read from this text file.
              Each row of the file has one weight in free format and
              must contain lines for all sequence numbers from INSEQ
              through IN2SEQ or all planes from BLC(3) through TRC(3)
              even if some images are missing or planes all blanked.

EXPLAIN SECTION


AIPS