【Hackathon 4 No.14】Add Polar to paddle

[PommesPeter]

PR types

New features

PR changes

APIs

Describe

added polar API to paddle

rfc doc here: PaddlePaddle/community#364
Chinese doc here: PaddlePaddle/docs#5639

[paddle-bot]

你的PR提交成功，感谢你对开源项目的贡献!
请关注后续CI自动化测试结果，详情请参考Paddle-CI手册。
Your PR has been submitted. Thanks for your contribution!
Please wait for the result of CI firstly. See Paddle CI Manual for details.

[PommesPeter]

文档链接 PaddlePaddle/docs#5639

[CLAassistant]

All committers have signed the CLA.

[PommesPeter]

我观察 CI 发现 paddle.multiply API 在计算 float64 和 complex128 做乘法的时候报错了，CI 中是编译的 develop 版本，但是我用 release 的 windows 版本的 paddlepaddle 2.3.2 在本地是可以执行这个操作的，这个报错是正常的么？ @iclementine

[iclementine]

我观察 CI 发现 paddle.multiply API 在计算 float64 和 complex128 做乘法的时候报错了，CI 中是编译的 develop 版本，但是我用 release 的 windows 版本的 paddlepaddle 2.3.2 在本地是可以执行这个操作的，这个报错是正常的么？ @iclementine

在静态图运行模式下，有这样严格的类型限制，应该是设计如此的。所以还是加一个 cast 吧。

[PommesPeter]

我观察 CI 发现 paddle.multiply API 在计算 float64 和 complex128 做乘法的时候报错了，CI 中是编译的 develop 版本，但是我用 release 的 windows 版本的 paddlepaddle 2.3.2 在本地是可以执行这个操作的，这个报错是正常的么？ @iclementine

在静态图运行模式下，有这样严格的类型限制，应该是设计如此的。所以还是加一个 cast 吧。

cast 只能在 ['bool', 'float16', 'float32', 'float64', 'int8', 'int16', 'int32', 'int64', 'uint8', 'uint16'] 之间转换，是否可将代码优化成如下方式：

def polar(abs, angle, name=None):
    """
    .....
    """
    check_variable_and_dtype(abs, 'abs', ['float32', 'float64'], 'paddle.polar')
    check_variable_and_dtype(
        angle, 'angle', ['float32', 'float64'], 'paddle.polar'
    )
    return paddle.complex(abs * paddle.cos(angle), abs * paddle.sin(angle))

按照如此可避免 dtype 不相同的问题，并且保证类型严格一致，float to complex 的类型变换只会在 paddle.complex 上变换。

[PommesPeter]

代码已修改，辛苦 review。 @iclementine

[jeff41404]

rfc document link and Chinese document link need to be given in description.

[PommesPeter]

rfc document link and Chinese document link need to be given in description.

okay, I have updated doc links in the description.

[PommesPeter]

rfc doc here: PaddlePaddle/community#364
Chinese doc here: PaddlePaddle/docs#5639

[jeff41404]

LGTM

[sunzhongkai588]

LGTM