AIPS HELP file for WTSUM in 31DEC25
As of Wed Dec 11 6:07:47 2024
WTSUM: Task to do a weighted sum of two or more images
INPUTS
INNAME 1st input image name (name)
INCLASS 1st input image name (class)
INSEQ 0.0 9999.0 1st input image name (seq #)
INDISK 0.0 9.0 1st input image disk drive #
IN2NAME 2nd input image name (name)
' ' => loop INSEQ to IN2SEQ
IN2CLASS 2nd input image name (class)
IN2SEQ 0.0 9999.0 2nd input image name (seq #)
IN2DISK 0.0 9.0 2nd input image disk drive #
IN3NAME 1st weight image name (name)
IN3CLASS 1st weight image name (class)
IN3SEQ 0.0 9999.0 1st weight image name (seq #)
IN3DISK 0.0 9.0 1st weight image disk drive #
IN4NAME 2nd weight image name (name)
IN2NAME = ' ' => loop IN3SEQ
to IN3SEQ + IN2SEQ-INSEQ
IN4CLASS 2nd weight image name (class)
IN4SEQ 0.0 9999.0 2nd weight image name (seq #)
IN4DISK 0.0 9.0 2nd weight image disk drive #
OUTNAME Output image name (name)
OUTCLASS Output image name (class)
OUTSEQ 0.0 9999.0 Output image name (seq #)
OUTDISK 0.0 9.0 Output image disk drive #
BLC BLC of area to be searched
TRC TRC of area to be searched
DOINVER -1.0 1.0 > 0 => images 3,4 & output 2
are of rms
else they are const/(rms**2)
HELP SECTION
WTSUM
Type: Task
Use: WTSUM does a weighted sum of two or more images, writing out
Out(x,y) = Sum (Wi(x,y) Ii(x,y))
---------------------
Sum (Wi(x,y))
as well as the sum of the weights. Note that the Ii must be
exactly matching image planes or cubes. The weights may be single
planes (matching in x and y but not z) or cubes matching in all 3
axes. NO TESTS ARE PERFORMED TO INSURE THE VALIDITY OF
COORDINATES: use HGEOM, SUBIM, etc. to make sure things line up.
The task sums TWO weighted images when all four names are filled
in. If IN2NAME = ' ', then it sums IN2SEQ-INSEQ+1 images whose
name parameters all match the first except for having consecutive
sequence numvers. In that case, the weight images must all match
the 3rd image name parameters with consecutive sequence numbers
going from IN3SEQ through IN3SEQ+IN2SEQ-INSEQ.
For this to make correct sense, the weight images should all be
the same constant divided by sigma(x,y)**2. If DOINVER is true,
then the "weight" images and output image WWTSUM are handled as
rms images rather than weight images.
Adverbs:
INNAME......First image name (name). blank=>any
INCLASS.....First image name (class). blank=>any
INSEQ.......First image name (seq #). 0=>any
INDISK......Disk drive # for the first image. 0=>any
IN2NAME.....Second image name (name).
blank=> loop from INSEQ through IN2SEQ
IN2CLASS....Second image name (class). blank=>any
Ignored if IN2NAME = ' '.
IN2SEQ......Second image name (seq #). 0=>any
IN2DISK.....Disk drive # for the second image. 0=>any
Ignored if IN2NAME = ' '.
IN3NAME.....First weight name (name). blank=>any
IN3CLASS....First weight name (class). blank=>any
IN3SEQ......First weight name (seq #). 0=>any
IN3DISK.....Disk drive # for the first weight. 0=>any
IN4NAME.....Second weight name (name). blank=>any
Ignored if IN2NAME = ' '.
IN4CLASS....Second weight name (class). blank=>any
Ignored if IN2NAME = ' '.
IN4SEQ......Second weight name (seq #). 0=>any
Ignored if IN2NAME = ' '.
IN4DISK.....Disk drive # for the second weight. 0=>any
Ignored if IN2NAME = ' '.
OUTNAME.....Output image name (name)
OUTCLASS....Output image name (class) Class WWTSUM is used
for the sum of the weights.
OUTSEQ......Output image name (seq #)
OUTDISK.....Output image disk drive #
BLC.........BLC of area to be searched, 0 => 1,1
TRC.........TRC of area to be searched, 0 => NCOLS,NROWS
DOINVERS....The correct weights for summing are a constant divided by
the rms squared. If DOINVERS is false (<= 0), input
"weight" images (3 and 4) and output image WWTSUM are
assumed to have this form. If DOINVERS is true (> 0),
they are assumed to be images of the rms.
EXPLAIN SECTION