rray (version 0.1.0)

rray_expand: Insert a dimension into an rray

Description

rray_expand() inserts a new dimension at the axis dimension. This expands the number of dimensions of x by 1.

Usage

rray_expand(x, axis)

Arguments

x

An rray.

axis

An integer of size 1 specifying the location of the new dimension.

Value

x with a new dimension inserted at the axis.

Details

Dimension names are kept through the insertion of the new dimension.

Examples

# NOT RUN {
x <- rray(1:10, c(5, 2))
x <- rray_set_row_names(x, letters[1:5])
x <- rray_set_col_names(x, c("c1", "c2"))

# (5, 2)
# Add dimension to the front
# (1, 5, 2) = 1 row, 5 cols, 2 deep
rray_expand(x, 1)

# (5, 2)
# Add dimension to the middle
# (5, 1, 2) = 5 rows, 1 col, 2 deep
rray_expand(x, 2)

# (5, 2)
# Add dimension to the end
# (5, 2, 1) = 5 rows, 2 cols, 1 deep
rray_expand(x, 3)

# In some cases this is different than a simple
# rray_reshape() because the dimension names
# follow the original dimension position
# - 5 row names follow to the new 5 column position
# - 2 col names follow to the new 2 deep position
# - result has no row names because that is the new axis
rray_expand(x, 1)

# A reshape, on the other hand,
# drops all dimension names
rray_reshape(x, c(1, 5, 2))

# }