abind: Combine generalized arrays
In garray: Generalized Array Arithmetic for Ragged Arrays with Named Margins

Description Usage Arguments Details Examples

Combine generalized arrays, similar to the manner cbind and rbind work. Put a sequence of generalized arrays and get a single generalized array of the same or one more margins.

1	abind(..., margins = character(), along = character())

`...`	arrays, or a list of several arrays. Margins of these arrays should be the same.
`margins`	Resulting margins. If includes a totally new margin (not used by any arrays in `...`), then `along` is neglected and the new margin setting `along`. If no new name and `length(along)==0L`, the last `margins` become along. If `0L==length(margins)`, `along` will become last dimensions of output.
`along`	The dimension along which to bind the arrays. The arrays may have different lengths along that dimension, and are bind along it, with addition subdimension '*.bind.from' indicating the composition of the `along` dimension. Some arrays may not have that margin, then the dimension of these arrays expand to 1. If `along` is a totally new margin, it is created. In such case, all arrays should have the same dimension.

Combine sdim correctly. Saving or dropping of subdimensions follow a few rules: subdimensions of the margin with bound along are dropped; of the other margins are save unless the names of subdimensions are the same; subdimensions of the same names are dropped except the first one.

a <- garray(1:24, c(4,6),
	dimnames=list(X=1:4, Y=letters[1:6]),
 	sdim=list(XX=c(x1=3,x2=1), YY=c(y1=1,y2=2)))
b <- garray(1:6/10,6,dimnames=list(Y=letters[1:6]))
ab <- abind(a=a, b=b, along="X")
#abind(a, b, margins=c("X","Y"))	# Error
ab2 <- abind(a=a, b=b, margins=c("X","Y"), along="X")
aa <- abind(a=a, a=a, along="Z")
ab3 <- abind(a, b, along="X")