
vect2band(1)                 Khoros                  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 sin-
     gle 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 transforma-
     tion, 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 deter-
     mined 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.

Khoros                    Release: 1.0                          1

