---
title: Normalize
description: "使用偏移和除法运算对实数或复数向量的元素进行归一化，本函数归一化采用将向量的数值平移和缩放到一个范围，即线性归一化。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_hmpp_06_0083.html
sourcePath: /source/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_hmpp_06_0083.html
indexId: da67c303b581cfc7088a5e927e92a58eee2dc8485d51b9273068853cd36bd14777
---
# Normalize

使用偏移和除法运算对实数或复数向量的元素进行归一化，本函数归一化采用将向量的数值平移和缩放到一个范围，即线性归一化。

向量归一化处理。计算公式为：。

对于原址操作函数，计算公式为：。

函数接口声明如下：

- 浮点数的操作：
  HmppResult HMPPS_Normalize_32f(const float *src, float *dst, int32_t len, float sub, float div);

  HmppResult HMPPS_Normalize_64f(const double *src, double *dst, int32_t len, double sub, double div);

  HmppResult HMPPS_Normalize_32fc(const Hmpp32fc *src, Hmpp32fc *dst, int32_t len, Hmpp32fc sub, float div);

  HmppResult HMPPS_Normalize_64fc(const Hmpp64fc *src, Hmpp64fc *dst, int32_t len, Hmpp64fc sub, double div);

- 浮点数的原址操作：
  HmppResult HMPPS_Normalize_32f_I(float *srcDst, int32_t len, float sub, float div);

  HmppResult HMPPS_Normalize_64f_I(double *srcDst, int32_t len, double sub, double div);

  HmppResult HMPPS_Normalize_32fc_I(Hmpp32fc *srcDst, int32_t len, Hmpp32fc sub, float div);

  HmppResult HMPPS_Normalize_64fc_I(Hmpp64fc *srcDst, int32_t len, Hmpp64fc sub, double div);

- 有缩放的整型数操作：
  HmppResult HMPPS_Normalize_16s_S(const int16_t *src, int16_t *dst, int32_t len, int16_t sub, int32_t div, double scale);

  HmppResult HMPPS_Normalize_16sc_S(const Hmpp16sc *src, Hmpp16sc *dst, int32_t len, Hmpp16sc sub, int32_t div, double scale);

- 有缩放的整型数原址操作：
  HmppResult HMPPS_Normalize_16s_IS(int16_t *srcDst, int32_t len, int16_t sub, int32_t div, double scale);

  HmppResult HMPPS_Normalize_16sc_IS(Hmpp16sc *srcDst, int32_t len, Hmpp16sc sub, int32_t div, double scale);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向源向量的指针。 | 非空 | 输入 |
| dst | 指向目的向量的指针。 | 非空 | 输出 |
| srcDst | 指向原址操作向量的指针。 | 非空 | 输入/输出 |
| len | 向量长度。 | (0, INT\_MAX] | 输入 |
| sub | 减数（偏移）因子。 | 视类型而定 | 输入 |
| div | 分母因子。 | 非0 | 输入 |
| scale | 缩放因数。 | (0,INF)且输入为2^n | 输入 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src、dst、srcDst这几个入参中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | len小于或等于0。 |
| HMPP\_STS\_DIV\_BY\_ZERO\_ERR | div等于0。 |
| HMPP\_STS\_SCALE\_ERR | scale不在(0,INF)范围内或输入为nan。 |


#### 示例

```
#define BUFFER_SIZE_T 10
void NormalizeExample(void)
{
float src[BUFFER_SIZE_T] = {3, 0, 2, -8, 3, 1, 7, 5, -2, 1};
float dst[BUFFER_SIZE_T];
float sub = 3;
float div = 5;
HmppResult result;
result = HMPPS_Normalize_32f(src, dst, BUFFER_SIZE_T, sub, div);
printf("result = %d\n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
printf("dst =");
for (int i = 0; i < BUFFER_SIZE_T; i++) {
printf(" %.1f", dst[i]);
}
printf("\n");
}
```

运行结果：

```
result = 0
dst = 0.0 -0.6 -0.2 -2.2 0.0 -0.4 0.8 0.4 -1.0 -0.4
```