set_ranknames: Assign ranknames to a tidytensor via a standard function...

Description Usage Arguments Details Value See Also Examples

Description

A tidytensor t may have ranknames(t); this is a character vector of the same length as dim(t) for future use. Note that ranknames(t) is independent of names(t) or dimnames(t); we are not naming elements, or the dimension names for each rank, but rank names themselves. Like names() and dimnames(), unset ranknames() are NULL.

Usage

1
set_ranknames(x, ..., .dots = NULL)

Arguments

x

input tidytensor to set ranknames on.

...

new ranknames to assign (quoted or unquoted).

.dots

character vector of new ranknames to assign.

Details

Ranknames for a tidytensor t are stored as the names() attribute of dimnames(t). If dimnames(t) happens to be null, before setting ranknames() we create valid dimnames() filled with NA values. The tidytensor package also provides a specialized dimnames() which preserves ranknames when setting dimnames().

Value

a tidytensor with ranknames set.

See Also

ranknames<-

Examples

1
2
3
4
t <- as.tidytensor(array(1:(3 * 4 * 5), dim = c(3, 4, 5)))
t <- set_ranknames(t, sample, row, col)
t <- set_ranknames(t, .dots = c("sample", "row", "col"))
print(t)

oneilsh/tidytensor documentation built on Oct. 11, 2021, 11:43 p.m.