mindspore/docs/api/api_python/ops/mindspore.ops.ApplyPowerSig...

43 lines
2.6 KiB
ReStructuredText
Raw Normal View History

mindspore.ops.ApplyPowerSign
=============================
.. py:class:: mindspore.ops.ApplyPowerSign
根据AddSign算法更新相关参数。
AddSign算法可参阅论文 `Neural Optimizer Search with Reinforcement Learning <https://arxiv.org/abs/1709.07417>`_
.. math::
\begin{array}{ll} \\
m_{t+1} = \beta * m_{t} + (1 - \beta) * g \\
\text{update} = \exp(\text{logbase} * \text{sign_decay} * sign(g) * sign(m)) * g \\
var = var - lr_{t+1} * \text{update}
\end{array}
:math:`t` 表示更新步长,而 :math:`m` 表示第一个时刻向量, :math:`m_{t}`:math:`m_{t+1}` 的最后时刻, :math:`lr` 表示 `lr` :math:`g` 表示 `grad` :math:`\beta` 表示 `beta`
所有输入都遵循隐式类型转换规则,以使数据类型一致。如果 `lr``logbase``sign_decay``beta` 是数值型则会自动转换为Tensor数据类型与操作中涉及的Tensor的数据类型一致。如果输入是Tensor并且具有不同的数据类型则低精度数据类型将转换为最高精度的数据类型。
**输入:**
- **var**Parameter- 要更新的变量任意维度其数据类型为float32或float16。如果 `var` 的数据类型为float16则所有输入的数据类型必须与 `var` 相同。
- **m** (Parameter) - 要更新的变量shape和数据类型与 `var` 相同。
- **lr** (Union[Number, Tensor]) - 学习率应该是Scalar或Tensor数据类型为float32或float16。
- **logbase** (Union[Number, Tensor])- 应该是Scalar或Tensor数据类型为float32或float16。
- **sign_decay** (Union[Number, Tensor]) - 应该是Scalar或Tensor数据类型为float32或float16。
- **beta** (Union[Number, Tensor])- 指数衰减率应该是Scalar或Tensor数据类型为float32或float16。
- **grad** (Tensor) - 梯度shape和数据类型与 `var` 相同。
**输出:**
2个Tensor组成的tuple更新后的参数。
- **var** (Tensor) - shape和数据类型与 `var` 相同。
- **m** (Tensor) - shape和数据类型与 `m` 相同。
**异常:**
- **TypeError** - 如果 `var``lr``logbase``sign_decay``beta``grad` 的数据类型既不是float16也不是float32。
- **TypeError** - 如果 `lr``logbase``sign_decay``beta` 既不是数值型也不是Tensor。
- **TypeError** - 如果 `grad` 不是Tensor。
- **RuntimeError** - 如果 `lr``logbase``sign_decay``grad` 不支持数据类型转换。