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: 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