# vertcat

Concatenate `fi` object arrays vertically

## Syntax

``C = vertcat(A,B)``
``C = vertcat(A1,A2,…An)``

## Description

example

````C = vertcat(A,B)` concatenates `B` vertically to the end of `A` when any of `A` and `B` is a `fi` object.`A` and `B` must have the same number of columns. Multidimensional arrays are vertically concatenated along the first dimension. The remaining dimensions must match.```

example

````C = vertcat(A1,A2,…An)` concatenates `A1,A2,…An` vertically when any of `A1,A2,…An` is a `fi` object.`A` and `B` must have the same number of columns. Multidimensional arrays are vertically concatenated along the first dimension. The remaining dimensions must match.`vertcat` is equivalent to using square brackets for vertically concatenating arrays. For example, `[A; B]` is equal to `vertcat(A,B)` when `A` and `B` are compatible arrays.Horizontal and vertical concatenation can be combined, as in ```[a b;c d]```.`[a b; c]` is allowed if the number of rows of `a` equals the number of rows of `b`, and if the number of columns of `a` plus the number of columns of `b` equals the number of columns of `c`.The matrices in a concatenation expression can themselves be formed via a concatenation, as in `[a b;[c d]]`. NoteThe `fimath` and `numerictype` objects of a concatenated matrix of `fi` objects `C` are taken from the leftmost `fi` object in the list `A1,A2,…An`. ```

## Examples

collapse all

Create two matrices and concatenate them vertically, first by using square bracket notation, and then by using `vertcat`.

`A = fi([1 2 3; 4 5 6])`
```A = 1 2 3 4 5 6 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 16 FractionLength: 12```
`B = fi([7 8 9],0,8)`
```B = 7 8 9 DataTypeMode: Fixed-point: binary point scaling Signedness: Unsigned WordLength: 8 FractionLength: 4```
`C = [A; B]`
```C = 1.0000 2.0000 3.0000 4.0000 5.0000 6.0000 7.0000 7.9998 7.9998 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 16 FractionLength: 12```
`D = vertcat(A,B)`
```D = 1.0000 2.0000 3.0000 4.0000 5.0000 6.0000 7.0000 7.9998 7.9998 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 16 FractionLength: 12```

Note that the `numerictype` of concatenated matrix `D` is taken from the leftmost `fi` object in the input list.

## Input Arguments

collapse all

First input, specified as a scalar, vector, matrix, or multidimensional array.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64` | `fi`
Complex Number Support: Yes

Second input, specified as a scalar, vector, matrix, or multidimensional array.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64` | `fi`
Complex Number Support: Yes

List of inputs, specified as a comma-separated list of elements to concatenate in the order they are specified.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64` | `fi`
Complex Number Support: Yes

## Version History

Introduced before R2006a