permute_dims

permute_dims(x: array, /, axes: Tuple[int, ...]) → array

Permutes the axes of an array x.

Parameters:

• x (array) – input array.

• axes (Tuple[int, ...]) – tuple containing a permutation of axes. A valid axis must be an integer on the interval [-N, N), where N is the number of axes in x. If an axis is specified as a negative integer, the function must determine the respective axis index by counting backward from the last axis (where -1 refers to the last axis). If provided an invalid axis, the function must raise an exception.

Returns:

out (array) – an array containing the axes permutation. The returned array must have the same data type as x.