add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhiteadd_noise_white (Operator)
Name
add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhiteadd_noise_white — Add noise to an image.
Signature
def add_noise_white(image: HObject, amp: float) -> HObject
Description
add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhiteAddNoiseWhiteadd_noise_white adds noise to the image ImageImageImageImageimageimage.
The noise is white noise, equally distributed in the interval
[-AmpAmpAmpAmpampamp,AmpAmpAmpAmpampamp], and is generated by using the C
function “drand48” with an initial time dependent seed. The resulting
gray values are clipped to the range of the corresponding pixel type.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
- Automatically parallelized on channel level.
Parameters
ImageImageImageImageimageimage (input_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject (byte / int2 / uint2 / real)
Input image.
ImageNoiseImageNoiseImageNoiseImageNoiseimageNoiseimage_noise (output_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject * (byte / int2 / uint2 / real)
Noisy image.
Number of elements: ImageNoise == Image
AmpAmpAmpAmpampamp (input_control) real → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Maximum noise amplitude.
Default value: 60.0
Suggested values: 1.0, 2.0, 5.0, 10.0, 20.0, 40.0, 60.0, 90.0
Typical range of values: 1.0
≤
Amp
Amp
Amp
Amp
amp
amp
≤
1000.0
Minimum increment: 0.001
Recommended increment: 10.0
Restriction: Amp > 0
Example (HDevelop)
read_image(Image,'fabrik')
dev_display (Image)
add_noise_white(Image,ImageNoise,90)
dev_display (ImageNoise)
Example (C)
read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
add_noise_white(Image,&ImageNoise,90.0);
disp_image(ImageNoise,WindowHandle);
Example (HDevelop)
read_image(Image,'fabrik')
dev_display (Image)
add_noise_white(Image,ImageNoise,90)
dev_display (ImageNoise)
Example (HDevelop)
read_image(Image,'fabrik')
dev_display (Image)
add_noise_white(Image,ImageNoise,90)
dev_display (ImageNoise)
Example (HDevelop)
read_image(Image,'fabrik')
dev_display (Image)
add_noise_white(Image,ImageNoise,90)
dev_display (ImageNoise)
Result
add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhiteAddNoiseWhiteadd_noise_white returns 2 (H_MSG_TRUE) if all parameters are correct.
If the input is empty the behavior can be set via
set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If
necessary, an exception is raised.
Alternatives
add_noise_distributionadd_noise_distributionAddNoiseDistributionAddNoiseDistributionAddNoiseDistributionadd_noise_distribution
See also
add_noise_distributionadd_noise_distributionAddNoiseDistributionAddNoiseDistributionAddNoiseDistributionadd_noise_distribution,
noise_distribution_meannoise_distribution_meanNoiseDistributionMeanNoiseDistributionMeanNoiseDistributionMeannoise_distribution_mean,
gauss_distributiongauss_distributionGaussDistributionGaussDistributionGaussDistributiongauss_distribution,
sp_distributionsp_distributionSpDistributionSpDistributionSpDistributionsp_distribution
Module
Foundation