sp_distributionT_sp_distributionSpDistributionSpDistribution (Operator)

Name

sp_distributionT_sp_distributionSpDistributionSpDistribution — Generate a salt-and-pepper noise distribution.

Signature

sp_distribution( : : PercentSalt, PercentPepper : Distribution)

Description

sp_distributionsp_distributionSpDistributionSpDistributionSpDistribution generates a noise distribution with the values 0 and 255. The parameters PercentSaltPercentSaltPercentSaltPercentSaltpercentSalt and PercentPepperPercentPepperPercentPepperPercentPepperpercentPepper determine the percentage of white and black noise pixels, respectively. The sum of these parameters must be smaller than 100. Usually, the result DistributionDistributionDistributionDistributiondistribution is used as input for the operator add_noise_distributionadd_noise_distributionAddNoiseDistributionAddNoiseDistributionAddNoiseDistribution.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

PercentSaltPercentSaltPercentSaltPercentSaltpercentSalt (input_control) number → (real / integer)

Percentage of salt (white noise pixels).

Default value: 5.0

Suggested values: 1.0, 2.0, 5.0, 7.0, 10.0, 15.0, 20.0, 30.0

Typical range of values: 0.0 ≤ PercentSalt PercentSalt PercentSalt PercentSalt percentSalt ≤ 100.0

Minimum increment: 0.1

Recommended increment: 1.0

Restriction: 0.0 <= PercentSalt && PercentSalt <= 100.0

PercentPepperPercentPepperPercentPepperPercentPepperpercentPepper (input_control) number → (real / integer)

Percentage of pepper (black noise pixels).

Default value: 5.0

Suggested values: 1.0, 2.0, 5.0, 7.0, 10.0, 15.0, 20.0, 30.0

Typical range of values: 0.0 ≤ PercentPepper PercentPepper PercentPepper PercentPepper percentPepper ≤ 100.0

Minimum increment: 0.1

Recommended increment: 1.0

Restriction: 0.0 <= PercentPepper && PercentPepper <= 100.0

DistributionDistributionDistributionDistributiondistribution (output_control) distribution.values-array → (real)

Resulting noise distribution.

Number of elements: 513

Example (HDevelop)

read_image(Image,'fabrik')
dev_display (Image)
sp_distribution(30,30,Dist)
add_noise_distribution(Image,ImageNoise,Dist)
dev_display (ImageNoise)

Example (C)

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
create_tuple(&PerSalt,1);
set_d(PerSalt,30.0,0);
create_tuple(&PerPepper,1);
set_d(PerPepper,30.0,0);
T_sp_distribution(PerSalt,PerPepper,&Dist);
T_add_noise_distribution(Image,&ImageNoise,Dist);
disp_image(ImageNoise,WindowHandle);

Example (HDevelop)

read_image(Image,'fabrik')
dev_display (Image)
sp_distribution(30,30,Dist)
add_noise_distribution(Image,ImageNoise,Dist)
dev_display (ImageNoise)

Example (HDevelop)

read_image(Image,'fabrik')
dev_display (Image)
sp_distribution(30,30,Dist)
add_noise_distribution(Image,ImageNoise,Dist)
dev_display (ImageNoise)

Example (HDevelop)

read_image(Image,'fabrik')
dev_display (Image)
sp_distribution(30,30,Dist)
add_noise_distribution(Image,ImageNoise,Dist)
dev_display (ImageNoise)

Possible Successors

add_noise_distributionadd_noise_distributionAddNoiseDistributionAddNoiseDistributionAddNoiseDistribution

Alternatives

gauss_distributiongauss_distributionGaussDistributionGaussDistributionGaussDistribution, noise_distribution_meannoise_distribution_meanNoiseDistributionMeanNoiseDistributionMeanNoiseDistributionMean

Module

Foundation

Operators