next up previous 264
Next: AST_GETREGIONBOUNDS - Returns the bounding box of Region
Up: AST Routine Descriptions
Previous: AST_GETMAPPING - Obtain a Mapping that converts between two Frames in a FrameSet


AST_GETREFPOS - Return the reference position in a specified celestial coordinate system

Description:
This routine returns the reference position (specified by attributes RefRA and RefDec) converted to the celestial coordinate system represented by a supplied SkyFrame. The celestial longitude and latitude values are returned in radians.
Invocation:
CALL AST_GETREFPOS( THIS, FRM, LON, LAT, STATUS )
Arguments:
THIS = INTEGER (Given)
Pointer to the SpecFrame.
FRM = INTEGER (Given)
Pointer to the SkyFrame which defines the required celestial coordinate system. If AST__NULL is supplied, then the longitude and latitude values are returned as FK5 J2000 RA and Dec values.
LON = DOUBLE PRECISION (Returned)
The longitude of the reference point, in the coordinate system represented by the supplied SkyFrame (radians).
LAT = DOUBLE PRECISION (Returned)
The latitude of the reference point, in the coordinate system represented by the supplied SkyFrame (radians).
STATUS = INTEGER (Given and Returned)
The global status.
Notes:
  • Values of AST__BAD will be returned if this function is invoked with STATUS set to an error value, or if it should fail for any reason.


next up previous 264
Next: AST_GETREGIONBOUNDS - Returns the bounding box of Region
Up: AST Routine Descriptions
Previous: AST_GETMAPPING - Obtain a Mapping that converts between two Frames in a FrameSet

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk

Copyright (C) 2009 Science \& Technology Facilities Council