Permute array axes

rray_permute_axes() reorders the axes of an array.

Usage

rray_permute_axes(x, axes)

Arguments

x

An array.

axes

An integer vector. It must use each axis of x exactly once.

Value

An array with the axes of x reordered by axes.

Details

Names travel with their axis to its new position.

rray_permute_axes(x, c(2, 1)) transposes a matrix, like t().

See also

rray_move_axes()

Examples

x <- array(1:6, c(2, 3))

# Transpose a matrix
rray_permute_axes(x, c(2, 1))
#>      [,1] [,2]
#> [1,]    1    2
#> [2,]    3    4
#> [3,]    5    6

y <- array(1:24, c(4, 3, 2))

# Reverse every axis
# (4, 3, 2) -> (2, 3, 4)
rray_dimensions(rray_permute_axes(y, c(3, 2, 1)))
#> [1] 2 3 4

# Swap the first two axes, leaving the third alone
# (4, 3, 2) -> (3, 4, 2)
rray_dimensions(rray_permute_axes(y, c(2, 1, 3)))
#> [1] 3 4 2