Create a Hyperdesign Object

Constructs a new `hyperdesign` object that encapsulates a collection of `multidesign` objects. Used to model multi-group, multi-block, or multi-view datasets, where each block/group/view is associated with a matrix-variate response and an arbitrary design.

Usage

hyperdesign(x, block_names = NULL)

Arguments

x

A list of multidesign objects. Each instance should represent a related block of data

block_names

Optional character vector of names for each block

Value

A hyperdesign object with the following components:

blocks

List of multidesign objects

block_names

Names of each block

col_indices

Matrix of column start/end indices for each block

row_indices

Matrix of row start/end indices for each block

Details

A hyperdesign object represents a collection of related multivariate datasets (multidesign instances) that share common design variables. This structure is particularly useful for: * Multiple subjects in an experiment * Multiple sessions or runs * Multiple data modalities (e.g., fMRI, EEG, behavioral) * Multiple response measures

See also

df_to_hyperdesign for creating hyperdesign objects from data frames, multidesign for the underlying multidesign structure, multiblock for another multi-block data structure

Examples

# Create three multidesign objects (e.g., for three subjects)
d1 <- multidesign(
  matrix(rnorm(10*20), 10, 20),
  data.frame(y=1:10, subject=1, run=rep(1:5, 2))
)
d2 <- multidesign(
  matrix(rnorm(10*20), 10, 20),
  data.frame(y=1:10, subject=2, run=rep(1:5, 2))
)
d3 <- multidesign(
  matrix(rnorm(10*20), 10, 20),
  data.frame(y=1:10, subject=3, run=rep(1:5, 2))
)

# Combine into a hyperdesign
hd <- hyperdesign(
  list(d1, d2, d3),
  block_names = c("subject1", "subject2", "subject3")
)