vcast(1)

PROGRAM
vcast - Upconvert all images to the highest input image data type.

SYNTAX

vcast

-i1 input image #1

-i2 input image #2

-o1 output image #1

-o2 output image #2

[-i3]
    input image #3

[-i4]
    input image #4

[-i5]
    input image #5

[-o3]
    output image #3

[-o4]
    output image #4

[-o5]
    output image #5

[-t]
    Select data type [default = Auto Upcast to Highest Input Data Type]:
     'byte' (choose byte data type),
     'short' (choose short data type),
     'int' (choose integer data type),
     'float' (choose float data type),
     'complex' (choose complex data type),
      or 'double' (choose double data type)
       [default = byte]

[-V]
    Gives the version for vcast

[-U]
    Gives the usage for vcast

[-P]
    Prompts for command line options

[-A [file1]]
    Creates the answer file called vcast.ans or file1

[-a [file1]]
    Uses vcast.ans or file1 as the answer file

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 vconvert. 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

-i4 type: infile
    desc: input image #4

-i5 type: infile
    desc: input image #5

-o3 type: outfile
    desc: output image #3

-o4 type: outfile
    desc: output image #4

-o5 type: outfile
    desc: output image #5

-t  type: string
    desc: Select data type [default = Auto Upcast to Highest Input Data Type]
    allowed values:
     'byte' (choose byte data type),
     'short' (choose short data type),
     'int' (choose integer data type),
     'float' (choose float data type),
     'complex' (choose complex data type),
      or 'double' (choose double data type)

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
intro(1), verror(3), vgparms(3), vutils(3), lvcast(3) vconvert(1)

RESTRICTIONS
vcast only scales the input data by 1, and will only upconvert the data.

COPYRIGHT
Copyright 1991, University of New Mexico. All rights reserved.