DATAMANIP commands


PROGRAM NAME

ktranspose - Transpose Data across Dimensions

DESCRIPTION

ktranspose will swap data across two dimensions. Any of the polymorphic dimensions of WIDTH (W), HEIGHT (H), ELEMENTS (E), DEPTH (D), and TIME (T), can be switched with another.
\f(CW

'depth' planes of value data ____/ ____ ____ +---+| +---+| +---+| The value segment is a time 'height'--| || | || ... | || series of volumes. +---+ +-|-+ +---+ | | 'width' each element in the value value segment is a vector of size 'elements'.

The dimensions which should be transposed are specified. On the graphical user interface accessible via cantata, these flags are represented as a series of buttons, with one for each dimension. On the command line, these flags are specified as a letter : w,h,d,t,e. Only two flags should be specified. The dimensions indicated by these two flags will be transposed. For example,

ktranspose -i infile -o outfile -w -h
will cause the height dimension and the width dimension to be switched. If the input file has width = 4, height = 2, the output dimension will have width = 2, height = 4.

Map Data If the source object has map data, the map data cannot have depth, time, or elements dimensions of greater than one. The map width and height dimensions can be any size.

Location & Time Data If the source object has rectilinear or curvilinear location or time data, the orientation operator will fail. If the source object has uniform location data, orientation will continue, but the location data will not be modified to reflect the reorientation.

Map Data If the object has mask data, it will be transposed along with the value data.

Failure Modes The transpose operator will fail if the source object does not contain value data, or if it contains rectilinear or curvilinear location or time data.

REQUIRED ARGUMENTS

-i
type: infile
desc: input data object
-o
type: outfile
desc: resulting data object

OPTIONAL ARGUMENTS

Group; specify AT LEAST ONE of:

-w
type: flag
desc: swap width and one other dimension
AND/OR
-h
type: flag
desc: swap height with one other dimension
AND/OR
-e
type: flag
desc: swap elements with one other dimension
AND/OR
-d
type: flag
desc: swap depth with one other dimension
AND/OR
-t
type: flag
desc: swap time with one other dimension

EXAMPLES

SEE ALSO

kaxis, korient

RESTRICTIONS

This program has not yet been updated to completely support the polymorphic data model.

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.