Vector Concatenate, Matrix Concatenate

Concatenate input signals of same data type for iterative processing

• Library:

• Simulink / Commonly Used Blocks

  Simulink / Math Operations

  Simulink / Matrix Operations

  Simulink / Signal Routing

  HDL Coder / Math Operations

  HDL Coder / Signal Routing

• 
• 

Description

The Vector Concatenate and Matrix Concatenate blocks concatenate input signals to create a nonscalar signal that you can iteratively process with a subsystem, for example, a for-each, while-iterator, or for-iterator subsystem.

In the Simulink^® library, these blocks are different configurations of the same block. They differ based on the setting of their Mode parameter, which determines whether the block operates in vector or multidimensional array concatenation mode. The input signal requirements and output signal depend on the mode of concatenation.

Block	Mode Setting	Input Signal Requirements	Output Signal
Vector Concatenate	Vector	Vectors Row vectors (1-by-M matrices) Column vectors (M-by-1 matrices) Combination of vectors and either row or column vectors	When all inputs are vectors, the output is a vector. If any of the inputs are row or column vectors, the output is a row or column vector, respectively. Tip To create a vector of function calls, use a Mux block.
Matrix Concatenate	Multidimensional array	Signals of any dimensionality (scalars, vectors, and matrices)	The output is always an array. Trailing dimensions are assumed to be 1 for lower dimensionality inputs. For example, if the output is 4-D and the input is [2x3] (2-D), this block treats the input as [2x3x1x1]. Concatenation is on the dimension that you specify with the Concatenate dimension parameter.

The signals in the output signal appear in the same order as the input signals for the block. For a description of the port order for various block orientations, see Port Location After Rotating or Flipping.

You can use multiple Vector Concatenate or Matrix Concatenate blocks to create the output signal in stages, but the result is flat, as if you used a single block to concatenate the signals.

You must use a Vector Concatenate or Matrix Concatenate block to define an array of buses. For more information, see Group Nonvirtual Buses in Arrays of Buses.

Ports

Input

Port_1 — First input to concatenate

scalar | vector | matrix | N-D array

First input to concatenate, specified as a scalar, vector, matrix, or N-D array.

• Inputs must be of the same data type.

• Matrix and N-D array inputs are supported only when you set Mode to Multidimensional array.

When the data type is a Simulink.Bus object, the inputs must be nonvirtual buses.

Data Types: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus | image

Port_N — Nth input to concatenate

scalar | vector | matrix | N-D array

Nth input to concatenate, specified as a scalar, vector, matrix, or N-D array.

• Inputs must be of the same data type.

• Matrix and N-D array inputs are supported only when you set Mode to Multidimensional array.

Dependencies

To enable this port, set Number of inputs to an integer greater than or equal to 2.

Data Types: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus | image

Output

Port_1 — Concatenation of input signals

scalar | vector | matrix | N-D array

Concatenation of input signals along specified dimension. Outputs have the same data type as the input.

Data Types: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus | image

Parameters

Number of inputs — Number of input ports

2 (default) | positive integer

Specify the number of inputs for the block as a real-valued, positive integer, less than or equal to 65536.

Programmatic Use

Block Parameter: NumInputs

Type: character vector

Values: positive integer

Default: '2'

Mode — Type of concatenation

Vector | Multidimensional array

Select the type of concatenation that this block performs. The default Mode of the Vector Concatenate block is Vector. The default Mode of the Matrix Concatenate block is Multidimensional array.

• When you select Vector, the block performs vector concatenation.

• When you select Multidimensional array, the block performs matrix concatenation.

Mode Setting	Input Signals	Output
Vector	Vectors Row vectors (1-by-M matrices) Column vectors (M-by-1 matrices) Combination of vectors and either row or column vectors	When all inputs are vectors, the output is a vector. If any of the inputs are row or column vectors, the output is a row or column vector, respectively.
Multidimensional array	Signals of any dimensionality (scalars, vectors, and matrices)	The output is always an array. Trailing dimensions are assumed to be 1 for lower dimensionality inputs. For example, if the output is 4-D and the input is [2x3] (2-D), this block treats the input as [2x3x1x1]. Concatenation is on the dimension that you specify with the Concatenate dimension parameter.

Programmatic Use

Block Parameter: Mode

Type: character vector

Values: 'Vector' | 'Multidimensional array'

Default: 'Vector'

Concatenate dimension — Output dimension along which to concatenate input arrays

1 (default) | scalar integer

Specify the output dimension along which to concatenate the input arrays.

• To concatenate input arrays vertically, enter 1.

• To concatenate input arrays horizontally, enter 2.

• To perform multidimensional concatenation on the inputs, specify an integer greater than 2.

If this parameter is set to 1 and the block inputs are 2-D matrices, the block performs vertical matrix concatenation and stacks the input matrices on top of each other to create the output matrix. For example, see the ex_concatenate_vertical model.

If you set this parameter to 2 and the block inputs are 2-D matrices, the block performs horizontal matrix concatenation and places the input matrices side by side to create the output matrix. For example, see the ex_concatenate_horizontal model.

The input matrices must have compatible sizes for concatenation. Vertical concatenation requires the input matrices to have the same number of columns. Horizontal concatenation requires input matrices to have the same number of rows.

If you set this parameter to 3 and the block inputs are 2-D matrices, the block performs multidimensional matrix concatenation. For example, see the ex_concatenate_multidims model

Dependencies

To enable this parameter, set Mode to Multidimensional array.

Programmatic Use

Block Parameter: ConcatenateDimension

Type: character vector

Values: scalar integer

Default: '1'

Model Examples

Horizontal Matrix Concatenation

Perform a horizontal matrix concatenation with the Matrix Concatenate block.

Open Model

Vertical Matrix Concatenation

Perform a vertical matrix concatenation with the Matrix Concatenate block.

Open Model

Multidimensional Matrix Concatenation

Perform multidimensional matrix concatenation with the Matrix Concatenate block.

Open Model

Model Arrays of Buses

Use arrays of buses to represent structured data compactly.

Open Model

Block Characteristics

Data Types	Boolean | double | enumerated | fixed point | half | integer | single
Direct Feedthrough	yes
Multidimensional Signals	yes
Variable-Size Signals	yes
Zero-Crossing Detection	no

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

HDL Code Generation

Generate Verilog and VHDL code for FPGA and ASIC designs using HDL Coder™.

HDL Coder™ provides additional configuration options that affect HDL implementation and synthesized logic.

HDL Architecture

This block has one default HDL architecture.

HDL Block Properties

ConstrainedOutputPipeline	Number of registers to place at the outputs by moving existing delays within your design. Distributed pipelining does not redistribute these registers. The default is 0. For more details, see ConstrainedOutputPipeline (HDL Coder).
InputPipeline	Number of input pipeline stages to insert in the generated code. Distributed pipelining and constrained output pipelining can move these registers. The default is 0. For more details, see InputPipeline (HDL Coder).
OutputPipeline	Number of output pipeline stages to insert in the generated code. Distributed pipelining and constrained output pipelining can move these registers. The default is 0. For more details, see OutputPipeline (HDL Coder).

Complex Data Support

This block supports code generation for complex signals.

FOR-GENERATE Loop Support

For this block, HDL Coder generates code using FOR-GENERATE loop when you set the target language to VHDL^®. For more information, see Unroll For-Generate Loops in VHDL Code (HDL Coder)

PLC Code Generation
Generate Structured Text code using Simulink® PLC Coder™.

Fixed-Point Conversion
Design and simulate fixed-point systems using Fixed-Point Designer™.

Version History

Introduced in R2009b