Learn R Programming

brainGraph (version 2.7.3)

partition: Partition a design matrix into columns of interest and nuisance

Description

Consider the matrix formulation of the general linear model: $$\mathbf{Y} = \mathbf{M} \psi + \in$$ where \(Y\) is the vector of outcomes, \(M\) is the full design matrix (including nuisance covariates), \(\psi\) is the vector of parameter estimates, and \(\in\) is the vector of error terms. In a permutation framework, algorithms are applied differently depending on the presence/absence of nuisance covariates; thus the model is separated depending on the contrast of interest: $$\mathbf{Y} = \mathbf{X}\beta + \mathbf{Z}\gamma + \in$$ where \(\mathbf{X}\) contains covariates of interest, \(\mathbf{Z}\) contains nuisance covariates, and \(\beta\) and \(\gamma\) are the associated parameter estimates.

Usage

partition(M, con.mat, part.method = c("beckmann", "guttman"))

Arguments

M

Numeric matrix; the full design matrix

con.mat

Numeric matrix; the contrast matrix

part.method

Character string; the method of partitioning (default: beckmann)

Value

A list containing:

X

Numeric matrix for the covariates of interest

Z

Numeric matrix for the nuisance covariates

eCm

The effective contrast, equivalent to the original, for the partitioned model [X, Z] and considering all covariates

eCx

Same as eCx, but considering only X

References

Guttman I. Linear Models: An Introduction. Wiley, New York, 1982.

Smith SM, Jenkinson M, Beckmann C, Miller K, Woolrich M (2007). Meaningful design and contrast estimability in fMRI. NeuroImage, 34(1):127-36.