AIPS NRAO AIPS HELP file for TRANS in 31DEC24



As of Wed Oct 9 3:52:50 2024


TRANS: Task to transpose a subimage of an up to 7-dim. image

INPUTS

INNAME                             Input name(name).
INCLASS                            Input name(class).
INSEQ           0.0      9999.0    Input name(seq. #). 0=>high
INDISK                             Input disk drive #. 0=>any
OUTNAME                            Output name(name).
OUTCLASS                           Output name(class).
OUTSEQ         -1.0      9999.0    Output name(seq. #).
                                     0 => highest unique
OUTDISK                            Output image disk drive #
                                     0 => highest with room
BLC             0.0      4096.0    Bottom left corner of image
                                     0 => entire image
TRC             0.0      4096.0    Top right corner of image
                                     0 => entire image
TRANSCOD                           New axis order in terms of
                                   input axis numbers
BADDISK                            Disks to avoid for scratch

HELP SECTION

TRANS
Type: Task
Use:  TRANS will perform arbitrary matrix transpositions on
      images of up to 7 dimensions.  It will also reverse
      the order of pixels on any specified axes and will
      carry out these operations on a subarray of the input
      image if so instructed.
Adverbs:
  INNAME......Input name of image(name).    Standard defaults.
  INCLASS.....Input name of image(class).   Standard defaults.
  INSEQ.......Input name of image(seq. #).  0 => highest.
  INDISK......Disk drive # of image.        0 => any.
  OUTNAME.....Output name of image(name).   Standard defaults.
  OUTCLASS....Output name of image(class).  Standard defaults.
  OUTSEQ......Output name of image(seq. #). 0 => highest unique.
  OUTDISK.....Disk drive # of Output image. 0 => highest
              with space.
  BLC.........The bottom left-hand pixel of the input image
              to be included.  0 => 1.
  TRC.........The top right-hand pixel of the input image
              to be included.  0 => high pixel # on that axis
  TRANSCOD....The new axis order in terms of the old axis order
              numbers: i.e. '312' means make input axis 3 the
              first output axis, input axis 1 the second output
              axis, etc.  Use a - to reverse the pixel order on
              an axis, e.g. '3-12', '-312', '-31-2' etc.
              TRANSCOD may contain blank and comma separators as well
              as the minus sign and numbers 1 through 7 only.  All
              input axes having more than 1 pixel must be included in
              TRANSCOD and may be included only once.
  BADDISK.....Disk(s) to avoid in creating scratch files.

EXPLAIN SECTION

TRANS:  Task which interchanges and/or reverses axes in a cube.
DOCUMENTOR:  J.H.van Gorkom NRAO/VLA
RELATED PROGRAMS: MCUBE, MOMNT, SLICE, PROFL

                          PURPOSE

     TRANS changes the order of the axes in a cube and can also
reverse the pixel order of an axis.  For example, if one has a
cube of (RA,DEC) maps with frequency on the third axis, one can
transpose it into a set of (RA,FREQ) maps with declination on
the third axis.  This then makes it possible to do profile
analysis on the maps with MOMNT, to plot single profiles with
SLICE and SL2PL/LWPLA, or to plot a set of profiles with PROFL.
     The pixel order of an axis can be reversed.  This is useful
for example if one has made a cube with increasing frequency on
one axis; by reversing the pixel order one gets the data in
order of increasing velocity.  TRANS can be used on two
dimensional images in order to transpose the image.

                          COMMENT

     TRANS works faster on data in integer (I*2) format, and
most software likely to be used after TRANS requires this
format.  MCUBE creates cubes in real (R*4) format however. It is
therefore worth using CNVRT to convert cube data from real
format to integer format before running TRANS. (See also the
EXPLAIN file for CNVRT).

AIPS