band2vect(1)

PROGRAM
band2vect - reformats data stored in image format to a single-row file where each column represents a separate vector in the output file.

SYNTAX

band2vect

-i  input data file

-o  output (vector) file

[-V]
    Gives the version for band2vect

[-U]
    Gives the usage for band2vect

[-P]
    Prompts for command line options

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

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

DESCRIPTION
band2vect reformats data stored in a band type image format to a single-row of vectors or pixels. Each vector or pixel in the output file is comprised of a single band of data from the input image. The subrow size in the output file is set to reflect the number of rows in each band of the input image. Thus the size of each vector or pixel is determined by the number of rows and columns in each band of the input image. The number of vectors or pixels in the resulting output file is equal to the number of bands in the input image. Thus each vector of the output file represents a band of data from the input image. Each row of a band of data is stacked end to end as a vector in the resulting output file.

For example, if an input file contained 3 bands of data with 2 rows and 5 columns in each band, then the output file would contain 3 vectors or pixels with a dimension of 10. That is, each vector would contain the data from one band of the input image. The dimension of each vector is equal to the number of rows * columns from a band of the input image. The subrow size is set to the number of rows in each band, or 2 in this particular case. The subrow size is carried along in the image header so that it will be possible to reconstruct the image band format of this file (see vect2band).

The data storage type of the output image will be of the same type as the input image. This routine will accept any data storage type, except BIT.

The valid map schemes are NONE, ONEPERBAND, and SHARED. Map schemes of CYCLE and GROUP are not supported at this time. Note that a map scheme of GROUP may be appropriate for this transformation, but is not yet defined. A map scheme of GROUP could be used to define a map for a pixel that is represented as a vector in the output file.

Valid map scheme and map enable combinations include:

    single band image with map scheme of ONEPERBAND and a map enable of either FORCE or OPTIONAL.

    single band image with map scheme of SHARED and a map enable of either FORCE or OPTIONAL.

    multiband image with a map scheme of SHARED and a map enable of either FORCE or OPTIONAL.

    single or multiband image with a map scheme of NONE.

The map may also be removed from an image by using "vremmap", or the data may need to be mapped through the map using "vmapdata" prior to using this routine.

REQUIRED ARGUMENTS

-i  type: infile
    desc: input data file

-o  type: outfile
    desc: output (vector) file

OPTIONAL ARGUMENTS
none

EXAMPLES
band2vect -i input_file -o output_file

Creates an output file which has one row and each column represents a single vector or pixel. The dimension of each vector is equal to the number of rows * columns in the input_file. The number of columns in the output file is equal to the number of bands in the input image.

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), lband2vect(3) vremmap(1), vmapdata(1), vect2band(1).

RESTRICTIONS
Will not operate on VFF_TYP_BIT data files.

Will not work with the following map_scheme combinations:

Multiband image with MS_ONEPERBAND and MAP_OPTIONAL

Multiband image with MS_ONEPERBAND and MAP_FORCE

Any map scheme with MS_CYCLE or MS_GROUP

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