pow_element_matrix_modpow_element_matrix_modpow_element_matrix_modPowElementMatrixModPowElementMatrixMod (Operator)

Name

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

Signature

Description

The operator pow_element_matrix_modpow_element_matrix_modpow_element_matrix_modPowElementMatrixModPowElementMatrixMod 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. The input MatrixMatrixMatrixMatrixmatrix is overwritten with the result. 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
  Matrix   =   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 \
  ->    Matrix = | 25.0   1.0   8.0 |
                 \  3.0  64.0   1.0 /

Attention

pow_element_matrix_modpow_element_matrix_modpow_element_matrix_modPowElementMatrixModPowElementMatrixMod modifies the content of an already existing matrix.

Parallelization

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

Parameters

Result

If the parameters are valid, the operator pow_element_matrix_modpow_element_matrix_modpow_element_matrix_modPowElementMatrixModPowElementMatrixMod 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

pow_element_matrixpow_element_matrixpow_element_matrixPowElementMatrixPowElementMatrix, pow_scalar_element_matrixpow_scalar_element_matrixpow_scalar_element_matrixPowScalarElementMatrixPowScalarElementMatrix, pow_scalar_element_matrix_modpow_scalar_element_matrix_modpow_scalar_element_matrix_modPowScalarElementMatrixModPowScalarElementMatrixMod

See also

sqrt_matrixsqrt_matrixsqrt_matrixSqrtMatrixSqrtMatrix, sqrt_matrix_modsqrt_matrix_modsqrt_matrix_modSqrtMatrixModSqrtMatrixMod

Module

Foundation