|
Packit |
78deda |
|
|
Packit |
78deda |
<HTML>
|
|
Packit |
78deda |
<HEAD><TITLE>Pgmmorphconv User Manual</TITLE></HEAD>
|
|
Packit |
78deda |
<BODY>
|
|
Packit |
78deda |
pgmmorphconv
|
|
Packit |
78deda |
Updated: 29 March 2015
|
|
Packit |
78deda |
|
|
Packit |
78deda |
Table Of Contents
|
|
Packit |
78deda |
|
|
Packit |
78deda |
NAME
|
|
Packit |
78deda |
|
|
Packit |
78deda |
pgmmorphconv - perform morphological convolutions: dilation, erosion
|
|
Packit |
78deda |
|
|
Packit |
78deda |
SYNOPSIS
|
|
Packit |
78deda |
|
|
Packit |
78deda |
pgmmorphconv
|
|
Packit |
78deda |
[
|
|
Packit |
78deda |
-erode |
|
|
Packit |
78deda |
-dilate |
|
|
Packit |
78deda |
-open |
|
|
Packit |
78deda |
-close |
|
|
Packit |
78deda |
-gradient
|
|
Packit |
78deda |
]
|
|
Packit |
78deda |
templatefile
|
|
Packit |
78deda |
[pgmfile]
|
|
Packit |
78deda |
|
|
Packit |
78deda |
Minimum unique abbreviation of option is acceptable. You may use
|
|
Packit |
78deda |
double hyphens instead of single hyphen to denote options. You may use
|
|
Packit |
78deda |
white space in place of the equals sign to separate an option name
|
|
Packit |
78deda |
from its value.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
DESCRIPTION
|
|
Packit |
78deda |
|
|
Packit |
78deda |
This program is part of Netpbm.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
pgmmorphconv performs morphological convolutions on a
|
|
Packit |
78deda |
PGM image: dilation and erosion.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
pgmmorphconv performs a "topological" convolution. For each
|
|
Packit |
78deda |
pixel of the input, pgmmorphconv generates an output pixel in
|
|
Packit |
78deda |
the same position. To determine the intensity of the output pixel,
|
|
Packit |
78deda |
pgmmorphconv lays the template image over the input image such
|
|
Packit |
78deda |
that the middle pixel of the template is over the input pixel in
|
|
Packit |
78deda |
question. pgmmorphconv looks at the input pixels underneath each
|
|
Packit |
78deda |
white pixel in the template. For a dilation, the maximum intensity of
|
|
Packit |
78deda |
all those pixels is the intensity of the output pixel. For an erosion,
|
|
Packit |
78deda |
it is the minimum.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
Thus, the dilation effect is that bright areas of the input get bigger
|
|
Packit |
78deda |
and dark areas smaller. The erosion effect is the opposite. The simplest
|
|
Packit |
78deda |
template image would be one with a white pixel in the middle and the rest
|
|
Packit |
78deda |
black. This would produce an output image identical to the input. Another
|
|
Packit |
78deda |
simple template image is a fully white square. This causes bright or dark
|
|
Packit |
78deda |
areas to expand in all directions. A template image that is white on the
|
|
Packit |
78deda |
left side and black on the right would smear the image to the right.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
The template file named by templatefile contains the
|
|
Packit |
78deda |
template image as a PBM image. It must have an odd number of rows and
|
|
Packit |
78deda |
an odd number of columns, so there is a definite middle pixel. It
|
|
Packit |
78deda |
must contain at least one white pixel.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
This is similar to the continuous convolution done by
|
|
Packit |
78deda |
pnmconvol, except that with pnmconvol the output intensity is
|
|
Packit |
78deda |
a weighted average of nearby input pixels instead of a minimum or maximum.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
This convolution changes the three Minkowski integrals in a predefined
|
|
Packit |
78deda |
way, and can be used to filter an image to enhance certain features, to
|
|
Packit |
78deda |
ease their automatic recognition.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
The options -erode and -dilate obviously produce an
|
|
Packit |
78deda |
erosion or dilation, respectively. The -open option causes
|
|
Packit |
78deda |
pgmmorphconv to perform first an erode and then a dilate
|
|
Packit |
78deda |
operation. The -close option causes a dilate first and then an
|
|
Packit |
78deda |
erode. If you specify none of these options, it is the same as
|
|
Packit |
78deda |
-dilate.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
With -gradient, pgmmorphconv produces an image which is the
|
|
Packit |
78deda |
difference between the eroded image and the dilated image. -gradient
|
|
Packit |
78deda |
was new in Netpbm 10.70 (March 2015).
|
|
Packit |
78deda |
|
|
Packit |
78deda |
|
|
Packit |
78deda |
SEE ALSO
|
|
Packit |
78deda |
|
|
Packit |
78deda |
|
|
Packit |
78deda |
pgmminkowski
|
|
Packit |
78deda |
pnmconvol
|
|
Packit |
78deda |
pgm
|
|
Packit |
78deda |
|
|
Packit |
78deda |
|
|
Packit |
78deda |
For more information about morphological convolutions, see e.g.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
|
|
Packit |
78deda |
href="http://rugth30.phys.rug.nl/compphys0/2001.htm"> K. Michielsen and
|
|
Packit |
78deda |
H. De Raedt, "Integral-Geometry Morphological Image Analysis",
|
|
Packit |
78deda |
Phys. Rep. 347, 461-538 (2001).
|
|
Packit |
78deda |
|
|
Packit |
78deda |
|
|
Packit |
78deda |
J.S. Kole, K. Michielsen, and H. De Raedt,
|
|
Packit |
78deda |
"Morphological Image Analysis of Quantum Motion in Billiards",
|
|
Packit |
78deda |
Phys. Rev. E 63, 016201-1 - 016201-7 (2001)
|
|
Packit |
78deda |
|
|
Packit |
78deda |
|
|
Packit |
78deda |
|
|
Packit |
78deda |
|
|
Packit |
78deda |
AUTHORS
|
|
Packit |
78deda |
|
|
Packit |
78deda |
Luuk van Dijk, 2001.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
Based on work which is Copyright (C) 1989, 1991 by Jef Poskanzer.
|
|
Packit |
78deda |
|
|
Packit |
78deda |
|
|
Packit |
78deda |
Table Of Contents
|
|
Packit |
78deda |
|
|
Packit |
78deda |
SYNOPSIS
|
|
Packit |
78deda |
DESCRIPTION
|
|
Packit |
78deda |
SEE ALSO
|
|
Packit |
78deda |
AUTHORS
|
|
Packit |
78deda |
|
|
Packit |
78deda |
</BODY>
|
|
Packit |
78deda |
</HTML>
|