next up previous
Next: AST_PERMMAP - Create a PermMap
Up: AST Routine Descriptions
Previous: AST_PCDMAP - Create a PcdMap

AST_PERMAXES - Permute the axis order in a Frame   

Description:
This routine permutes the order in which a Frame's axes occur.
Invocation:
CALL AST_PERMAXES( THIS, PERM, STATUS )

Arguments:
THIS = INTEGER (Given)
Pointer to the Frame.
PERM( * ) = INTEGER (Given)
An array with one element for each axis of the Frame (Naxes attribute). This should list the axes in their new order, using the original axis numbering (which starts at 1 for the first axis).
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • Only genuine permutations of the axis order are permitted, so each axis must be referenced exactly once in the PERM array.
  • If successive axis permutations are applied to a Frame, then the effects are cumulative.



next up previous
Next: AST_PERMMAP - Create a PermMap
Up: AST Routine Descriptions
Previous: AST_PCDMAP - Create a PcdMap

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

Copyright (C) 2003 Central Laboratory of the Research Councils