- matrix_power(x: array, n: int, /) array ¶
Raises a square matrix (or a stack of square matrices)
xto an integer power
x (array) – input array having shape
(..., M, M)and whose innermost two dimensions form square matrices. Should have a floating-point data type.
n (int) – integer exponent.
out (array) – if
nis equal to zero, an array containing the identity matrix for each square matrix. If
nis less than zero, an array containing the inverse of each square matrix raised to the absolute value of
n, provided that each square matrix is invertible. If
nis greater than zero, an array containing the result of raising each square matrix to the power
n. The returned array must have the same shape as
xand a floating-point data type determined by Type Promotion Rules.