norm_matrixnorm_matrixNormMatrixnorm_matrixNormMatrixNormMatrix (Operator)

Name

norm_matrixnorm_matrixNormMatrixnorm_matrixNormMatrixNormMatrix — Norm of a matrix.

Signature

Description

The operator norm_matrixnorm_matrixNormMatrixnorm_matrixNormMatrixNormMatrix computes the norm of the elements of the MatrixMatrixMatrixMatrixMatrixmatrix defined by the matrix handle MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID. The return value is a floating point number.

The type of norming of the matrix can be selected via the parameter NormTypeNormTypeNormTypeNormTypeNormTypenormType:

'frobenius-norm'"frobenius-norm""frobenius-norm""frobenius-norm""frobenius-norm""frobenius-norm":

The Frobenius norm is computed. The formula for the calculation of the result is:

with m = number of rows and n = number of columns of the MatrixMatrixMatrixMatrixMatrixmatrix.

Example:

'infinity-norm'"infinity-norm""infinity-norm""infinity-norm""infinity-norm""infinity-norm":

The infinity norm is computed. The result is the largest value of the sum of the absolute values of the elements of the rows. The formula for the calculation is:

with m = number of rows and n = number of columns of the MatrixMatrixMatrixMatrixMatrixmatrix.

Example:

'1-norm'"1-norm""1-norm""1-norm""1-norm""1-norm":

The 1-norm is computed. The result is the largest value of the sum of the absolute values of the elements of the columns. The formula for the calculation is:

with m = number of rows and n = number of columns of the MatrixMatrixMatrixMatrixMatrixmatrix.

Example:

'2-norm'"2-norm""2-norm""2-norm""2-norm""2-norm":

The 2-norm is computed. The result is the largest singular value of the MatrixMatrixMatrixMatrixMatrixmatrix. The formula for the calculation of the result is:

   Value = max (singular values (Matrix))

  

Example:

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 norm_matrixnorm_matrixNormMatrixnorm_matrixNormMatrixNormMatrix returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

create_matrixcreate_matrixCreateMatrixcreate_matrixCreateMatrixCreateMatrix

See also

sum_matrixsum_matrixSumMatrixsum_matrixSumMatrixSumMatrix, mean_matrixmean_matrixMeanMatrixmean_matrixMeanMatrixMeanMatrix

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