MAN page from RedHat Other XITE-3.3-3.i386.rpm

CONVOLVE

Section: User Commands (1)
Updated: 16 Mar 1998
Index

 

NAME

convolve - perform an n x m convolution

 

SYNTAX

 convolve [<option>...] <inimage> <inimage> <outimage>
 or:
 convolve [<option>...] <inimage> <outimage>
           <xsize> <ysize> <v1> .. <vn>
  or:
 convolve [<option>...] -conv <asciifile>
           <inimage> <outimage>

 

DESCRIPTION

convolveperforms a convolution between a convolutionkernel and one or more bands. The result is written tooutimage.

In the first case above, the first band of the first inimageargument is considered the convolution kernel. All the bandsof the second inimageargument will be processed.

In the second case above, the convolution kernel is specifiedas a list of integers (and xsizeand ysizespecify thesize of the kernel).

In the third case above, the convolution kernel is specifiedby the name of a file containing ascii values.

 

OPTIONS

-conv filename

Take convolution kernel from Ascii file given by filename.

-scale scale

Scale convolution result. Default (with no -scaleoption orwith scaleequal to 0.0): Autoscaling.
 pixel = (conv. result) * scale

-offset offset

Offset (scaled) convolution result.
 pixel = (conv. result) * scale + offset

-title title

Use titleas title for the output image.

-byte

Force the output image pixeltype to become unsigned byte.Default: Same pixeltype as input band.

-word

Force the output image pixeltype to become signed short.Default: Same pixeltype as input band.

-verbose

With this standard XITE option, a message is written ifthe convolution sum is less than 0 or greater than 255.If autoscaling is performed, the scale and offsetfactors are displayed.

 

FILE FORMAT

See ascii2biff(1)

 

RESTRICTIONS

Works on unsigned byte and signed short images.If the convolution kernel is read from a BIFF image file,it must be of type signed short. Unsigned short images willbe treated as if they were signed short.

 

SEE ALSO

ascii2biff(1), convolve(3), conv3x3(1), laplace(1),gradient(1), sobel(1), prewitt(1), roberts(1)

 

EXAMPLE

 convolve mona.img m.img -scale 0.5 3 3 1 1 1 1 1 1 1 1 1

 

AUTHOR

Otto Milvang

 

REVISED

Svein Bře

 

ID

$Id: convolve.c,v 1.33 1997/01/09 17:16:41 svein Exp $

---

 

Index

NAME

SYNTAX

DESCRIPTION

OPTIONS

FILE FORMAT

RESTRICTIONS

SEE ALSO

EXAMPLE

AUTHOR

REVISED

ID

---

This document was created byman2html,using the manual pages.