1Pgmmorphconv User Manual(0)                        Pgmmorphconv User Manual(0)
2
3
4

NAME

6       pgmmorphconv - perform morphological convolutions: dilation, erosion
7
8

SYNOPSIS

10       pgmmorphconv [
11        -erode |
12        -dilate |
13        -open |
14        -close |
15        -gradient ] templatefile [pgmfile]
16
17       Minimum  unique abbreviation of option is acceptable.  You may use dou‐
18       ble hyphens instead of single hyphen to denote options.   You  may  use
19       white space in place of the equals sign to separate an option name from
20       its value.
21
22

DESCRIPTION

24       This program is part of Netpbm(1).
25
26       pgmmorphconv performs morphological convolutions on a PGM image:  dila‐
27       tion and erosion.
28
29       pgmmorphconv  performs  a "topological" convolution.  For each pixel of
30       the input, pgmmorphconv generates an output pixel in the same position.
31       To  determine  the intensity of the output pixel, pgmmorphconv lays the
32       template image over the input image such that the middle pixel  of  the
33       template  is  over  the input pixel in question.  pgmmorphconv looks at
34       the input pixels underneath each white pixel in the  template.   For  a
35       dilation, the maximum intensity of all those pixels is the intensity of
36       the output pixel.  For an erosion, it is the minimum.
37
38       Thus, the dilation effect is that bright areas of the input get  bigger
39       and  dark areas smaller.  The erosion effect is the opposite.  The sim‐
40       plest template image would be one with a white pixel in the middle  and
41       the  rest  black.   This would produce an output image identical to the
42       input.  Another simple template image is a fully  white  square.   This
43       causes  bright  or  dark areas to expand in all directions.  A template
44       image that is white on the left side and black on the right would smear
45       the image to the right.
46
47       The  template file named by templatefile contains the template image as
48       a PBM image.  It must have an odd number of rows and an odd  number  of
49       columns, so there is a definite middle pixel.  It must contain at least
50       one white pixel.
51
52       This is similar to the continuous convolution done by pnmconvol, except
53       that  with  pnmconvol  the  output  intensity  is a weighted average of
54       nearby input pixels instead of a minimum or maximum.
55
56       This convolution changes the three Minkowski integrals in a  predefined
57       way, and can be used to filter an image to enhance certain features, to
58       ease their automatic recognition.
59
60       The options -erode and -dilate obviously produce an  erosion  or  dila‐
61       tion, respectively.
62
63       The -open option causes pgmmorphconv to perform first an erode and then
64       a dilate operation.  The -close option causes a dilate first  and  then
65       an  erode.   If  you  specify  none of these options, it is the same as
66       -dilate.
67
68       With -gradient, pgmmorphconv produces an image which is the  difference
69       between  the  eroded image and the dilated image.  -gradient was new in
70       Netpbm 10.70 (March 2015).
71
72
73

SEE ALSO

75       ·
76
77              pgmminkowski(1)
78
79       ·
80
81              pnmconvol(1)
82
83       ·
84
85              pgm(1)
86
87
88       For more information about morphological convolutions, see e.g.
89
90
91       ·
92
93               K. Michielsen and H. De Raedt, "Integral-Geometry Morphological
94              Image    Analysis",    Phys.    Rep.    347,   461-538   (2001).
95http://rugth30.phys.rug.nl/compphys0/2001.htm
96
97
98       ·
99
100               J.S. Kole, K. Michielsen, and H. De Raedt, "Morphological Image
101              Analysis  of  Quantum  Motion  in  Billiards",  Phys. Rev. E 63,
102              016201-1             -              016201-7              (2001)
103http://rugth30.phys.rug.nl/pdf/prechaos.pdf
104
105
106
107

AUTHORS

109       Luuk van Dijk, 2001.
110
111       Based on work which is Copyright (C) 1989, 1991 by Jef Poskanzer.
112

DOCUMENT SOURCE

114       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
115       source.  The master documentation is at
116
117              http://netpbm.sourceforge.net/doc/pgmmorphconv.html
118
119netpbm documentation             29 March 2015     Pgmmorphconv User Manual(0)
Impressum