---
title: MeanStdDev
description: "计算向量的平均值以及标准差。计算公式如下："
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC2/accel/kunpengaccel_hmpp_06_0072.html
sourcePath: /source/zh/kunpengboostkithistory/240RC2/accel/kunpengaccel_hmpp_06_0072.html
indexId: 9cdd0874595e2258b1db893072297aa658a1f634c994584f327e9695bd6b4f8177
---
# MeanStdDev

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

- 平均值

- 标准差

函数接口声明如下：

- 浮点数的操作：
  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
```