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


  >  Docs Center  >  Libraries  >  ASTROLIB  >  GSSSADXY

GSSSADXY

GSSSADXY

Name


      GSSSADXY

Purpose


      Converts RA and DEC (J2000) to (X,Y) for an STScI GuideStar image.

Explanation


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

Calling Sequence


      GSSSADXY, GSA, Ra,Dec, [ X, Y, /Print ]

Input


      GSA - the GSSS Astrometry structure created by GSSSEXTAST
      RA - the RA coordinate(s) in *degrees*, scalar or vector
      DEC - the DEC coordinate(s) in *degrees*, scalar or vector

Optional Keyword Input


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

Output


      X - the corresponding X pixel coordinate(s), double precision
      Y - the corresponding Y pixel coordinate(s), double precision
      X and Y will be in IDL convention (first pixel 0,0)

Example


      Given a FITS header, hdr, from the STScI Guidestar Survey, determine
      the X,Y coordinates of 3C 273 (RA = 12 29 6.7 +02 03 08)
      IDL> GSSSEXTAST, hdr, gsa ;Extract astrometry structure
      IDL> GSSSADXY, gsa, ten(12,29,6.7)*15,ten(2,3,8),/print

Notes


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

Procedures Called


      ASTDISP - Print RA, Dec in standard format

History


      10-JUL-90 Version 1 written by Eric W. Deutsch
              Derived from procedures written by Brian McLean
      Vectorized code W. Landsman March, 1991
      14-AUG-91 Fixed error which caused returned X and Y to be .5 pixels too
              large. Now X,Y follows same protocol as ADXY.
      June 1994 - Dropped PRFLAG parameter, added /PRINT W. Landsman (HSTX)
      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
      Reduce memory requirements for large arrays D. Finkbeiner April 2004
      Remove



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