MeanStdDev

计算向量的平均值以及标准差。计算公式如下：

平均值
 $\text{[math]}$

标准差
 $\text{[math]}$

函数接口声明如下：

浮点数的操作：
HmppResult HMPPS_MeanStdDev_32f(const float *src, int32_t len, float *mean, float *stdDev, HmppHintAlgorithm hint);

HmppResult HMPPS_MeanStdDev_64f(const double *src, int32_t len, double *mean, double *stdDev);

有缩放的整型数操作：
HmppResult HMPPS_MeanStdDev_16s_S(const int16_t *src, int32_t len, int16_t *mean, int16_t *stdDev, double scale);

HmppResult HMPPS_MeanStdDev_16s32s_S(const int16_t *src, int32_t len, int32_t *mean, int32_t *stdDev, double scale);

参数

参数名	描述	取值范围	输入/输出
src	指向源向量的指针。	非空	输入
len	向量长度。	[2, INT_MAX]	输入
mean	指向平均值的指针。	非空	输出
stdDev	指向标准差的指针。	非空	输出
hint	算法模式。	HmppAlgHintNone、HmppAlgHintFast、HmppAlgHintAccurate	输入
scale	缩放因数。	(0,INF)且输入为2^n	输入

返回值

成功：返回HMPP_STS_NO_ERR。
失败：返回错误码。

错误码

错误码	描述
HMPP_STS_NULL_PTR_ERR	src、mean、stdDev这几个入参中存在空指针。
HMPP_STS_SIZE_ERR	len小于或等于0。
HMPP_STS_SCALE_ERR	scale不在(0,INF)范围内或输入为nan。

示例

#define BUFFER_SIZE_T 10

void MeanStdDevExample(void)
{
    float src[BUFFER_SIZE_T] = {3.45, 0.12, 7.77, 4.45, 2.44, 3.67, 2.78, 8.88, 1.83, 5.57};
    float mean;
    float stdDev;
    HmppHintAlgorithm hint = HMPP_ALGHINT_FAST;

    HmppResult result = HMPPS_MeanStdDev_32f(src, BUFFER_SIZE_T, &mean, &stdDev, hint);
    printf("result = %d\n", result);
    if (result != HMPP_STS_NO_ERR) {
        return;
    }
    printf("mean = %.3f, stdDev = %.3f\n", mean, stdDev);
}

运行结果：

result = 0
mean = 4.096, stdDev = 2.681

父主题： 基础与通用运算