---
title: CartToPolar
description: "直角坐标转极坐标。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_hmpp_06_0168.html
sourcePath: /source/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_hmpp_06_0168.html
indexId: 1381a8fab37ff2dc0a86bce61ecb604313e98984fb72d1fa2327d6c65c490fc877
---
# CartToPolar

直角坐标转极坐标。

极角计算公式如下：


极径计算公式如下：


函数接口声明如下：

- 整型数的操作：
  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)且为2n | 输入 |
| phaseScale | 极角的缩放因数。 | (0, inf)且为2n | 输入 |


#### 返回值

- 成功：返回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
```