dwww Home | Manual pages | Find package

Pamaddnoise User Manual(1)  General Commands Manual Pamaddnoise User Manual(1)

NAME
       pamaddnoise - add noise to a Netpbm image

SYNOPSIS
       pamaddnoise { [-type gaussian]

       [-sigma1 value]

       [-sigma2 value] | -type  multiplicative_gaussian

       [-mgsigma value] | -type impulse

       [-tolerance ratio] | -type  laplacian

       [-lsigma value] | -type  poisson

       [-lambda value] } [-seed int]

       [netpbmfile]

DESCRIPTION
       This program is part of Netpbm(1).

       pamaddnoise  adds  the  specified  noise  type  to a Netpbm image.  pa-
       maddnoise treats a PPM image as 3 independent planes, not as a plane of
       colors in a color space.

OPTIONS
       In  addition  to  the options common to all programs based on libnetpbm
       (most notably -quiet, see
        Common Options ⟨index.html#commonoptions⟩  ),  pamaddnoise  recognizes
       the following command line options:

       -lambda value
              This  is  the  expected  value of the Poisson distribution for a
              sample value
                of mximum intensity.  The expected value for other intensities
              is
                proportional; e.g. for half intensity, it is half this value.

              This is meaningful only with -type=poisson.

              The default value is 12.

       -lsigma value
              Used for laplacian noise only.  The default value is 10.0.

       -mgsigma value
              Used  for multiplicative gaussian noise only.  The default value
              is 0.5.

       -seed int
              Used for all noise types.  Set the initial random number genera-
              tor seed value.

       -sigma1 value
              Used for gaussian noise only.  The default value is 4.0.

       -sigma2 value
              Used for gaussian noise only.  The default value is 20.0.

       -tolerance ratio
              Used  for  impulse noise only.  The default value is 0.10.  This
              means that 5% of all pixel values will be set to 0 and  5%  will
              be set to the maxval

       -type noise_type
              Select  type  of  noise  by name.  The following noise types are
              available: gaussian,  multiplicative_gaussian,  impulse,  lapla-
              cian,  poisson.   Only  enough letters to be unique are required
              for the noise type option.  The default noise type is gaussian.

       •      gaussianmultiplicative_gaussianimpulselaplacianpoisson

REFERENCES
       •      "Adaptive Image Restoration in  Signal-Dependent  Noise"  by  R.
              Kasturi Institute for Electronic Science, Texas Tech University,
              1982

       •      "Digital Image Processing Algorithms" by Ioannis Pitas, Prentice
              Hall, 1993 ISBN 0-13-145814-0

SEE ALSO
       pgmnoise(1), pgmmedian(1), pnm(1), pam(1),

HISTORY
       pamaddnoise was added to Netpbm in Version 10.29 (August 2005).  It had
       been distributed by Mike Burns via his own web site  before  that  (and
       continued to be so).

       Burns' version, and the one in Netpbm 10.29, was called pnmaddnoise and
       worked only on PNM images.  In Netpbm 10.30, it was converted to handle
       PAM images and renamed to pamaddnoise.

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

DOCUMENT SOURCE
       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
       source.  The master documentation is at

              http://netpbm.sourceforge.net/doc/pamaddnoise.html

netpbm documentation           12 December 2020     Pamaddnoise User Manual(1)

Generated by dwww version 1.15 on Sat Jun 29 02:39:10 CEST 2024.