• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1mindspore.ops.MatrixPower
2=========================
3
4.. py:class:: mindspore.ops.MatrixPower(n)
5
6    计算一个batch的方阵的n次幂。
7    如果 :math:`n=0` ,则返回一个batch的单位矩阵。
8    如果n为负数,则为返回每个矩阵(如果可逆)逆矩阵的 :math:`abs(n)` 次幂。
9
10    .. warning::
11        这是一个实验性API,后续可能修改或删除。
12
13    参数:
14        - **n** (int) - 指数,必须是整数。
15
16    输入:
17        - **x** (Tensor) - 一个3-D Tensor。shape为 :math:`(b, m, m)` ,表示b个m-D的方阵。
18
19    输出:
20        - **y** (Tensor) - 一个3-D Tensor,与 `x` 的shape和数据类型均相同。
21
22    异常:
23        - **TypeError** - 如果 `n` 的数据类型不是整数。
24        - **TypeError** - 如果 `x` 不是Tensor。
25        - **ValueError** - 如果 `x` 不是一个3-D Tensor。
26        - **ValueError** - 如果 `x` 的shape[1]和shape[2]不同。
27        - **ValueError** - 如果 `n` 为负数,但是输入 `x` 中存在奇异矩阵。
28        - **ValueError** - 如果 `n` < 0 且输入为int类型。