Engee documentation

LDL Inverse

Calculation of the inverse Hermitian positive definite matrix using LDL decomposition.

blockType: SubSystem

Path in the library:

/Signal Operations/Math Functions/Matrices and Linear Algebra/Matrix Inverses/LDL Inverse

Description

Block LDL Inverse computes the inverse matrix of a Hermitian positive definite input matrix using LDL decomposition:

,

where

  • — lower triangular matrix with single diagonal elements (single triangular matrix);

  • — diagonal matrix;

  • — Hermitian (complex conjugate) transposed matrix .

The block uses only the elements of the diagonal and above the main diagonal of the matrix and ignores the rest. Imaginary parts in diagonal elements are ignored.

The LDL decomposition requires half as many calculations as the Gaussian variable elimination method (LU decomposition), and is always stable. The LDL decomposition is more efficient than the Cholesky decomposition because it avoids calculating square roots from diagonal elements.

Ports

Input

# IN_1 — the input matrix
matrix M by M

Details

Input square matrix on . The matrix must be Hermitian positive definite.

If the input matrix is not positive definite, then the behavior of the block depends on the value of the parameter Non-positive definite input.

Data types

Float32, Float64

Complex numbers support

Yes

Output

# OUT_1 — the inverse matrix
matrix M by M

Details

The inverse of the input matrix on .

Data types

Float32, Float64

Complex numbers support

Yes

Parameters

Main group

# Non-positive definite input — block behavior if the input matrix is not positive definite
Ignore | Warning | Error

Details

Specify the behavior of the block in case the input matrix is not positive definite:

  • Ignore — the block continues calculations and does not issue a warning. The result is not the right solution.

  • Warning — the block continues calculations, but in the command window Engee A warning message is displayed. The result is not the right solution.

  • Error — the error dialog box is displayed and the calculations are stopped.

Parameter Non-positive definite input it is diagnostic. Like all diagnostic parameters, it is set to Ignore in the code generated for this block by the code generator.
Values

Ignore | Warning | Error

Default value

Ignore

Program usage name

dropdown_1

Tunable

No

Evaluatable

Yes

Literature

  1. Golub, Gene H., and Charles F. Van Loan. Matrix Computations. 3rd ed. Baltimore, MD: Johns Hopkins University Press, 1996.