RETRO commands


PROGRAM NAME

vbandsp1 - Extract a Specified Data Band from a Multiband Image (K1)

DESCRIPTION

NOTE: Program will NOT execute! vbandsp1 functionality is replaced by the DATAMANIP::kextact operator. To get the same result using kextract, set the elements size to 1 (-esize 1), and the elements offset (-eoff) to the old band number (-b).

vbandsp1 extracts a specified band from an image and creates a new image containing only that band. The map is also 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 data band number option determines which data band to extract. NOTE: band numbering begins with 0.

REQUIRED ARGUMENTS

-i
type: infile
desc: input image filename
-o
type: outfile
desc: output image filename

OPTIONAL ARGUMENTS

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

EXAMPLES

vbandsp1 -i ball.rgb.xv -o ball.b.xv -b 2

This will extract the third band (the band representing blue), from the 3 band rgb input image. The result is a 1 band image stored as ball.b.xv.

SEE ALSO

DATAMANIP::kextract, RETRO::vbandsp3

RESTRICTIONS

REFERENCES

COPYRIGHT

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