MATLAB Function Reference

cat

Concatenate arrays

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 []

case

catch