ATL_FINDSKY

Locate any sky axes within a Frame

Description:

This routine searches the supplied Frame (which may be a CmpFrame) for a SkyFrame. If found, it returns a pointer to the SkyFrame, together with the indices (within the supplied Frame) of the longitude and latitude axes.

Invocation

CALL ATL_FINDSKY( FRAME, SKYFRAME, LATAX, LONAX, STATUS )

Arguments

FRAME = INTEGER (Given)
The Frame to be searched.
SKYFRAME = INTEGER (Returned)
A pointer to the SkyFrame contained within FRAME, if any. If no SkyFrame is found, AST__NULL is returned.
LATAX = INTEGER (Returned)
The index (one-based) of the celestial latitude axis in FRAME. Returned equal to zero if no SkyFrame is found.
LONAX = INTEGER (Returned)
The index (one-based) of the celestial lonitude axis in FRAME. Returned equal to zero if no SkyFrame is found.
STATUS = INTEGER (Given and Returned)
The global status.