Developer Reference

  • 2020
  • 10/21/2020
  • Public Content
Contents

RandGaussInit

Initializes a noise generator with Gaussian distribution.

Syntax

IppStatus ippsRandGaussInit_8u(IppsRandGaussState_8u*
pRandGaussState
, Ipp8u
mean
, Ipp8u
stdDev
, unsigned int
seed
);
IppStatus ippsRandGaussInit_16s(IppsRandGaussState_16s*
pRandGaussState
, Ipp16s
mean
, Ipp16s
stdDev
, unsigned int
seed
);
IppStatus ippsRandGaussInit_32f(IppsRandGaussState_32f*
pRandGaussState
, Ipp32f
mean
, Ipp32f
stdDev
, unsigned int
seed
);
IppStatus ippsRandGaussInit_64f(IppsRandGaussState_64f*
pRandGaussState
, Ipp64f
mean
, Ipp64f
stdDev
, unsigned int
seed
);
Include Files
ipps.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
Libraries:
ippcore.lib
,
ippvm.lib
Parameters
pRandGaussState
Pointer to the structure containing parameters for the generator of noise.
mean
Mean of the Gaussian distribution.
stdDev
Standard deviation of the Gaussian distribution.
seed
Seed value used by the pseudo-random number generator algorithm.
Description
This function initializes the pseudo-random generator state structure
pRandGaussState
in the external buffer. This structure contains parameters of the required noise generator that are specified by the
mean
,
stdDev
, and
seed
values. Before using this function, you need to compute the size of the buffer by calling the
ippsRandGaussGetSize
function.
Return Values
ppStsNoErr
Indicates no error.
ippStsNullPtrErr
Indicates an error when the
pRandGaussState
pointer is
NULL
.
ippStsMemAllocErr
Indicates an error when there is not enough memory for the operation.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804