HALCON Reference Manual 10.0.2

pow_element_matrixpow_element_matrixpow_element_matrixPowElementMatrixPowElementMatrix (Operator)

Name

pow_element_matrixpow_element_matrixpow_element_matrixPowElementMatrixPowElementMatrix — Compute the power functions of the elements of a matrix.

Signature

pow_element_matrix( : : MatrixID, MatrixExpID : MatrixPowID)

The operator pow_element_matrixpow_element_matrixpow_element_matrixPowElementMatrixPowElementMatrix computes the power of all elements of the input MatrixMatrixMatrixMatrixmatrix with the elements of the input matrix MatrixExpMatrixExpMatrixExpMatrixExpmatrixExp. The input matrices MatrixMatrixMatrixMatrixmatrix and MatrixExpMatrixExpMatrixExpMatrixExpmatrixExp are defined by the matrix handles MatrixIDMatrixIDMatrixIDMatrixIDmatrixID and MatrixExpIDMatrixExpIDMatrixExpIDMatrixExpIDmatrixExpID. Both matrices must have identical dimensions. A new matrix MatrixPowMatrixPowMatrixPowMatrixPowmatrixPow is generated with the result. The operator returns the matrix handle MatrixPowIDMatrixPowIDMatrixPowIDMatrixPowIDmatrixPowID of the matrix MatrixPowMatrixPowMatrixPowMatrixPowmatrixPow. Access to the elements of the matrix is possible e.g. with the operator get_full_matrixget_full_matrixget_full_matrixGetFullMatrixGetFullMatrix. The formula for the calculation of the result is:


                          MatrixExp
                                   ij
  MatrixPow   =   Matrix              .
           ij           ij

Example:


           / 3.0  1.0  2.0 \                 / 1.0  2.0  2.0 \
  Matrix = | 5.0  7.0  2.0 |      PowerExp = | 2.0  0.0  3.0 |
           \ 9.0  4.0  1.0 /                 \ 0.5  3.0  1.0 /

                    /  3.0   1.0   4.0 \
  ->    MatrixPow = | 25.0   1.0   8.0 |
                    \  3.0  64.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 of the base.

MatrixExpIDMatrixExpIDMatrixExpIDMatrixExpIDmatrixExpID (input_control) matrix → (integer)

Matrix handle of the input matrix with exponents.

MatrixPowIDMatrixPowIDMatrixPowIDMatrixPowIDmatrixPowID (output_control) matrix → (integer)

Matrix handle with the raised power of the input matrix.

Result

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