vect2band(1)

PROGRAM
vect2band - reformats data stored in vector format to a file where each vector is represented as a single band in the output file.

SYNTAX

vect2band

-i  input (vector) data file

-o  output (image) file

[-V]
    Gives the version for vect2band

[-U]
    Gives the usage for vect2band

[-P]
    Prompts for command line options

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

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

DESCRIPTION
vect2band reformats data stored in vector format to a file where each vector of the input file is represented as a single band in the output file. The number of pixels in each band of the output image is determined by the dimension of each vector (ie. number of bands) in the input image. The number of rows in the output image is set by the value of the subrow size from the input image. The number of columns in each band of the output image is found by dividing the dimension of each input vector (pixel) by the subrow size. The number of bands in the output image is determined by the number of vectors (rows*cols) of the input file.

For example, if an input file contained 5 vectors (pixels) of dimension 20 with a subrow size of 2, then the output file would contain a 5 band image with each band comprised of 2 rows and 10 columns.

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

Valid combinations of map scheme and map enable include:

    map scheme of SHARED with map enable of FORCE or OPTIONAL

    map scheme of NONE with map enable of OPTIONAL

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

REQUIRED ARGUMENTS

-i  type: infile
    desc: input (vector) data file

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

OPTIONAL ARGUMENTS
none

EXAMPLES
vect2band -i input_file -o output_file

Creates an output file where each band represents a single vector. The size of each band in the output file, is determined by the dimension of each vector (ie. number of bands in input image) in the input image. The number of columns in the output file is equal to the dimension of the input vector (ie. pixel) divided by the subrow size. For example, if the input file contained 3 vectors (pixels) of dimension 20 and a subrow size of 2, then the resulting output file would contain 3 bands with 2 rows and 10 columns of data.

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), lvect2band(3) vremmap(1), vmapdata(1), band2vect(1).

RESTRICTIONS
Will not operate on VFF_TYP_BIT data files.

Will not work with a map_scheme of ONEPERBAND, CYCLE, or GROUP.

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