vbandspt3(1)

PROGRAM
vbandspt3 - Extract 3 data bands from a multiband image

SYNTAX

vbandspt3

-i  input image filename

[-o1]
    output image filename

[-o2]
    output image filename

[-o3]
    output image filename

[-b]
    Data band number to extract

[-V]
    Gives the version for vbandspt3

[-U]
    Gives the usage for vbandspt3

[-P]
    Prompts for command line options

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

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

DESCRIPTION
vbandspt3 extracts 3 bands from an image and creates new images containing only one band. The 3 bands extracted start with the band number Specified by the -b option. The band numbering scheme starts at zero.

The map is carried along with the new image, the map scheme will become ONEPERBAND regardless of the input image's map scheme. The comment field of the new image will read the same as the comment field of the input image, except it is append with the band number and the filename from which the band was taken.

The output files are optional arguments, if all or any output files names are not specified, vbandspt3 will use the input filename with a suffix appended to it as the output filenames. The suffixes are determined by the color space model:

NONE or GENERIC:
    input_filename.1
    input_filename.2
    input_filename.3

ntscRGB or genericRGB or cieRGB:
    input_filename.R
    input_filename.G
    input_filename.B

ntscYIQ:
    input_filename.Y
    input_filename.I
    input_filename.Q

ntscCMY:
    input_filename.C
    input_filename.M
    input_filename.Y

HLS:
    input_filename.H
    input_filename.L
    input_filename.S

HSV:
    input_filename.H
    input_filename.S
    input_filename.V

IHS:
    input_filename.I
    input_filename.H
    input_filename.S

cieUVW or cieucsUVW:
    input_filename.U
    input_filename.V
    input_filename.W

cieucsSOW:
    input_filename.S
    input_filename.O
    input_filename.W

cieucsLab:
    input_filename.L
    input_filename.a
    input_filename.b

cieucsLuv:
    input_filename.L
    input_filename.u
    input_filename.v

The -b option determines which data band to extract. The default is 1.

REQUIRED ARGUMENTS

-i  type: infile
    desc: input image filename

OPTIONAL ARGUMENTS

-o1 type: outfile
    desc: output image filename

-o2 type: outfile
    desc: output image filename

-o3 type: outfile
    desc: output image filename

-b  type: integer
    desc: Data band number to extract
    default: 0
    bounds: value >= 0

EXAMPLES
vbandspt3 -i test

The file test must contain at least 3 data bands, and if it had a color space model = HLS, the output files would be: test.H, test.L, and test.S. If it had no color space model, the output files would be: test.1, test.2 and test.3. In this case bands 0, 1, and 2 would be extracted.

vbandspt3 -i test -o1 bee -o2 junk -o3 yy -b 3

The image "bee" would be band number 3, "junk" would be band number 4 and "yy" would be band number 5. Thus, the image must contain at least 5 data bands.

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3)

RESTRICTIONS

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