pow

paddle. pow ( x, y, name=None, *, out=None ) [源代码]

指数算子,逐元素计算 xy 次幂。

\[out = x^{y}\]

备注

别名支持: 参数名 input 可替代 x,参数名 exponent 可替代 y ,如 pow(input=2, exponent=1.1) 等价于 pow(x=2, y=1.1)

参数

  • x (Tensor)- 多维 Tensor,数据类型为 bfloat16float16float32float64int32int64 。别名: input

  • y (float|int|Tensor)- 如果类型是多维 Tensor,其数据类型应该和 x 相同。别名: exponent

  • name (str,可选) - 具体用法请参见 api_guide_Name,一般无需设置,默认值为 None。

关键字参数

  • out (Tensor,可选) - 输出 Tensor,若不为 None,计算结果将保存在该 Tensor 中,默认值为 None

返回

Tensor,维度和数据类型都和 x 相同。

代码示例

>>> import paddle

>>> x = paddle.to_tensor([1, 2, 3], dtype='float32')

>>> # example 1: y is a float or int
>>> res = paddle.pow(x, 2)
>>> print(res)
Tensor(shape=[3], dtype=float32, place=Place(cpu), stop_gradient=True,
[1., 4., 9.])
>>> res = paddle.pow(x, 2.5)
>>> print(res)
Tensor(shape=[3], dtype=float32, place=Place(cpu), stop_gradient=True,
[1.         , 5.65685415 , 15.58845711])

>>> # example 2: y is a Tensor
>>> y = paddle.to_tensor([2], dtype='float32')
>>> res = paddle.pow(x, y)
>>> print(res)
Tensor(shape=[3], dtype=float32, place=Place(cpu), stop_gradient=True,
[1., 4., 9.])