AIPS HELP file for COPIXEL in 31DEC18
As of Fri Oct 19 17:43:57 2018
COPIXEL: Verb to convert between physical and pixel coordinates
INNAME Image name(name).
INCLASS Image name(class).
INSEQ 0.0 9999.0 Image name(seq. #). 0=>high
INDISK 0.0 9.0 Disk drive #. 0=>any
OPTYPE 'PIXE' => pixel -> coord
else coord -> pixel
COORDINA $ Coordinate in image
PIXXY $ 0.0 Pixel location (X,Y,...)
ERROR @ -1.0 1.0 Error in coordinates?
Use: To convert between physical and pixel coordinates in an image.
INNAME.....Image name(name). Standard defaults.
INCLASS....Image name(class). Standard defaults.
INSEQ......Image name(seq. #). 0 => highest.
INDISK.....Disk drive # of image. 0 => any.
OPTYPE.....'PIXE' => convert PIXXY to COORDINA
else convert COORDINA to PIXXY
COORDINA...The X and Y coordinates are found as:
Xpos = abs(CO(1)) + abs(CO(2))/60 + abs(CO(3))/3600
if any of CO(1), CO(2), CO(3) < 0: Xpos = -Xpos
Ypos = abs(CO(4)) + abs(CO(5))/60 + abs(CO(6))/3600
if any of CO(4), CO(5), CO(6) < 0: Ypos = -Ypos
Note that, although these are most suited to RA, Dec in
sexagesimal notation, they can be used for any type of
coordinate. The units are standard FITS units (e.g
degrees, m/sec, Hz, sec, etc.) except that right
ascensions are in hours of time.
PIXXY......Pixel coordinates, only the first two values are changed.
PIXXY(3)-PIXXY(7) are used to set the depth into the
image which may affect the first two coordinate values.
ERROR......1 => there was an error (namely PIXXY was outside the
image for the specified COORDINA or the input PIXXY was
outside the image). -1 => no error.