RETRO commands
PROGRAM NAME
vcast - Upconvert All Inputs to the Highest Input Data Type (K1)
DESCRIPTION
vcast
will upconvert or upcast each input image to the highest input image
data type. Optionally, the user may elect to upcast all images to
a specified data type, as long as it is a data type that is equal to
or greater than the highest data type of the input images. If the
user tries to select a data type that is lower than the highest
data type of the input images, an error message will be produced
indicating that down casting is not allowed.
There are no restrictions as to the input image data types. The data
types can range from BIT to DOUBLE. The input images may contain any
combination of sizes or number of data bands. All map information from
each input image is transferred to the corresponding output image.
Note that when converting from type BIT to BYTE, the output values
will be 0 or 1. This is different from the results one would obtain
using the defaults with kconvert. In trying to preserve the
integrity of the data, vcast scales the data by 1.
REQUIRED ARGUMENTS
- -i1
-
type: infile
desc: input image 1
- -i2
-
type: infile
desc: input image 2
- -o1
-
type: outfile
desc: output image 1
- -o2
-
type: outfile
desc: output image 2
OPTIONAL ARGUMENTS
- -i3
-
type: infile
desc: input image 3
default: {none}
- -i4
-
type: infile
desc: input image 4
default: {none}
- -i5
-
type: infile
desc: input image 5
default: {none}
- -t
-
type: string toggle
desc: Select data type [default = Auto Upcast to Highest Input Data Type]
default: byte
allowed values:
- byte (choose byte data type),
- int (choose integer data type),
- complex (choose complex data type),
- short (choose short data type),
- float (choose float data type),
- or double (choose double data type)
- -o3
-
type: outfile
desc: output image 3
default: {none}
- -o4
-
type: outfile
desc: output image 4
default: {none}
- -o5
-
type: outfile
desc: output image 5
default: {none}
EXAMPLES
vcast -i1 image.bit -i2 image.float -o1 image1 -o2 image2
converts both input images to data type FLOAT. The optional data
type argument was not selected, so auto convert was used to cast
both images to the highest data type of the input images (in this case
FLOAT).
vcast -i1 image.bit -i2 image.byte -i3 image.short -o1 img1 -o2 img2 -o3 img3 -t float
converts each input image to data type FLOAT. The optional data
type argument was used to upcast all input images to data type
FLOAT.
SEE ALSO
kconvert
RESTRICTIONS
vcast
only scales the input data by 1, and will only upconvert the data.
REFERENCES
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.