\f(CW+-----------+ +-----------+ E /-----------/| E /-----------/| /-----------/|| /-----------/|| +-----------+----+||| +-----------+----+||| E /-----------/| |||| E /-----------/| |||| /-----------/|| |||| /-----------/|| |||| +-----------+||| |||| +-----------+||| |||| | |||| ||/ / | |||| ||/ / H | ||||----+/ / H | ||||----+/ / | |||| D . . . | |||| D | ||/ / | ||/ / +-----------+/ / +-----------+/ / W W
<----------------------------- T ------------------------------->
The new orientation is defined by setting the OLD DIMENSIONS to NEW DIMENSIONS flags. On the graphical user interface accessible via cantata, these flags are represented as a matrix of buttons, where each row of the matrix represents the set of dimensions that will be oriented to the new dimension. On the command line, these flags are specified by two letter combinations of w,h,d,t,e -- the first letter indicates the source, or old, dimension, the second indicates the destination, or new, dimension. For example,
korient -i infile -o outfile -hwwill cause the height dimension (along with the width dimension) to be reoriented along the width dimension. If the input file has width = 4, height = 2, as shown below, the output dimension will have width = 8, height = 1.
\f(CW Input Data: 1 2 3 4 5 6 7 8 Output Data: 1 2 3 4 5 6 7 8
To transpose the same data set, one would execute
korient -i infile -o outfile -wh -hw
\f(CW Output Data: 1 5 2 6 3 7 4 8
As is illustrated above, data existing on a set of dimensions can be reoriented to a single dimension. When this occurs, data will be arranged according to the following dimensional order: Width, Height, Elements, Depth, Time.
If defaults (korient -i infile -o outfile -ww, -hh, -ee, -dd, -tt) are used, no change in orientation will occur between the input and output data files.
Implementation issue: If data on a dimension is not being transferred to another dimension, first set that dimension for no transfer. For example, if no flags have been set to orient width data along another dimension, the -ww flag is set. Then build the set of dimensions that will be oriented along the new dimension by going vertical on the user interface matrix. For example, the two letter flags that end in w that have been specified on the command line indicate the dimensions that will be reoriented.
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 reoriented along with the value data.
Failure Modes The orientation operator will fail if the source object does not contain value data, or if it contains rectilinear or curvilinear location or time data.
Mutually Exclusive Group; you must specify ONE of:
OR
OR
OR
OR
Mutually Exclusive Group; you must specify ONE of:
OR
OR
OR
OR
Mutually Exclusive Group; you must specify ONE of:
OR
OR
OR
OR
Mutually Exclusive Group; you must specify ONE of:
OR
OR
OR
OR
Mutually Exclusive Group; you must specify ONE of:
OR
OR
OR
OR