AIPS HELP file for CMPLX in 31DEC25
As of Mon Dec 9 13:06:19 2024
CMPLX: Task to combine two overlapping complex images
INPUTS
INNAME First image name - real/amp
INCLASS First image class
INSEQ 0.0 9999.0 First image seq. #
INDISK 0.0 9.0 First image disk drive #
IN2NAME First image name - imag/phase
IN2CLASS First image class
IN2SEQ 0.0 9999.0 First image seq. #
IN2DISK 0.0 9.0 First image disk drive #
IN3NAME Second image name - real/amp
IN3CLASS Second image class
IN3SEQ 0.0 9999.0 Second image seq. #
IN3DISK 0.0 9.0 Second image disk #
IN4NAME Second image name - imag/phas
IN4CLASS Second image class
IN4SEQ 0.0 9999.0 Second image seq. #
IN4DISK 0.0 9.0 Second image disk #
DOALIGN -2.0 1.0 Should images be coincident?
(See HELP.)
OUTNAME Output image name - real/amp
OUTCLASS Output image class
OUTSEQ -1.0 9999.0 Output image seq. #
OUTDISK 0.0 9.0 Output image disk drive #
OUT2NAME Output image name - imag/phas
OUT2CLAS Output image class
OUT2SEQ -1.0 9999.0 Output image seq. #
OUT2DISK 0.0 9.0 Output image disk drive #
BLC 0.0 4096.0 Bottom left corner
TRC 0.0 4096.0 Top right corner
OPCODE Algorithm type: 'CONJ','SWAP'
'SUM ','SUMC','SUMI','ISUM'
'DIV ','DIVC','DIVI','MULT',
'MULC','MULI'
APARM Parameters for algorithm:
(1) - (4) scale and offset
(8) > 0 input 1 rea/imag
(9) > 0 input 2 real/imag
(10) > 0 output real/imag
see HELP CMPLX
DOHIST -3.0 1.0 -2 => copy 1st HI only
-3 => copy no HI files
HELP SECTION
CMPLX
Type: Task
CMPLX is a generalized task which performs functions on one or two
input complex images. Note that a complex image is actually two
images in AIPS. The function is performed pixel by pixel to
produce one output complex image. Numerous mathematical methods for
combining the images are provided.
The two input maps should be coincident. One may combine only
subimages if desired. CMPLX will combine two fully overlapping
n-dimensional images and it can combine each n-m dimension "plane"
of the first n-dimensional image with the single n-m dimension
"plane" of an n-m dimensional second image.
If the images are in JY/BEAM, CMPLX will scale images 2, 3, and 4
to be in the same beam as that of image 1 before doing the
combination.
Adverbs:
INNAME......First image name - real or amplitude. Standard defaults.
INCLASS.....First image class. Standard defaults.
INSEQ.......First image seq. #. 0 => highest.
INDISK......Disk drive # for the first image. 0 => any.
IN2NAME.....First image name - imaginary or phase. Standard defaults.
IN2CLASS....First image class. Standard defaults.
IN2SEQ......First image seq. #. 0 => highest.
IN2DISK.....Disk drive # for the first image. 0 => any.
IN3NAME.....Second image name. Standard defaults.
IN3CLASS....Second image class. Standard defaults.
IN3SEQ......Second image seq. #. 0 => highest.
IN3DISK.....Disk # for second image. 0 => any.
IN4NAME.....Second image name. Standard defaults.
IN4CLASS....Second image class. Standard defaults.
IN4SEQ......Second image seq. #. 0 => highest.
IN4DISK.....Disk # for second image. 0 => any.
DOALIGN.....Controls how the four images are to be aligned (see HELP
DOALIGN). True (>.1) means that the images must agree in
their coordinates, though not necessarily in the reference
pixel position. Alignment is by coordinate values (if
DOALIGN > -0.1) or by offsets from the reference pixel
positions (if DOALIGN <= -0.1). NOTE: all real axes (>1
point) are aligned. If DOALIGN = -2, the headers are
ignored and the images are aligned at pixel (1,1,...).
OUTNAME.....Output image name - real or amplitude. Standard defaults.
OUTCLASS....Output image class. Standard behavior with default =
the type of file (Real or Amp) and the OPCODE
OUTSEQ......Output image seq. #. 0 => highest unique.
OUTDISK.....Output disk number. 0 => highest with space.
OUT2NAME....Output image name - imaginary or phase. Standard defaults.
OUT2CLAS....Output image class. Standard behavior with default =
the type of file (Imag or Phase) plus the OPCODE.
OUT2SEQ.....Output image seq. #. 0 => highest unique.
OUT2DISK....Output disk number. 0 => highest with space.
BLC.........Bottom left corner of the 1st input image. The other
images are aligned by coordinates (see DOALIGN) on all
axes having > 1 point. The other images may have fewer
real axes than the 1st. The 4 windows must have the same
dimension on the first 2 axes, but the task will select a
smaller window than was specified if needed to overlap the
4 images.
TRC.........Top right corner of input images. (See BLC.)
OPCODE......The combination algorithm specification: (A=APARM)
M(1) = the complex 1st image (in real/imaginary form)
M(2) = the complex 2nd image (in real/imaginary form)
1 input image options:
='CONJ': Conjugate A(1)*Conj(M(1)) + A(2) + iA(3)
='SWAP': Swap type A(1)*M(1) + a(2) + iA(3) with amp/phase
-> real/imag or real/imag -> amp/phase
2 input image options:
='SUM ': Linear sum A(1)*MAP(1) + A(2)*MAP(2) + A(3) + iA(4)
='SUMC': Conjugate sum A(1)*MAP(1) + A(2)*conj(MAP(2))+A(3)+iA(4)
='SUMI': i scale sum A(1)*MAP(1) + A(2)*(i*MAP(2))+A(3)+iA(4)
='ISUM': i times sum i*(A(1)*MAP(1) + A(2)*MAP(2)) + A(3) + iA(4)
='DIV ': Division A(1)*MAP(1) / MAP(2) + A(2) + iA(3)
='DIVC': Conj Division A(1)*MAP(1) / conj(MAP(2)) + A(2) + iA(3)
='DIVI': i scale Division A(1)*MAP(1) / (i*MAP(2)) + A(2) + iA(3)
='IDIV': i timesDivision i*A(1)*MAP(1) / MAP(2) + A(2) + iA(3)
='MULT': Multiplic. A(1)*MAP(1)*MAP(2) + A(2) + iA(3)
='MULC': Conj mult A(1)*MAP(1)*conj(MAP(2)) + A(2) + iA(3)
='MULI': i scale mult A(1)*MAP(1)*(i*MAP(2)) + A(2) + iA(3)
='IMUL': i * Multiplic. i*A(1)*MAP(1)*MAP(2) + A(2) + iA(3)
APARM.......Parameters needed for algorithm:
APARM(1), APARM(2), APARM(3), APARM(4) used as above.
APARM(1) = 0 => APARM(1) = 1.0
APARM(2) = 0 => APARM(2) = 1.0 (for 'SUM ', SUMC)
APARM(8) > 0 => Image 1 is real/imaginary
<= 0 => Image 1 is amplitude/phase
APARM(9) > 0 => Image 2 is real/imaginary
<= 0 => Image 2 is amplitude/phase
APARM(10) > 0 => Output is real/imaginary
<= 0 => Output is amplitude/phase
DOHIST.......Normally the HI file of input 1 is copied to the output
history file and the HI file of the second input is
appended. If you are doing many CMPLXs this can lead to
immense history files of little use to anyone. Thus,
DOHIST=-2 => copy the first HI file only.
DOHIST=-3 => copy no HI file, write CMPLX HI only.
EXPLAIN SECTION