cat - 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 array dimension dim.

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

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

Tips

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.

For information on combining unlike integer types, integers with nonintegers, cell arrays with non-cell arrays, or empty matrices with other elements, see Combining Unlike Classes in the Programming Fundamentals documentation.

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

horzcat | num2cell | reshape | shiftdim | special character | squeeze | strcat | strvcat | vertcat

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS