DIPlib Documentation - ©1995-2008 Quantitative Imaging Group, Delft University of Technology.

PoissonNoise

Generate an image disturbed by Poisson noise

SYNOPSIS

#include "dip_noise.h"

dip_Error dip_PoissonNoise ( in, out, conversion, random )

DATA TYPES

integer, float

FUNCTION

Generate a Poisson noise disturbed image. The intensities of the input image divided by the conversion variable are used as mean value for the Poisson distribution. The conversion factor can be used to relate the pixel values with the number of counts. For example, the simulate a photon limited image acquired by a CCD camera, the conversion factor specifies the relation between the number of photons recorded and the pixel value it is represented by.

ARGUMENTS

Data typeNameDescription
dip_ImageinInput
dip_ImageoutOutput
dip_floatconversionConversion factor (photon/ADU)
dip_Random *randomrandom

EXAMPLE

Get a Poisson disturbed image as follows: 

   dip_Image in, out;
   dip_float conversion;
   dip_Random random;

   conversion = 2.0;
   DIPXX( dip_PoissonNoise(in, out, conversion, &random ));

SEE ALSO

RandomVariable, RandomSeed, UniformNoise, GaussianNoise, BinaryNoise

DIPlib on-line documentation | Function reference | Global function index