HALCON Reference Manual 10.0.2
Table of Contents / Matrix / Arithmetic ClassesClassesClasses | | | Operators

pow_scalar_element_matrix_modpow_scalar_element_matrix_modpow_scalar_element_matrix_modPowScalarElementMatrixModPowScalarElementMatrixMod (Operator)

Name

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

Signature

pow_scalar_element_matrix_mod( : : MatrixID, Power : )

Herror pow_scalar_element_matrix_mod(const Hlong MatrixID, double Power)

Herror T_pow_scalar_element_matrix_mod(const Htuple MatrixID, const Htuple Power)

Herror pow_scalar_element_matrix_mod(const HTuple& MatrixID, const HTuple& Power)

void HMatrix::PowScalarElementMatrixMod(const HTuple& Power) const

void HOperatorSetX.PowScalarElementMatrixMod(
[in] VARIANT MatrixID, [in] VARIANT Power)

void HMatrixX.PowScalarElementMatrixMod([in] VARIANT Power)

static void HOperatorSet.PowScalarElementMatrixMod(HTuple matrixID, HTuple power)

void HMatrix.PowScalarElementMatrixMod(HTuple power)

void HMatrix.PowScalarElementMatrixMod(double power)

Description

The operator pow_scalar_element_matrix_modpow_scalar_element_matrix_modpow_scalar_element_matrix_modPowScalarElementMatrixModPowScalarElementMatrixMod computes the power of all elements of the input MatrixMatrixMatrixMatrixmatrix by a constant value. The input MatrixMatrixMatrixMatrixmatrix is given by the matrix handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixID. The power value is given by the parameter PowerPowerPowerPowerpower. The input matrix 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: 


                          MatrixPower
  Matrix   =   Matrix                .
        ij           ij

Example: 


           / 3.0  1.0  2.0 \
  Matrix = | 5.0  7.0  2.0 |      Power = [ 2.0 ]
           \ 9.0  4.0  1.0 /

                 /  9.0   1.0   4.0 \
  ->    Matrix = | 25.0  49.0   4.0 |
                 \ 81.0  16.0   1.0 /

Attention

pow_scalar_element_matrix_modpow_scalar_element_matrix_modpow_scalar_element_matrix_modPowScalarElementMatrixModPowScalarElementMatrixMod modifies the content of an already existing matrix.

Parallelization

Parameters

MatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control)  matrix → HMatrix, HTupleHMatrix, HTupleHMatrixX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Matrix handle of the input matrix.

PowerPowerPowerPowerpower (input_control)  number → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

The power.

Default value: 2.0

Suggested values: 0.1, 0.2, 0.3, 0.5, 0.7, 1.0, 1.5, 2.0, 3.0, 5.0, 10.0

Result

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

See also

sqrt_matrixsqrt_matrixsqrt_matrixSqrtMatrixSqrtMatrix, sqrt_matrix_modsqrt_matrix_modsqrt_matrix_modSqrtMatrixModSqrtMatrixMod

Module

Foundation

Table of Contents / Matrix / Arithmetic ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH