HALCON Reference Manual 10.0.2

transpose_matrixtranspose_matrixtranspose_matrixTransposeMatrixTransposeMatrix (Operator)

Name

transpose_matrixtranspose_matrixtranspose_matrixTransposeMatrixTransposeMatrix — Transpose a matrix.

Signature

transpose_matrix( : : MatrixID : MatrixTransposedID)

The operator transpose_matrixtranspose_matrixtranspose_matrixTransposeMatrixTransposeMatrix returns the transpose of the input MatrixMatrixMatrixMatrixmatrix. The input matrix is defined by the matrix handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixID. A new matrix MatrixTransposedMatrixTransposedMatrixTransposedMatrixTransposedmatrixTransposed is generated with the result and the matrix handle MatrixTransposedIDMatrixTransposedIDMatrixTransposedIDMatrixTransposedIDmatrixTransposedID of this matrix is returned. Access to the elements of the matrix is possible e.g. with the operator get_full_matrixget_full_matrixget_full_matrixGetFullMatrixGetFullMatrix.

Example:


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

                           /   3.0  -5.0  -9.0  \
  ->    MatrixTransposed = |   1.0   7.0  -4.0  |
                           \  -2.0   2.0   1.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.

MatrixTransposedIDMatrixTransposedIDMatrixTransposedIDMatrixTransposedIDmatrixTransposedID (output_control) matrix → (integer)

Matrix handle with the transpose of the input matrix.

Result

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

Possible Predecessors

create_matrixcreate_matrixcreate_matrixCreateMatrixCreateMatrix

Possible Successors

get_full_matrixget_full_matrixget_full_matrixGetFullMatrixGetFullMatrix, get_value_matrixget_value_matrixget_value_matrixGetValueMatrixGetValueMatrix

Alternatives

transpose_matrix_modtranspose_matrix_modtranspose_matrix_modTransposeMatrixModTransposeMatrixMod

References

David Poole: “Linear Algebra: A Modern Introduction”; Thomson; Belmont; 2006.
Gene H. Golub, Charles F. van Loan: “Matrix Computations”; The Johns Hopkins University Press; Baltimore and London; 1996.

Module

Foundation

Table of Contents / Matrix / Arithmetic

Operators