Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


  >  Docs Center  >  Libraries  >  ASTROLIB  >  GSSSXYAD

GSSSXYAD

GSSSXYAD

Name


      GSSSXYAD

Purpose


      Convert (X,Y) coordinates in a STScI Guide Star image to RA and Dec

Explanation


      The sky coordinates may be printed and/or returned in variables.

Calling Sequence


      GSSSxyad, gsa, x, y, ra, dec, [ /PRINT ]

Input


      GSA - The GSSS Astrometry structure extracted from a FITS header
              by GSSSEXTAST
      X - The X pixel coordinate(s) of the image, scalar or vector
      Y - The Y pixel coordinate(s) of the image, scalar or vector

Output


      RA - The RA coordinate of the given pixel(s) in *degrees*
      DEC - The DEC coordinate of the given pixel(s) in *degrees*
      Both RA and Dec will be returned as double precision

Optional Keyword Input


      /PRINT - If this keyword is set and non-zero, then coordinates will be
              displayed at the terminal

Example


      Given a FITS header,hdr, from a GSSS image, print the astronomical
      coordinates of (X,Y) = (200.23, 100.16) at the terminal
      IDL> GSSSExtast, hdr, gsa ;Extract astrometry structure
      IDL> GSSSxyad, gsa, 200.23, 100.16, /print

Notes


      For most purpose users can simply use XYAD, which will call GSSSXYAD
      if it is passed a GSSS header.

Procedures Called


      ASTDISP - print RA, Dec in a standard format

History


      01-JUL-90 Version 1 written by Eric W. Deutsch
      Vectorized Code W. Landsman March, 1991
      14-AUG-91 Fixed error which caused returned RA and DEC to be off by
      -.5 pixels in both X,Y. Now X,Y follows same protocol as ADXY.
      20-AUG-91 Modified to use AstDisp procedure.
      June 94 Added /PRINT keyword instead of PRFLAG W. Landsman June 94
      Converted to IDL V5.0 W. Landsman September 1997
      29-JUN-99 Added support for AMD[X,Y]1[2-3] for DSS images by E. Deutsch



© 2018 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us