RandGauss
产生给定均值、标准差的符合正态分布随机序列。
函数接口声明如下：
- 初始化操作：
HmppResult HMPPS_RandGaussInit_8u(HmppsRandGaussPolicy_8u **policy, uint8_t mean, uint8_t stdDev, uint32_t seed);
HmppResult HMPPS_RandGaussInit_16s(HmppsRandGaussPolicy_16s **policy, int16_t mean, int16_t stdDev, uint32_t seed);
HmppResult HMPPS_RandGaussInit_32f(HmppsRandGaussPolicy_32f **policy, float mean, float stdDev, uint32_t seed);
HmppResult HMPPS_RandGaussInit_64f(HmppsRandGaussPolicy_64f **policy, double mean, double stdDev, uint32_t seed);
- 主函数操作：
HmppResult HMPPS_RandGauss_8u(uint8_t *dst, int32_t len, HmppsRandGaussPolicy_8u *policy)；
HmppResult HMPPS_RandGauss_16s(int16_t *dst, int32_t len, HmppsRandGaussPolicy_16s *policy)；
HmppResult HMPPS_RandGauss_32f(float *dst, int32_t len, HmppsRandGaussPolicy_32f *policy)；
HmppResult HMPPS_RandGauss_64f(double *dst, int32_t len, HmppsRandGaussPolicy_64f *policy);
- 释放内存操作：
HmppResult HMPPS_RandGaussRelease_8u(HmppsRandGaussPolicy_8u *policy)；
HmppResult HMPPS_RandGaussRelease_16s(HmppsRandGaussPolicy_16s *policy)；
HmppResult HMPPS_RandGaussRelease_32f(HmppsRandGaussPolicy_32f *policy)；
HmppResult HMPPS_RandGaussRelease_64f(HmppsRandGaussPolicy_64f *policy)；
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
|---|---|---|---|
dst |
指向目的向量的指针。 |
非空 |
输出 |
len |
向量长度。 |
(0,INT_MAX] |
输入 |
mean |
均值。 |
视类型而定 |
输入 |
stdDev |
标准差。 |
视类型而定 |
输入 |
seed |
随机数种子。 |
视类型而定 |
输入 |
policy |
产生随机序列参数结构体 |
非空 |
输入/输出 |
返回值
- 成功：返回HMPP_STS_NO_ERR。
- 失败：返回错误码。
错误码
错误码 |
描述 |
|---|---|
HMPP_STS_NULL_PTR_ERR |
dst这个入参中存在空指针。 |
HMPP_STS_SIZE_ERR |
len小于或等于0。 |
HMPP_STS_MALLOC_FAILED |
所需的额外内存申请失败。 |
示例
#define BUFFER_SIZE_T 10
int main()
{
float dst[BUFFER_SIZE_T];
int32_t i;
float mean = 1;
float stdDev = 1;
float seed = 0;
HmppsRandGaussPolicy_32f *policy = NULL;
HmppResult result;
result = HMPPS_RandGaussInit_32f(&policy, mean, stdDev, seed);
if (result != HMPP_STS_NO_ERR)
{
return;
}
result = HMPPS_RandGauss_32f(dst, BUFFER_SIZE_T, policy);
printf("result = %d \ndst =", result);
for (i = 0; i < BUFFER_SIZE_T; i++) {
printf(" %f ", dst[i]);
}
HMPPS_RandGaussRelease_32f(policy);
return 0;
}
运行结果：
result = 0 dst = 0.839658 0.516040 0.405604 0.981364 2.000319 -0.703950 0.667630 1.412678 1.724619 1.078169