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 coordinate file if it is in the right order. The first input image contains the coordinates of the tie points in the original (source) image. The second input image contains the desired coordinates of the tie points in the corrected (target) image.

The output images contain the coefficients for the two polynomial 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.