CartToPolar

直角坐标转极坐标。

极角计算公式如下：

$\text{[math]}$

极径计算公式如下：

$\text{[math]}$

函数接口声明如下：

整型数的操作：
HmppResult HMPPS_CartToPolar_16sc_S(const Hmpp16sc *src, int16_t *dstMagn, int16_t *dstPhase, int32_t len, double magnScale, double phaseScale);

浮点数的操作：
HmppResult HMPPS_CartToPolar_32f(const float *srcRe, const float *srcIm, float *dstMagn, float *dstPhase, int32_t len);

HmppResult HMPPS_CartToPolar_64f(const double *srcRe, const double *srcIm, double *dstMagn, double *dstPhase, int32_t len);

HmppResult HMPPS_CartToPolar_32fc(const Hmpp32fc *src, float *dstMagn, float *dstPhase, int32_t len);

HmppResult HMPPS_CartToPolar_64fc(const Hmpp64fc *src, double *dstMagn, double *dstPhase, int32_t len);

参数

参数名	描述	取值范围	输入/输出
src	指向复数源向量的指针。	非空	输入
srcRe	指向复数实部源向量复数的指针。	非空	输入
srcIm	指向复数虚部源向量复数的指针。	非空	输入
len	向量长度。	(0,INT_MAX]	输入
dstMagn	指向极径目标向量的指针。	非空	输出
dstPhase	指向极角目标向量的指针。	非空，目标向量中的值范围为(-π, π]	输出
magnScale	极径的缩放因数。	(0, inf)且为2ⁿ	输入
phaseScale	极角的缩放因数。	(0, inf)且为2ⁿ	输入

返回值

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

错误码

错误码	描述
HMPP_STS_NULL_PTR_ERR	当任何指定的指针为空时指示错误。
HMPP_STS_SIZE_ERR	len小于或等于0。
HMPP_STS_SCALE_ERR	magnScale或者phaseScale不在(0,INF)范围内或输入为NAN。
HMPP_STS_MALLOC_FAILED	Init函数中进行算法模型所需内存申请失败。

示例

#define SRC_LEN 8
void CartToPolarExample(void)
{
    int32_t len = SRC_LEN;
    float srcRe[SRC_LEN] = { 59.960567, 7.2509279, 1.7840941, 155.84264, 0.0020125117, 0.73378527, 4497.1704, 630.54828 };
    float srcIm[SRC_LEN] = { 2.0548565, 0.00067954202, 0.028709119, 0.0001744011, 0.0054633785, 0.00063873257, 2293.6162, 7.3549595 };
    float dstMagn[SRC_LEN] = { 0.0f };
    float dstPhase[SRC_LEN] = { 0.0f };

    HmppResult result = HMPPS_CartToPolar_32f(srcRe, srcIm, dstMagn, dstPhase, len);
    printf("HMPPS_CartToPolar_32f result = %d\n", result);
    if (result != HMPP_STS_NO_ERR) {
        return;
    }

    int32_t i;
    printf("len = %d\ndstMagn =", len);
    for(i = 0; i < len; ++i){
        printf(" %f", dstMagn[i]);
    }
    printf("\ndstPhase =");
    for(i = 0; i < len; ++i){
        printf(" %f", dstPhase[i]);
    }
    printf("\n");
}

运行结果：

HMPPS_CartToPolar_32f result = 0
len = 8
dstMagn = 59.995770 7.250928 1.784325 155.842636 0.005822 0.733786 5048.288574 630.591187
dstPhase = 0.034257 0.000094 0.016090 0.000001 1.217856 0.000870 0.471626 0.011664

父主题： 基础与通用运算