Next: vecread() Up: MacAnova Help File Previous: vboxplot()   Contents

vconcat()

Usage:
vconcat(a,b,c,... [,labels:structure(rowLabs,colLabs), silent:T]) where
  a, b, c, ... matrices and rowLabs and colLabs are CHARACTER scalars or
  vectors



Keywords: combining variables, variables, null variables
vconcat(a,b,c,...) combines matrices a, b, c ... vertically by
concatenating their columns.

All arguments must be of the same type, REAL, LOGICAL, or CHARACTER, and
have the same number of columns n.  The result is a matrix of that type
with n columns and ma+mb+mc+... rows, where ma, mb, mc, ... are the
number of rows of a, b, c, ... .

vconcat(a,b,...,labels:structure(rowLabs,colLabs) [,silent:T]) uses
CHARACTER scalars or vectors rowLabs and colLabs as row and column
labels for the result.  With silent:T, no warning is printed if labels
are the wrong size.  See topic 'labels' for details.

Any argument that is a vector of length m is considered to be a m by 1
matrix.  In particular, if a is a vector of length m, vconcat(a) is a m
by 1 matrix.

An argument that is an array with only two dimensions not equal to 1 is
considered to be a matrix (see 'matrices').  For example,
   vconcat(array(run(6),1,3,2),array(run(7,14),4,1,2))
is equivalent to
   vconcat(matrix(run(6),3),matrix(run(7,14),4))

Any argument of type NULL is ignored.  When all arguments are NULL, so
is the result.

See also topics hconcat(), 'matrices', 'vectors'.


Gary Oehlert 2003-01-15