pamaddnoise(1)

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

NAME

6       pamaddnoise - add noise to a Netpbm image
7
8

SYNOPSIS

10       pamaddnoise { [-type gaussian]
11
12       [-sigma1 value]
13
14       [-sigma2 value] | -type  multiplicative_gaussian
15
16       [-mgsigma value] | -type impulse
17
18       [-tolerance ratio] | -type  laplacian
19
20       [-lsigma value] | -type  poisson
21
22       [-lambda value] } [-seed int]
23
24       [netpbmfile]
25
26

DESCRIPTION

28       This program is part of Netpbm(1).
29
30       pamaddnoise   adds   the  specified  noise  type  to  a  Netpbm  image.
31       pamaddnoise treats a PPM image as 3 independent planes, not as a  plane
32       of colors in a color space.
33
34

OPTIONS

36       In  addition  to  the options common to all programs based on libnetpbm
37       (most notably -quiet, see
38        Common Options ⟨index.html#commonoptions⟩  ),  pamaddnoise  recognizes
39       the following command line options:
40
41
42
43       -lambda value
44              This  is  the  expected  value of the Poisson distribution for a
45              sample value
46                of mximum intensity.  The expected value for other intensities
47              is
48                proportional; e.g. for half intensity, it is half this value.
49
50              This is meaningful only with -type=poisson.
51
52              The default value is 12.
53
54
55       -lsigma value
56              Used for laplacian noise only.  The default value is 10.0.
57
58
59       -mgsigma value
60              Used  for multiplicative gaussian noise only.  The default value
61              is 0.5.
62
63
64       -seed int
65              Used for all noise types.  Set the initial random number genera‐
66              tor seed value.
67
68
69       -sigma1 value
70              Used for gaussian noise only.  The default value is 4.0.
71
72
73       -sigma2 value
74              Used for gaussian noise only.  The default value is 20.0.
75
76
77       -tolerance ratio
78              Used  for  impulse noise only.  The default value is 0.10.  This
79              means that 5% of all pixel values will be set to 0 and  5%  will
80              be set to the maxval
81
82
83       -type noise_type
84              Select  type  of  noise  by name.  The following noise types are
85              available: gaussian,  multiplicative_gaussian,  impulse,  lapla‐
86              cian,  poisson.   Only  enough letters to be unique are required
87              for the noise type option.  The default noise type is gaussian.
88
89
90
91       ·      gaussian
92
93       ·      multiplicative_gaussian
94
95       ·      impulse
96
97       ·      laplacian
98
99       ·      poisson
100
101
102
103
104

REFERENCES

106       ·      "Adaptive Image Restoration in  Signal-Dependent  Noise"  by  R.
107              Kasturi Institute for Electronic Science, Texas Tech University,
108              1982
109
110
111       ·      "Digital Image Processing Algorithms" by Ioannis Pitas, Prentice
112              Hall, 1993 ISBN 0-13-145814-0
113
114
115
116

HISTORY

122       pamaddnoise was added to Netpbm in Version 10.29 (August 2005).  It had
123       been distributed by Mike Burns via his own web site  before  that  (and
124       continued to be so).
125
126       Burns' version, and the one in Netpbm 10.29, was called pnmaddnoise and
127       worked only on PNM images.  In Netpbm 10.30, it was converted to handle
128       PAM images and renamed to pamaddnoise.
129
130

AUTHOR

132       Copyright (C) 1995 by Mike Burns <burns@cac.psu.edu>
133

DOCUMENT SOURCE

135       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
136       source.  The master documentation is at
137
138              http://netpbm.sourceforge.net/doc/pamaddnoise.html
139
140netpbm documentation           12 December 2020     Pamaddnoise User Manual(0)