cat (MATLAB Functions)

Concatenate arrays along specified dimension

Syntax

C = cat(dim, A, B)
C = cat(dim, A1, A2, A3, A4, ...)

Description

C = cat(dim, A, B) concatenates the arrays A and B along dim.

C = cat(dim, A1, A2, A3, A4, ...) concatenates all the input arrays (A1, A2, A3, A4, and so on) along dim.

cat(2, A, B) is the same as [A, B], and cat(1, A, B) is the same as [A; B].

Remarks

When used with comma-separated list syntax, cat(dim, C{:}) or cat(dim, C.field) is a convenient way to concatenate a cell or structure array containing numeric matrices into a single matrix.

Examples

Given

A =               B =
     1     2                   5     6
     3     4                   7     8

concatenating along different dimensions produces

The commands

A = magic(3); B = pascal(3);
C = cat(4, A, B);

produce a 3-by-3-by-1-by-2 array.

See Also

num2cell

The special character []

cast catch