Create Diagonal Matrix

R2026b

Create square diagonal matrix from diagonal elements

• 

Create Diagonal Matrix block

To add a block to a model, double-click the canvas and start typing the block name. Then, select the block from the list.

Libraries:
Simulink / Matrix Operations

Description

The Create Diagonal Matrix block populates the diagonal of the M-by-M matrix output with the elements contained in the length-M vector input D. The elements off the diagonal are zero.

Equivalent MATLAB^® code is given by:

A = diag(D)

Examples

Generate Diagonal Matrix from Vector Input

This example shows how to use the Create Diagonal Matrix block.

Open the Simulink® model.

The Create Diagonal Matrix block creates a diagonal matrix from the input values. The output matrix in the model has the input vector as its diagonal.

Run the model to verify the output.

Ports

Input

Port_1 — Input signal

vector

Input to convert into a diagonal matrix, specified as an M-element vector.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point
Complex Number Support: Yes

Output

Port_1 — Output signal

matrix

Output specified as an M-by-M matrix, where M is the length of the input vector.

The output is equivalent to:

A = diag(D)		% Equivalent MATLAB code 

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point
Complex Number Support: Yes

Block Characteristics

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

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"simulink/Matrix Operations/Create Diagonal Matrix"

Example: add_block("simulink/Matrix Operations/Create Diagonal Matrix","myModel/myBlock",MakeNameUnique="on")

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using Simulink® Coder™.

Generated code relies on the memcpy or memset function (string.h) under certain conditions.

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

Version History

Introduced before R2006a

R2021b: Create Diagonal Matrix Block Moved to Simulink Matrix Operations Library

The Create Diagonal Matrix block has been moved from the DSP System Toolbox > Math Functions > Matrices and Linear Algebra > Matrix Operations library to the Simulink > Matrix Operationslibrary. All existing models continue to work.