AIPS HELP file for COSTAR in 31DEC22
As of Fri Dec 1 12:17:47 2023
COSTAR: Verb to plot a symbol at a coordinate on the TV
INPUTS
COORDINA Coordinate in image
SYMBOL 0.0 24.0 Symbol type: 1 plus 2 X,
3 circle, 4 box, see HELP
STFACTOR -9999.0 9999.0 Scale radius = 2 pixels *
STFACTOR
GRCHAN 0.0 8.0 Graphics channel 0 => 2.
Choice of image to plot is done via TV cursor
(if more than one image of a map is visible)
HELP SECTION
COSTAR
Type: Verb
Use: COSTAR will plot a symbol at a coordinate position for an image on
the TV. If there is more than one image (of a map) visible on the
TV, the routine will ask the user to position the cursor on any
part of the image he wishes starred and then to press any button.
Adverbs:
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.
SYMBOL......1: Plus sign 12: Five pointed star
2: Cross (X) 13: Star of David
3: Circle 14: Seven-pointed star
4: Box 15: Eight-pointed star
5: Triangle 16: Nine-pointed star
6: Diamond 17: Ten-pointed star
7: Pentagon 18: 11-pointed star
8: Hexagon 19: 12-pointed star
9: Septagon 20: 13-pointed star
10: Octagon 21: 14-pointed star
11: Nine-gon 22: Plus (X) with gap
23: Vertical line
24 Cross with gap
STFACTOR....Scale factor used to multiply symbol size: radius is
2 pixels * STFACTOR.
GRCHAN......Graphics channel (1 - 7) to use for line drawing.
0 => 2.
EXPLAIN SECTION