• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1mindspore.ops.ApplyPowerSign
2=============================
3
4.. py:class:: mindspore.ops.ApplyPowerSign
5
6    根据AddSign算法更新相关参数。
7
8    AddSign算法可参阅论文 `Neural Optimizer Search with Reinforcement Learning <https://arxiv.org/abs/1709.07417>`_ 。
9
10    .. math::
11        \begin{array}{ll} \\
12            m_{t+1} = \beta * m_{t} + (1 - \beta) * g \\
13            \text{update} = \exp(\text{logbase} * \text{sign_decay} * sign(g) * sign(m)) * g \\
14            var = var - lr_{t+1} * \text{update}
15        \end{array}
16
17    :math:`t` 表示更新步数，而 :math:`m` 为一阶矩， :math:`m_{t}` 是上一步的 :math:`m_{t+1}` ， :math:`lr` 表示 `lr` ， :math:`g` 表示 `grad` ， :math:`\beta` 表示 `beta` 。
18
19    所有输入都遵循隐式类型转换规则，以使数据类型一致。如果 `lr` 、 `logbase` 、 `sign_decay` 或 `beta` 是数值型，则会自动转换为Tensor，数据类型与操作中涉及的Tensor的数据类型一致。如果输入是Tensor，并且具有不同的数据类型，则低精度数据类型将转换为最高精度的数据类型。
20
21    .. note::
22        目前Ascend平台上暂未开放对float64数据类型的支持。
23
24    输入：
25        - **var** (Parameter) - 要更新的变量。数据类型为float64、float32或float16。如果 `var` 的数据类型为float16，则所有输入的数据类型必须与 `var` 相同。shape： :math:`(N, *)` ，其中 :math:`*` 表示任意数量的附加维度。
26        - **m** (Parameter) - 要更新的变量，shape与 `var` 相同。
27        - **lr** (Union[Number, Tensor]) - 学习率，应该是Scalar或Tensor，数据类型为float64、float32或float16。
28        - **logbase** (Union[Number, Tensor]) - 应该是Scalar或Tensor，数据类型为float64、float32或float16。
29        - **sign_decay** (Union[Number, Tensor]) - 应该是Scalar或Tensor，数据类型为float64、float32或float16。
30        - **beta** (Union[Number, Tensor]) - 指数衰减率，应该是Scalar或Tensor，数据类型为float64、float32或float16。
31        - **grad** (Tensor) - 梯度，shape与 `var` 相同。
32
33    输出：
34        2个Tensor组成的tuple，更新后的参数。
35
36        - **var** (Tensor) - shape和数据类型与 `var` 相同。
37        - **m** (Tensor) - shape和数据类型与 `m` 相同。
38
39    异常：
40        - **TypeError** - 如果 `var` 、 `lr` 、 `logbase` 、 `sign_decay` 、 `beta` 或 `grad` 的数据类型不是float16、float32或者float64。
41        - **TypeError** - 如果 `lr` 、 `logbase` 、 `sign_decay` 或 `beta` 既不是数值型也不是Tensor。
42        - **TypeError** - 如果 `grad` 不是Tensor。
43        - **TypeError** - 如果 `lr` 、 `logbase` 、 `sign_decay` 和 `grad` 不支持数据类型转换。
44