AIPS NRAO AIPS HELP file for COSTAR in 31DEC24



As of Sat Jun 15 7:27:22 2024


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......Types supported are
              1: Plus sign           13: Star of David
              2: Cross (X)           14: Seven-pointed star
              3: Circle              15: Eight-pointed star
              4: Box                 16: Nine-pointed star
              5: Triangle            17: Ten-pointed star
              6: Diamond             18: 11-pointed star
              7: Pentagon            19: 12-pointed star
              8: Hexagon             20: 13-pointed star
              9: Septagon            21: 14-pointed star
              10: Octagon            22: Plus (+) with gap
              11: Nine-gon           23: Cross (X) with gap
              12: Five pointed star  24: Vertical line
  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


AIPS