cast_dim2hier: Cast Dimensional List into Hierarchical List

In broadcast: Broadcasted Array Operations Like 'NumPy'

Cast Dimensional List into Hierarchical List

Description

cast_dim2hier() casts a dimensional list (i.e. an array of type list) into a hierarchical/nested list.

Usage

cast_dim2hier(x, ...)

## Default S3 method:
cast_dim2hier(x, in2out = TRUE, distr.names = TRUE, ...)

Arguments

x	an array of type list.
...	further arguments passed to or from methods.
in2out	see broadcast_casting.
distr.names	TRUE or FALSE, indicating if dimnames from x should be distributed over the nested elements of the output. See examples section for demonstration.

Value

A nested list.

See Also

broadcast_casting

Examples

x <- array(c(as.list(1:24), as.list(letters)), 4:2)
dimnames(x) <- list(
  letters[1:4],
  LETTERS[1:3],
  month.abb[1:2]
)
print(x)


# cast `x` from in to out, and distribute names:
x2 <- cast_dim2hier(x, distr.names = TRUE)
head(x2, n = 2)

# cast `x` from out to in, and distribute names:
x2 <- cast_dim2hier(x, in2out = FALSE, distr.names = TRUE)
head(x2, n = 2)

broadcast documentation built on Aug. 20, 2026, 9:08 a.m.