re-orders the pixel axes of an NDF
, together with all related information (AXIS
structures, and the axes of all co-ordinate Frames
stored in the WCS
component of the
permaxes in out perm
IN = NDF (Read)
The input NDF
OUT = NDF (Write)
The output NDF data structure.
A list of integers defining how the pixel axes are to be
permuted. The list must contain one element for each pixel axis in the NDF. The
first element is the index of the pixel axis within the input NDF which is to
become Axis 1 in the output NDF. The second element is the index of the pixel
axis within the input NDF which is to become Axis 2 in the output NDF, etc.
Axes are numbered from 1.
TITLE = LITERAL (Read)
for the output
NDF. A null value will cause the title of the NDF supplied for Parameter IN to
be used instead.
permaxes a b [2,1] Swaps the axes in
the two-dimensional NDF called a, to produce a new two-dimensional NDF called
permaxes a b [3,1,2] Creates a new three-dimensional NDF called b in
which Axis 1 corresponds to Axis 3 in the input three-dimensional NDF called a,
Axis 2 corresponds to input Axis 1, Axis 3 corresponds to input Axis 2.