HALCON Reference Manual 10.0.2

get_diagonal_matrixget_diagonal_matrixget_diagonal_matrixGetDiagonalMatrixGetDiagonalMatrix (Operator)

Name

get_diagonal_matrixget_diagonal_matrixget_diagonal_matrixGetDiagonalMatrixGetDiagonalMatrix — Get the diagonal elements of a matrix.

Signature

get_diagonal_matrix( : : MatrixID, Diagonal : VectorID)

The operator get_diagonal_matrixget_diagonal_matrixget_diagonal_matrixGetDiagonalMatrixGetDiagonalMatrix generates a new matrix VectorVectorVectorVectorvector and copies the diagonal elements of the MatrixMatrixMatrixMatrixmatrix to this new matrix. The MatrixMatrixMatrixMatrixmatrix is defined by the matrix handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixID. The matrix VectorVectorVectorVectorvector has one column and n rows, where n = number of diagonal elements. The operator returns the matrix handle VectorIDVectorIDVectorIDVectorIDvectorID of the matrix VectorVectorVectorVectorvector. Access to the elements of the matrix is possible e.g. with the operator get_full_matrixget_full_matrixget_full_matrixGetFullMatrixGetFullMatrix.

If DiagonalDiagonalDiagonalDiagonaldiagonal = 0, the output of the VectorVectorVectorVectorvector is the main diagonal of the MatrixMatrixMatrixMatrixmatrix.

Example:


           /   3.0   1.0  -2.0  \
  Matrix = |  -5.0   7.0   2.0  |      Diagonal = 0
           \  -9.0  -4.0   1.0  /

                /  3.0  \
  ->   Vector = |  7.0  |
                \  1.0  /

If DiagonalDiagonalDiagonalDiagonaldiagonal is positive, the output VectorVectorVectorVectorvector is the DiagonalDiagonalDiagonalDiagonaldiagonal-th super-diagonal of the MatrixMatrixMatrixMatrixmatrix.

Example:


           /   3.0   1.0  -2.0   1.0  \
  Matrix = |  -5.0   7.0   2.0   6.0  |      Diagonal = 2
           \  -9.0  -4.0   1.0  -1.0  /

                / -2.0  \
  ->   Vector = \  6.0  /

If DiagonalDiagonalDiagonalDiagonaldiagonal is negative, the DiagonalDiagonalDiagonalDiagonaldiagonal-th sub-diagonal of the MatrixMatrixMatrixMatrixmatrix is copied.

Example:


           /   3.0   1.0  -2.0   1.0  \
  Matrix = |  -5.0   7.0   2.0   6.0  |    Diagonal = - 1
           \  -9.0  -4.0   1.0  -1.0  /

                / -5.0  \
  ->   Vector = \ -4.0  /

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

MatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control) matrix → (integer)

Matrix handle of the input matrix.

DiagonalDiagonalDiagonalDiagonaldiagonal (input_control) integer → (integer)

Number of the desired diagonal.

Default value: 0

Suggested values: -20, -10, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20

VectorIDVectorIDVectorIDVectorIDvectorID (output_control) matrix → (integer)

Matrix handle containing the diagonal elements.

Result

If the parameters are valid, the operator get_diagonal_matrixget_diagonal_matrixget_diagonal_matrixGetDiagonalMatrixGetDiagonalMatrix returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.