pow_element_matrix_modT_pow_element_matrix_modPowElementMatrixModPowElementMatrixModpow_element_matrix_mod (Operator)

Name

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

Signature

pow_element_matrix_mod( : : MatrixID, MatrixExpID : )

Description

The operator pow_element_matrix_modpow_element_matrix_modPowElementMatrixModPowElementMatrixModPowElementMatrixModpow_element_matrix_mod computes the power of all elements of the input MatrixMatrixMatrixMatrixmatrixmatrix with the elements of the input matrix MatrixExpMatrixExpMatrixExpMatrixExpmatrixExpmatrix_exp. The input matrices MatrixMatrixMatrixMatrixmatrixmatrix and MatrixExpMatrixExpMatrixExpMatrixExpmatrixExpmatrix_exp are defined by the matrix handles MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id and MatrixExpIDMatrixExpIDMatrixExpIDMatrixExpIDmatrixExpIDmatrix_exp_id. Both matrices must have identical dimensions. The input MatrixMatrixMatrixMatrixmatrixmatrix is overwritten with the result. Access to the elements of the matrix is possible e.g. with the operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix. The formula for the calculation of the result is:

Example:

Execution Information

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

This operator modifies the state of the following input parameter:

MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control, state is modified) matrix → (handle)

Matrix handle of the input matrix of the base.

MatrixExpIDMatrixExpIDMatrixExpIDMatrixExpIDmatrixExpIDmatrix_exp_id (input_control) matrix → (handle)

Matrix handle of the input matrix with exponents.

Result

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