IMAGE commands


PROGRAM NAME

iconvolve - Perform convolution or correlation on image data

DESCRIPTION

iconvolve is a simple interface to the more general klinearop routine in the DATAMANIP toolbox. iconvolve is set up to perform convolution or correlation on image data (WxHx?x?x?) using a WxH kernel, in zero-padded, linear mode (not circular).

The kernel origin, center, or "hotspot" can be set using the -wc and -hc arguments; otherwise the KPDS_KERNEL_ORIGIN attribute for the kernel object is queried for that information.

REQUIRED ARGUMENTS

-i1
type: infile
desc: input image
-i2
type: infile
desc: kernel
-o
type: outfile
desc: output image

OPTIONAL ARGUMENTS

-corr
type: boolean
desc: Select correlation (default) or convolution
default: false
-upcast
type: flag
desc: Upcast data to double or double complex for processing
-wc
type: integer
desc: Width coordinate of kernel hotspot
default: 0
bounds: value >= 0
-hc
type: integer
desc: Height coordinate of kernel hotspot
default: 0
bounds: value >= 0

EXAMPLES

iconvolve -i1 ball.xv -i2 laplacian -corr 0 -o edges

SEE ALSO

kfft(1), kconvolve(1)

RESTRICTIONS

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.