
vect2row(1)                  Khoros                   vect2row(1)

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

SYNTAX
     vect2row

     -i             input data file

     -o             output (vector) file

     [-s]           Extract only one vector (1 = yes, 0 = no)

     [-x]           horizontal (x) offset of voxel

     [-y]           vertical (y) offset of voxel

     [-V]           Gives the version for vect2row

     [-U]           Gives the usage for vect2row

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vect2row reformats data stored in vector (multi-band) format
     to a single-band file where each vector is represented as a
     separate row in the output file.  The number of rows in the
     resulting vector image will be the product of the original
     row and column sizes (ie., the total number of vectors), and
     the number of columns in the resulting image will be the
     vector dimension, or number of bands, found in the original
     file.

     The user has the option to specify that only one vector be
     extracted.  In this case, the row and column position must
     be specified to define the location of the pixel.  (The
     upper left hand pixel in the image is indexed by [0][0].)

     If the input is single-band, vect2row prints an error state-
     ment indicating that the file cannot be operated on and
     exits.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input data file

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

OPTIONAL ARGUMENTS
     -s     type: boolean
            desc: Extract only one vector (1 = yes, 0 = no)
            default: false

     -x     type: integer
            desc: horizontal (x) offset of voxel
            default: 0
            bounds: value >= 0

     -y     type: integer
            desc: vertical (y) offset of voxel
            default: 0
            bounds: value >= 0

EXAMPLES
     vect2row -i input_file -o output_file  -r 128 -c 64

     Creates output file which has (128*64 = 8192) rows, one for
     each vector.  The dimension of each vector (number of
     columns) is the number of bands in input_file.  The number
     of bands in the output file is 1.

     vect2row -i input_file -o output_file -s 1 -x 5 -y 2

     Creates a single-band output file containing only a single
     vector (1 row). The number of columns in the output file is
     the vector dimension (number of bands in input file).

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvect2row(3)

RESTRICTIONS
     Cannot operate on VFF_TYP_BIT.

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

Khoros                    Release: 1.0                          1

