Program:       TRANSPOSE

Purpose:       Copy a input set to an output set of which the axis
               order may be different. This task may be an alternative
               for AXSWAP.

Category:      MANIPULATION, HEADER

File:          transpose.src

Author:        J.P. Terlouw

Keywords:

   INSET=      Give input set:
               The name of the input set.

   OUTSET=     Give output set:
               The name of the output set. If this set already exists,
               an error message is displayed and another opportunity is
               given to enter the output set name.

   AXPERM=     Give new axis order:
               The axis names in their new order. The input is
               case-insensitive and minimal matching is supported.

Description:   The program transposes a set according to the specifications
               given in the keywords. All descriptor items are transferred
               to their correct position in the output set.

Example:
               <USER> transpose
               <USER> TRANSPOSE INSET=aurora
               Set aurora has 3 axes
               RA---NCP        from    -50 to     49
               DEC--NCP        from    -50 to     49
               VELO-HEL        from     21 to    121
               <USER> TRANSPOSE OUTSET=eos
               <USER> TRANSPOSE AXPERM=vel ra dec
               <STATUS>  TRANSPOSE   +++ FINISHED +++

Updates:       Jan 27, 2009: JPT, Document created.