- ←Prev
- AST
A Library for Handling
World Coordinate Systems
in Astronomy - Next→
- TOC ↑
Description:
This function
looks for corresponding axes within two supplied Frames. An array of integers is returned that
contains an element for each axis in the second supplied
Frame. An element in this array will be set
to zero if the associated axis within the second Frame has no corresponding axis within
the first Frame. Otherwise, it will be set to the index (a non-zero positive integer) of the
corresponding axis within the first supplied Frame.
Invocation
CALL AST_MATCHAXES( FRM1,
FRM2, AXES, STATUS )
Arguments
FRM1 = INTEGER (Given)
Pointer to the first
Frame.
FRM2 = INTEGER (Given)
Pointer to the second Frame.
AXES = INTEGER(
)
(Returned)
An integer array in which to return the indices of the axes (within the first Frame) that
correspond to each axis within the second Frame.
Axis indices start at 1. A value of zero will be stored
in the returned array for each axis in the second Frame that has no corresponding axis in the first
Frame.
The number of elements in this array must be greater than or equal to the number of axes in the
second Frame.
STATUS = INTEGER (Given and Returned)
The global status.
Applicability
Frame
This function applies to all Frames.
Notes:
-
Corresponding axes are identified by the fact that a Mapping can be found between them using
AST_FINDFRAME or AST_CONVERT. Thus, " corresponding axes" are not necessarily identical. For
instance, SkyFrame axes in two Frames will match even if they describe different celestial coordinate
systems
Copyright (C) 2021 East Asian Observatory
- ←Prev
- AST
A Library for Handling
World Coordinate
Systems
in Astronomy - Next→
- TOC ↑