
vpolyco(1)                   Khoros                    vpolyco(1)

PROGRAM
     vpolyco - Compute polynomial warp coefficients

SYNTAX
     vpolyco

     -i1            Source tie point image

     -i2            Target tie point image

     -o1            X vwarp coefficients image

     -o2            Y vwarp coefficients image

     [-V]           Gives the version for vpolyco

     [-U]           Gives the usage for vpolyco

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vpolyco computes a set of bi-polynomial coefficients that
     tries to map the source tiepoints onto the target tiepoints.
     The order of the polynomials is controlled by the number of
     coordinate pairs in the source tiepoint file. The number of
     pairs must be the square of an integer. Thus a tiepoint file
     with 9 pairs will produce a coefficient matrix for a bi-
     quadratic polynomial.

     The input images are really files of coordinates. Each input
     image should be of size N rows by 2 columns, or type FLOAT.
     The coordinates are stored as pairs of numbers, for example
          (x0,y0) (x1,y1) (x2,y2) (x3,y3)

     is stored as an array of floats as follows:
          x0 y0
          x1 y1
          x2 y2
          x3 y3

     which is exactly how vprdata(1) should print out your coor-
     dinate file if it is in the right order. The first input
     image contains the coordinates of the tie points in the ori-
     ginal (source) image. The second input image contains the
     desired coordinates of the tie points in the corrected (tar-
     get) image.

     The output images contain the coefficients for the two poly-
     nomial mappings, one for the X coordinate and one for the Y
     coordinate, in the format specified in vwarp(1).

REQUIRED ARGUMENTS
     -i1    type: infile
            desc: Source tie point image

     -i2    type: infile
            desc: Target tie point image

     -o1    type: outfile
            desc: X vwarp coefficients image

     -o2    type: outfile
            desc: Y vwarp coefficients image

OPTIONAL ARGUMENTS
     none

EXAMPLES
     vpolyco -i1 srcpts.xv -i2 targpts.xv -o1 xc -o2 yc

     computes coefficients required to map the source tiepoints
     into the target tiepoints.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvpolyco(3) ,
     lvpolyco(3), vbilinco(1),vwarp(1)

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

Khoros                    Release: 1.0                          1

