mindspore.numpy.matrix_power
- mindspore.numpy.matrix_power(a, n)[source]
Raises a square matrix to the (integer) power n.
For positive integers n, the power is computed by repeated matrix squarings and matrix multiplications. If \(n == 0\), the identity matrix of the same shape as M is returned.
Note
Stacks of object matrices are not currently supported and \(n < 0\) is not supported.
- Parameters
- Returns
Tensor.
- Raises
TypeError – if the input can not be converted to a tensor or the exponent is not integer.
ValueError – if the input includes less than 2 dimensions or the last 2 dimensions are not square.
- Supported Platforms:
Ascend
GPU
CPU
Examples
>>> from mindspore import numpy as np >>> a = np.arange(16).reshape(4, 4).astype('float32') >>> print(np.matrix_power(a, 2)) [[ 56. 62. 68. 74.] [152. 174. 196. 218.] [248. 286. 324. 362.] [344. 398. 452. 506.]]