XLPack 7.0
XLPack Numerical Library (C API) Reference Manual
Loading...
Searching...
No Matches

◆ zlantr()

double zlantr ( char  norm,
char  uplo,
char  diag,
int  m,
int  n,
int  lda,
doublecomplex  a[],
double  work[] 
)

One norm, Frobenius norm, infinity norm, or element of largest absolute value of a complex trapezoidal or triangular matrix

Purpose
This routine returns the value of the one norm, the Frobenius norm, the infinity norm, or the element of largest absolute value of a complex trapezoidal or triangular matrix A.
Returns
max(abs(Aij)) when norm = 'M',
norm1(A) when norm = '1' or 'O',
normI(A) when norm = 'I', or
normF(A) when norm = 'F' or 'E'

where norm1 denotes the one norm of a matrix (maximum column sum), normI denotes the infinity norm of a matrix (maximum row sum) and normF denotes the Frobenius norm of a matrix (square root of sum of squares).
Note that max(abs(Aij)) is not a consistent matrix norm.
Parameters
[in]normSpecifies the value to be returned by zlantr as described above.
[in]uploSpecifies whether the matrix A is upper or lower trapezoidal.
= 'U': Upper trapezoidal.
= 'L': Lower trapezoidal.
Note that A is triangular instead of trapezoidal if M = N.
[in]diagSpecifies whether or not the matrix A has unit diagonal.
= 'N': Non-unit diagonal.
= 'U': Unit diagonal.
Note that A is triangular instead of trapezoidal if M = N.
[in]mThe number of rows of the matrix A. (m >= 0, and if uplo = 'U', m <= n)
When m = 0, returns zero.
[in]nThe number of columns of the matrix A. (n >= 0, and if uplo = 'L', n <= m)
When n = 0, returns zero.
[in]ldaLeading dimension of the two dimensional array a[][]. (lda >= max(1, m))
[in]a[][]Array a[la][lda] (la >= n)
The trapezoidal matrix A (A is triangular if m = n). If uplo = 'U', the leading m by n upper trapezoidal part of the array A contains the upper trapezoidal matrix, and the strictly lower triangular part of A is not referenced. If UPLO = 'L', the leading m by n lower trapezoidal part of the array A contains the lower trapezoidal matrix, and the strictly upper triangular part of A is not referenced. Note that when diag = 'U', the diagonal elements of A are not referenced and are assumed to be one.
[out]work[]Array work[lwork] (lwork >= max(1, m) when norm = 'I', otherwise work[] is not referenced)
Work array.
Reference
LAPACK