DATAMANIP commands
PROGRAM NAME
kcpfromval - Copy Value Segment Into One Segment of Output
DESCRIPTION
This routine copies the five dimensional value segment from the source
object to the specified segment specified in the
destination_object. The data will be copied into the lowest order
dimension of the destination segment, then the next order will be
used, and the next, and so forth, until all the value data is copied.
If the dimensionality of the destination is less than five, then the
last dimension of the destination segment will have all the higher
order dimensions rolled into it.
If segment is specified to be a polymorphic segment by setting one of
the toggles (value, location, time, mask, map) then the segment
dimensionalities and index orders specified by the polymorphic model
will be used. If the segment is not one of the polymorphic segments,
then the dimensionality of the value segment will be used, and the
segment will be given an index order of width, height, depth, time, and
elements.
Only the size and data type attribute will be changed, all others will
not be transferred to the destination segment. If the segment does
not exist in the destination and is not a polymorphic segment the
dimension and index order will be set. If it is a polymorphic segment
the default polymorphic dimension and index order will be used.
REQUIRED ARGUMENTS
- -i
-
type: infile
desc: Source input file
- -o
-
type: outfile
desc: output file
Mutually Exclusive Group; you must specify ONE of:
- -val
-
type: flag
desc: If -val flag is selected, operate on Value segment
OR
- -map
-
type: flag
desc: If -map flag is selected, operate on map segment
OR
- -mask
-
type: flag
desc: If -mask flag is selected, operate on Mask segment
OR
- -loc
-
type: flag
desc: If -loc flag is selected, operate on Location segment
OR
- -time
-
type: flag
desc: If -time flag is selected, operate on Time segment
OR
- -segment
-
type: string
desc: Perform operation on user specified segment
default: {none}
OPTIONAL ARGUMENTS
none
EXAMPLES
SEE ALSO
RESTRICTIONS
Results guaranteed only if dimension of destination segment is 5.
Other dimensions are not tested and may produce poor results.
REFERENCES
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.