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