Normalize

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

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

对于原址操作函数,计算公式为:

函数接口声明如下:

参数

参数名

描述

取值范围

输入/输出

src

指向源向量的指针。

非空

输入

dst

指向目的向量的指针。

非空

输出

srcDst

指向原址操作向量的指针。

非空

输入/输出

len

向量长度。

(0, INT_MAX]

输入

sub

减数(偏移)因子。

视类型而定

输入

div

分母因子。

非0

输入

scale

缩放因数。

(0,INF)且输入为2^n

输入

返回值

错误码

错误码

描述

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