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.