Documentation on imframe

Task: imframe
Purpose: Interchange axes of a cube and decrease/enlarge the frame
Categories: map manipulation

  IMFRAME takes any part of an input cube, rotates it over any
  combination of 90 deg angles and writes the result anywhere in an
  output cube. This works on any cube whose longest axis is less than
  262144 pixels long.

Key: in
  The input image. No default.

Key: region
	Standard region keyword. Use `help region' for more information.

Key: box
  Some subcommands of the region keyword work only nicely on 3-d cubes.
  This is too limited for imframe, so an alternative keyword is provided
  for other cases, which is less fancy than region= but it does the job.
  The values to be given are a list of ranges for each coordinate axis,
  in relative pixel coordinates, in the order
    xmin,xmax,ymin,ymax,...
  etc. c  Note that this is different from the standard region order
  xmin,ymin,xmax,ymax.  
  The default is to take the whole cube. box= and region= are mutually
  exclusive.

Key: out
  The output image. No default.

Key: frame
  The size of the output dataset, The values to be given are a list of
  ranges for each coordinate axis, in relative pixel coordinates, in the
  order
    xmin,xmax,ymin,ymax,...
  etc. Note that this is different from the standard region order
  xmin,ymin,xmax,ymax. The defined frame may be bigger or smaller than
  the input box. The values refer to the axes in the original ordering.
  If not given, the input box is assumed (from either region= or box=,
  whichever one was given).

Key: goal
  The new axis ordering in terms of the old axis ordering: i.e. 'zxy'
  makes the original 'z'-axis the 'x'-axis of the output. It is only
  necessary to give the axes that are changed, the other axes are
  concatenated to the list, i.e. 'z' would do just as well in the
  example above. The default is not to exchange axes. Precede an
  axisname with a - to reverse the direction.