superMatrix {psych} R Documentation

## Form a super matrix from two sub matrices.

### Description

Given the matrices nXm, and jYk, form the super matrix of dimensions (n+j) and (m+k) with with elements x and y along the super diagonal. Useful when considering structural equations. The measurement models x and y can be combined into a larger measurement model of all of the variables. If either x or y is a list of matrices, then recursively form a super matrix of all of those elements.

### Usage

```superMatrix(x,y)
super.matrix(x, y)  #Deprecated
```

### Arguments

 `x` A n x m matrix or a list of such matrices `y` A j x k matrix or a list of such matrices

### Details

Several functions, e.g., `sim.structural`,`structure.graph`, `make.keys` use matrices that can be thought of as formed from a set of submatrices. In particular, when using `make.keys` in order to score a set of items (`scoreItems` or `scoreOverlap`) or to form specified clusters (`cluster.cor`), it is convenient to define different sets of scoring keys for different sets of items and to combine these scoring keys into one super key.

### Value

A (n+j) x (m +k) matrix with appropriate row and column names

### Author(s)

William Revelle

`sim.structural`,`structure.graph`, `make.keys`

### Examples

```mx <- matrix(c(.9,.8,.7,rep(0,4),.8,.7,.6),ncol=2)
my <- matrix(c(.6,.5,.4))

colnames(mx) <- paste("X",1:dim(mx)[2],sep="")
rownames(mx) <- paste("Xv",1:dim(mx)[1],sep="")
colnames(my) <- "Y"
rownames(my) <- paste("Yv",1:3,sep="")
mxy <- superMatrix(mx,my)
#show the use of a list to do this as well
key1 <- make.keys(6,list(first=c(1,-2,3),second=4:6,all=1:6))  #make a scoring key
key2 <- make.keys(4,list(EA=c(1,2),TA=c(3,4)))
superMatrix(list(key1,key2))
```

[Package psych version 1.7.8 ]