vconvolve(1)

PROGRAM
vconvolve - Compute two-dimensional convolution of a pair of images

SYNTAX

vconvolve

-i1 first input image

-i2 second input image (filter kernel)

-o  resulting output image

[-V]
    Gives the version for vconvolve

[-U]
    Gives the usage for vconvolve

[-P]
    Prompts for command line options

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

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

DESCRIPTION
vconvolve performs a two dimensional convolution of an image a specified kernel image.

If either of the files is of data storage type FLOAT, the output will be in that format, otherwise the output will be 4_BYTE (integer).

The second input image should be smaller than the first input image as it is treated as the filter kernel or weights.

Edge problems are handled by truncating the part of the ker- nel that is off of the image array.

REQUIRED ARGUMENTS

-i1 type: infile
    desc: first input image

-i2 type: infile
    desc: second input image (filter kernel)

-o  type: outfile
    desc: resulting output image

OPTIONAL ARGUMENTS
none

EXAMPLES
vconvolve -i1 feath.xv -i2 laplace3x3.xv -o result.xv

Convolves the laplacian3x3 kernel with "feath.xv" and leaves the result in "result.xv". The data type of the output image will be VFF_TYP_4_BYTE (32-bit integer).

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), lvconvolve(3) , lvconvolve(3), vfft(1)

RESTRICTIONS
vconvolve will not operate on VFF_TYP_COMPLEX images. Accumulator error may occur when convolving two large images.

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