DATAMANIP commands


PROGRAM NAME

kcptoval - Copy One Segment Into Value Segment of Output

DESCRIPTION

This routine copies a segment from the source object and put it into the destination object's value segment. The higher dimensions will be rolled into the elements dimension of the value segment. If the dimension is less than 5, the data will be copied into the lowest order dimension of the value segment first, then the next, etc. and the higher dimensions ignored. If the value segment exists in the source object it will be replaced.

Only the size and data type attribute will be changed in the value segment, all others will not be transferred. If the value does not yet exist, then the dimension and index order of the value segment will be set to the defaults: 5 and width, height, depth, time, and elements. If it does exist the index order will not be changed.

REQUIRED ARGUMENTS

-i
type: infile
desc: 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.