DATAMANIP commands


PROGRAM NAME

kconvert - Convert Data Storage Type (Optional Scale & Offset)

DESCRIPTION

This program will convert, offset and/or scale the specified data segment from the input object and create a new object containing the modified segment and all the other segments, which will be unmodified. Data is scaled first, and then the offset is applied.

Any of the polymorphic segments can be specified with a flag. To specify another segment you use the -segment option, and specify the segment name: "segment1".

Be aware that data type conversion is accomplished via casting. Therefore, when converting between certain data types, for example between unsigned and signed, unexpected results may occur. In these cases, it is recommended that the data be preprocessed to bring the values within the proper range before converting the data type.

REQUIRED ARGUMENTS

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

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

-type
type: list
desc: Convert to specified data type
default: 0 "Propagate Input Type"
-scale
type: double
desc: Real scale factor
default: 1
bounds: no range checking
-roff
type: double
desc: Real offset value
default: 0
bounds: no range checking
-ioff
type: double
desc: Imaginary offset value
default: 0
bounds: no range checking

EXAMPLES

SEE ALSO

DATAMANIP::knormal(1)

RESTRICTIONS

Data type conversion is accomplished via casting. Therefore, when converting between certain data types, for example between unsigned and signed, unexpected results may occur. In these cases, it is recommended that the data be preprocessed to bring the values within the proper range before converting the data type.

REFERENCES

COPYRIGHT

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