Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

RandGauss

Generates the pseudo-random samples with a Gaussian distribution.

Syntax

IppStatus ippsRandGauss_8u(Ipp8u* pDst, int len, IppsRandGaussState_8u* pRandGaussState);

IppStatus ippsRandGauss_16s(Ipp16s* pDst, int len, IppsRandGaussState_16s* pRandGaussState);

IppStatus ippsRandGauss_32f(Ipp32f* pDst, int len, IppsRandGaussState_32f* pRandGaussState);

IppStatus ippsRandGauss_64f(Ipp64f* pDst, int len, IppsRandGaussState_64f* pRandGaussState);

Include Files

ipps.h

Domain Dependencies

Headers: ippcore.h, ippvm.h

Libraries: ippcore.lib, ippvm.lib

Parameters

pDst

Pointer to the array which stores the samples.

len

Number of samples to be computed.

pRandGaussState

Pointer to the structure containing parameters of the noise generator.

Description

This function generates len pseudo-random samples with a Gaussian distribution and stores them in the array pDst. The initial parameters of the generator are set in the generator state structure pRandGaussState. Before calling ippsRandGauss, you must initialize the generator state by calling the RandGaussInit function.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when the pRandGaussState pointer is NULL.

ippStsContextMatchErr

Indicates an error when the state identifier is incorrect.