RETRO commands


PROGRAM NAME

vbandsp3 - Extract 3 Bands from a Multiband Image (K1)

DESCRIPTION

vbandsp3 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 starting band number 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, vbandsp3 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

-b
type: integer
desc: Data band number to extract
default: 0
bounds: value >= 0
-o1
type: outfile
desc: output image filename
default: {none}
-o2
type: outfile
desc: output image filename
default: {none}
-o3
type: outfile
desc: output image filename
default: {none}

EXAMPLES

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

vbandsp3 -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

RESTRICTIONS

REFERENCES

COPYRIGHT

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