matrix_power¶
- matrix_power(x: array, n: int, /) array ¶
Raises a square matrix (or a stack of square matrices)
x
to an integer powern
.- Parameters:
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.
- Returns:
out (array) – if
n
is equal to zero, an array containing the identity matrix for each square matrix. Ifn
is less than zero, an array containing the inverse of each square matrix raised to the absolute value ofn
, provided that each square matrix is invertible. Ifn
is greater than zero, an array containing the result of raising each square matrix to the powern
. The returned array must have the same shape asx
and a floating-point data type determined by Type Promotion Rules.
Notes
Changed in version 2022.12: Added complex data type support.