next up previous 264
Next: AST_MATHMAP - Create a MathMap
Up: AST Routine Descriptions
Previous: AST_MASKX - Mask a region of a data grid


AST_MATCHAXES - Find any corresponding axes in two Frames

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.
Class 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


next up previous 264
Next: AST_MATHMAP - Create a MathMap
Up: AST Routine Descriptions
Previous: AST_MASKX - Mask a region of a data grid

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