varviff(1)

PROGRAM
varviff - Extracts a single data value from a viff structure for the cantata parser.

SYNTAX

varviff

-i1 input file

-x  x location

-y  y location

-b  band number

-v  variable

[-i2]
    input file that is passed to output unmodified (used to gate operation)

[-o]
    connecting file

[-V]
    Gives the version for varviff

[-U]
    Gives the usage for varviff

[-P]
    Prompts for command line options

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

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

DESCRIPTION
varviff takes as input a viff data structure and extracts a single data value (pixel) based upon the user indicated location (X, Y, and band number). The extracted data value is returned to the cantata parser to be assigned to the user specified "variable name". The data thus extracted can then be referenced (by useing the specified variable name) in any valid Cantata expression.

The optional input is used to gate when varviff runs. If this optional input is used and the optional output is used, then the gating input is passed to the output unchanged.

Note that band and location numbering begins at zero (0).

REQUIRED ARGUMENTS

-i1 type: infile
    desc: input file

-x  type: integer
    desc: x location

-y  type: integer
    desc: y location

-b  type: integer
    desc: band number

-v  type: string
    desc: variable

OPTIONAL ARGUMENTS

-i2 type: infile
    desc: input file that is passed to output unmodified (used to gate operation)

-o  type: outfile
    desc: connecting file

EXAMPLES
varviff -i image.xv -x 10 -y 3 -b 1 -v mean

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), lvarviff(3) Documentation on viff file format and data structure.

RESTRICTIONS
varviff Does not work on data types: VFF_TYP_BIT, VFF_TYP_COMPLEX.

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