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.