Matrix Norm APIs#
LANGE#
- group lange
Functions
-
template<typename T>
T lange(char *norm, integer *m, integer *n, T *a, integer *lda, T *work)# LANGE returns the value of the 1-norm, Frobenius norm, infinity-norm,
or the largest absolute value of any element of a general rectangular matrix.
Purpose:
LANGE returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a real matrix A. \return LANGE LANGE = ( fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( ( norm1(A), NORM = '1', 'O' or 'o' ( ( normI(A), NORM = 'I' or 'i' ( ( normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANGE as described above.
M – [in]
M is INTEGER
The number of rows of the matrix A. M >= 0. When M = 0, SLANGE is set to zero.
N – [in]
N is INTEGER
The number of columns of the matrix A. N >= 0. When N = 0, SLANGE is set to zero.
A – [in]
A is REAL array, dimension (LDA,N)
The m by n matrix A.
LDA – [in]
LDA is INTEGER
The leading dimension of the array A. LDA >= fla_max(M,1).
WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= M when NORM = ‘I’; otherwise, WORK is not referenced.
- Returns:
Returns value of the norm.
-
template<typename T>
LANGB#
- group langb
Functions
-
template<typename T>
T langb(char *norm, integer *n, integer *kl, integer *ku, T *ab, integer *ldab, T *work)# LANGB returns the value of the 1-norm, Frobenius norm, infinity-norm,
or the largest absolute value of any element of general band matrix.
Purpose:
LANGB returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of an n by n band matrix A, with kl sub-diagonals and ku super-diagonals. SLANGB = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANGB as described above.
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, SLANGB is set to zero.
KL – [in]
KL is INTEGER
The number of sub-diagonals of the matrix A. KL >= 0.
KU – [in]
KU is INTEGER
The number of super-diagonals of the matrix A. KU >= 0.
AB – [in]
AB is REAL array, dimension (LDAB,N)
The band matrix A, stored in rows 1 to KL+KU+1. The j-th column of A is stored in the j-th column of the array AB as follows:
AB(ku+1+i-j,j) = A(i,j) for fla_max(1,j-ku)<=i<=min(n,j+kl).LDAB – [in]
LDAB is INTEGER
The leading dimension of the array AB. LDAB >= KL+KU+1.
WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’; otherwise, WORK is not referenced.
- Returns:
Returns the value of the norm.
-
template<typename T>
LANGT#
- group langt
Functions
-
template<typename T>
T langt(char *norm, integer *n, T *dl, T *d, T *du)# LANGT returns the value of the 1-norm, Frobenius norm, infinity-norm,
or the largest absolute value of any element of a general tridiagonal matrix.
Purpose:
LANGT returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a real tridiagonal matrix A. SLANGT = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANGT as described above.
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, SLANGT is set to zero.
DL – [in]
DL is REAL array, dimension (N-1)
The (n-1) sub-diagonal elements of A.
D – [in]
D is REAL array, dimension (N)
The diagonal elements of A.
DU – [in]
DU is REAL array, dimension (N-1)
The (n-1) super-diagonal elements of A.
- Returns:
Returns the value of norm.
-
template<typename T>
LANHS#
- group lanhs
Functions
-
template<typename T>
T lanhs(char *norm, integer *n, T *a, integer *lda, T *work)# LANHS returns the value of the 1-norm, Frobenius norm, infinity-norm, or the
largest absolute value of any element of an upper Hessenberg matrix.
Purpose:
LANHS returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a Hessenberg matrix A. SLANHS = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANHS as described above.
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, SLANHS is set to zero.
A – [in]
A is REAL array, dimension (LDA,N)
The n by n upper Hessenberg matrix A; the part of A below the first sub-diagonal is not referenced.
LDA – [in]
LDA is INTEGER
The leading dimension of the array A. LDA >= fla_max(N,1).
WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’; otherwise, WORK is not referenced.
- Returns:
Returns the value of norm.
-
template<typename T>
LANHE#
- group lanhe
Functions
-
template<typename T, typename Ta>
Ta lanhe(char *norm, char *uplo, integer *n, T *a, integer *lda, Ta *work)# LANHE returns the value of the 1-norm, or the Frobenius norm, or the infinity norm,
or the element of largest absolute value of a complex Hermitian matrix.
Purpose:
LANHE returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a complex hermitian matrix A. * \b Returns LANHE CLANHE = ( fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( ( norm1(A), NORM = '1', 'O' or 'o' ( ( normI(A), NORM = 'I' or 'i' ( ( normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in CLANHE as described above.
UPLO – [in]
UPLO is CHARACTER*1
Specifies whether the upper or lower triangular part of the hermitian matrix A is to be referenced.
= ‘U’: Upper triangular part of A is referenced
= ‘L’: Lower triangular part of A is referenced
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, CLANHE is set to zero.
A – [in]
A is COMPLEX array, dimension (LDA,N)
The hermitian matrix A. If UPLO = ‘U’, the leading n by n upper triangular part of A contains the upper triangular part of the matrix A, and the strictly lower triangular part of A is not referenced. If UPLO = ‘L’, the leading n by n lower triangular part of A contains the lower triangular part of the matrix A, and the strictly upper triangular part of A is not referenced. Note that the imaginary parts of the diagonal elements need not be set and are assumed to be zero.
LDA – [in]
LDA is INTEGER
The leading dimension of the array A. LDA >= fla_max(N,1).
WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’ or ‘1’ or ‘O’; otherwise, WORK is not referenced.
- Returns:
Returns value of the norm.
-
template<typename T, typename Ta>
LANSY#
- group lansy
Functions
-
template<typename T>
T lansy(char *norm, char *uplo, integer *n, T *a, integer *lda, T *work)# LANSY returns the value of the 1-norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a real symmetric matrix.
Purpose:
LANSY returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a real symmetric matrix A. \return LANSY LANSY = ( fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( ( norm1(A), NORM = '1', 'O' or 'o' ( ( normI(A), NORM = 'I' or 'i' ( ( normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANSY as described above.
UPLO – [in]
UPLO is CHARACTER*1
Specifies whether the upper or lower triangular part of the symmetric matrix A is to be referenced.
= ‘U’: Upper triangular part of A is referenced
= ‘L’: Lower triangular part of A is referenced
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, SLANSY is set to zero.
A – [in]
A is REAL array, dimension (LDA,N)
The symmetric matrix A. If UPLO = ‘U’, the leading n by n upper triangular part of A contains the upper triangular part of the matrix A, and the strictly lower triangular part of A is not referenced. If UPLO = ‘L’, the leading n by n lower triangular part of A contains the lower triangular part of the matrix A, and the strictly upper triangular part of A is not referenced.
LDA – [in]
LDA is INTEGER
The leading dimension of the array A. LDA >= fla_max(N,1).
WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’ or ‘1’ or ‘O’; otherwise, WORK is not referenced.
- Returns:
Returns value of the norm.
-
template<typename T>
LANHF#
- group lanhf
Functions
-
template<typename T, typename Ta>
Ta lanhf(char *norm, char *transr, char *uplo, integer *n, T *a, Ta *work)# LANHF returns the value of the 1-norm, or the Frobenius norm, or the infinity norm,
or the element of largest absolute value of a Hermitian matrix in RFP format.
Purpose:
LANHF returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a complex Hermitian matrix A in RFP format. CLANHF = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER
Specifies the value to be returned in CLANHF as described above.
TRANSR – [in]
TRANSR is CHARACTER
Specifies whether the RFP format of A is normal or conjugate-transposed format.
= ‘N’: RFP format is Normal
= ‘C’: RFP format is Conjugate-transposed
UPLO – [in]
UPLO is CHARACTER
On entry, UPLO specifies whether the RFP matrix A came from an upper or lower triangular matrix as follows:
UPLO = ‘U’ or ‘u’ RFP A came from an upper triangular matrix
UPLO = ‘L’ or ‘l’ RFP A came from a lower triangular matrix
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, CLANHF is set to zero.
A – [in]
A is COMPLEX array, dimension (N*(N+1)/2);
On entry, the matrix A in RFP Format. RFP Format is described by TRANSR, UPLO and N as follows: If TRANSR=’N’ then RFP A is (0:N,0:K-1) when N is even; K=N/2. RFP A is (0:N-1,0:K) when N is odd; K=N/2. If TRANSR = ‘C’ then RFP is the Conjugate-transpose of RFP A as defined when TRANSR = ‘N’. The contents of RFP A are defined by UPLO as follows: If UPLO = ‘U’ the RFP A contains the (N*(N+1)/2) elements of upper packed A either in normal or conjugate-transpose Format. If UPLO = ‘L’ the RFP A contains the (N*(N+1) /2) elements of lower packed A either in normal or conjugate-transpose Format. The LDA of RFP A is (N+1)/2 when TRANSR = ‘C’. When TRANSR is ‘N’ the LDA is N+1 when N is even and is N when is odd. See the Note below for more details.
Unchanged on exit.WORK – [out]
WORK is REAL array, dimension (LWORK),
where LWORK >= N when NORM = ‘I’ or ‘1’ or ‘O’; otherwise, WORK is not referenced.
- Returns:
Returns value of norm.
-
template<typename T, typename Ta>
LANSF#
- group lansf
Functions
-
template<typename T>
T lansf(char *norm, char *transr, char *uplo, integer *n, T *a, T *work)# LANSF returns the value of the one norm, or the Frobenius norm, or the infinity norm,
or the element of largest absolute value of a real symmetric matrix A in RFP format.
Purpose:
LANSF returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a real symmetric matrix A in RFP format. \ return SLANSF SLANSF = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANSF as described above.
TRANSR – [in]
TRANSR is CHARACTER*1
Specifies whether the RFP format of A is normal or transposed format.
= ‘N’: RFP format is Normal;
= ‘T’: RFP format is Transpose.
UPLO – [in]
UPLO is CHARACTER*1
On entry, UPLO specifies whether the RFP matrix A came from an upper or lower triangular matrix as follows:
= ‘U’: RFP A came from an upper triangular matrix;
= ‘L’: RFP A came from a lower triangular matrix.
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, SLANSF is set to zero.
A – [in]
A is REAL array, dimension (N*(N+1)/2);
On entry, the upper (if UPLO = ‘U’) or lower (if UPLO = ‘L’) part of the symmetric matrix A stored in RFP format. See the “Notes” below for more details.
Unchanged on exit.WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’ or ‘1’ or ‘O’; otherwise, WORK is not referenced.
- Returns:
Returns the value of norm.
-
template<typename T>
LANHP#
- group lanhp
Functions
-
template<typename T, typename Ta>
Ta lanhp(char *norm, char *uplo, integer *n, T *ap, Ta *work)# LANHP returns the value of the 1-norm, or the Frobenius norm, or the infinity norm,
or the element of largest absolute value of a complex Hermitian matrix supplied in packed form.
Purpose:
LANHP returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a complex hermitian matrix A, supplied in packed form. CLANHP = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in CLANHP as described above.
UPLO – [in]
UPLO is CHARACTER*1
Specifies whether the upper or lower triangular part of the hermitian matrix A is supplied.
= ‘U’: Upper triangular part of A is supplied
= ‘L’: Lower triangular part of A is supplied
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, CLANHP is set to zero.
AP – [in]
AP is COMPLEX array, dimension (N*(N+1)/2)
The upper or lower triangle of the hermitian matrix A, packed columnwise in a linear array. The j-th column of A is stored in the array AP as follows:
if UPLO = ‘U’, AP(i + (j-1)*j/2) = A(i,j) for 1<=i<=j;
if UPLO = ‘L’, AP(i + (j-1)*(2n-j)/2) = A(i,j) for j<=i<=n.
Note that the imaginary parts of the diagonal elements need not be set and are assumed to be zero.WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’ or ‘1’ or ‘O’; otherwise, WORK is not referenced.
- Returns:
Returns the value of norm.
-
template<typename T, typename Ta>
LANSP#
- group lansp
Functions
-
template<typename T>
T lansp(char *norm, char *uplo, integer *n, T *ap, T *work)# LANSP returns the value of the 1-norm, or the Frobenius norm, or the infinity norm,
or the element of largest absolute value of a symmetric matrix supplied in packed form.
Purpose:
LANSP returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a real symmetric matrix A, supplied in packed form. \ return SLANSP SLANSP = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANSP as described above.
UPLO – [in]
UPLO is CHARACTER*1
Specifies whether the upper or lower triangular part of the symmetric matrix A is supplied.
= ‘U’: Upper triangular part of A is supplied
= ‘L’: Lower triangular part of A is supplied
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, SLANSP is set to zero.
AP – [in]
AP is REAL array, dimension (N*(N+1)/2)
The upper or lower triangle of the symmetric matrix A, packed columnwise in a linear array. The j-th column of A is stored in the array AP as follows:
if UPLO = ‘U’, AP(i + (j-1)*j/2) = A(i,j) for 1<=i<=j;
if UPLO = ‘L’, AP(i + (j-1)*(2n-j)/2) = A(i,j) for j<=i<=n.
WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’ or ‘1’ or ‘O’; otherwise, WORK is not referenced.
- Returns:
Returns the value of norm.
-
template<typename T>
LANHB#
- group lanhb
Functions
-
template<typename T, typename Ta>
Ta lanhb(char *norm, char *uplo, integer *n, integer *k, T *ab, integer *ldab, Ta *work)# LANHB returns the value of the 1-norm, or the Frobenius norm, or the infinity norm,
or the element of largest absolute value of a Hermitian band matrix.
Purpose:
LANHB returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of an n by n hermitian band matrix A, with k super-diagonals. LANHB = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in CLANHB as described above.
UPLO – [in]
UPLO is CHARACTER*1
Specifies whether the upper or lower triangular part of the band matrix A is supplied.
= ‘U’: Upper triangular
= ‘L’: Lower triangular
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, CLANHB is set to zero.
K – [in]
K is INTEGER
The number of super-diagonals or sub-diagonals of the band matrix A. K >= 0.
AB – [in]
AB is COMPLEX array, dimension (LDAB,N)
The upper or lower triangle of the hermitian band matrix A, stored in the first K+1 rows of AB. The j-th column of A is stored in the j-th column of the array AB as follows:
if UPLO = ‘U’, AB(k+1+i-j,j) = A(i,j) for fla_max(1,j-k)<=i<=j;
if UPLO = ‘L’, AB(1+i-j,j) = A(i,j) for j<=i<=min(n,j+k).
Note that the imaginary parts of the diagonal elements need not be set and are assumed to be zero.LDAB – [in]
LDAB is INTEGER
The leading dimension of the array AB. LDAB >= K+1.
WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’ or ‘1’ or ‘O’; otherwise, WORK is not referenced.
- Returns:
Returns the value of norm.
-
template<typename T, typename Ta>
LANSB#
- group lansb
Functions
-
template<typename T, typename Ta>
Ta lansb(char *norm, char *uplo, integer *n, integer *k, T *ab, integer *ldab, Ta *work)# LANSB returns the value of the 1-norm, or the Frobenius norm, or the infinity norm,
or the element of largest absolute value of a symmetric band matrix.
Purpose:
LANSB returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of an n by n symmetric band matrix A, with k super-diagonals. \ return SLANSB SLANSB = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANSB as described above.
UPLO – [in]
UPLO is CHARACTER*1
Specifies whether the upper or lower triangular part of the band matrix A is supplied.
= ‘U’: Upper triangular part is supplied
= ‘L’: Lower triangular part is supplied
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, SLANSB is set to zero.
K – [in]
K is INTEGER
The number of super-diagonals or sub-diagonals of the band matrix A. K >= 0.
AB – [in]
AB is REAL array, dimension (LDAB,N)
The upper or lower triangle of the symmetric band matrix A, stored in the first K+1 rows of AB. The j-th column of A is stored in the j-th column of the array AB as follows:
if UPLO = ‘U’, AB(k+1+i-j,j) = A(i,j) for fla_max(1,j-k)<=i<=j;
if UPLO = ‘L’, AB(1+i-j,j) = A(i,j) for j<=i<=min(n,j+k).
LDAB – [in]
LDAB is INTEGER
The leading dimension of the array AB. LDAB >= K+1.
WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’ or ‘1’ or ‘O’; otherwise, WORK is not referenced.
- Returns:
Returns value of norm.
-
template<typename T, typename Ta>
LANHT#
- group lanht
Functions
-
template<typename T, typename Ta>
Ta lanht(char *norm, integer *n, Ta *d, T *e)# LANHT returns the value of the 1-norm, or the Frobenius norm, or the infinity norm,
or the element of largest absolute value of a complex Hermitian tridiagonal matrix.
Purpose:
LANHT returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a complex Hermitian tridiagonal matrix A. \ return CLANHT CLANHT = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in CLANHT as described above.
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, CLANHT is set to zero.
D – [in]
D is REAL array, dimension (N)
The diagonal elements of A.
E – [in]
E is COMPLEX array, dimension (N-1)
The (n-1) sub-diagonal or super-diagonal elements of A.
- Returns:
Returns the value of norm.
-
template<typename T, typename Ta>
LANST#
- group lanst
Functions
-
template<typename T>
T lanst(char *norm, integer *n, T *d, T *e)# LANST returns the value of the 1-norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a real symmetric tridiagonal matrix.
Purpose:
LANST returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a real symmetric tridiagonal matrix A. \ return SLANST SLANST = (fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( (norm1(A), NORM = '1', 'O' or 'o' ( (normI(A), NORM = 'I' or 'i' ( (normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANST as described above.
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, SLANST is set to zero.
D – [in]
D is REAL array, dimension (N)
The diagonal elements of A.
E – [in]
E is REAL array, dimension (N-1)
The (n-1) sub-diagonal or super-diagonal elements of A.
- Returns:
Returns the value of norm.
-
template<typename T>
LANTR#
- group lantr
Functions
-
template<typename T>
T lantr(char *norm, char *uplo, char *diag, integer *m, integer *n, T *a, integer *lda, T *work)# LANTR returns the value of the 1-norm, or the Frobenius norm, or the infinity norm,
or the element of largest absolute value of a trapezoidal or triangular matrix.
Purpose:
LANTR returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a trapezoidal or triangular matrix A. \return LANTR LANTR = ( fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( ( norm1(A), NORM = '1', 'O' or 'o' ( ( normI(A), NORM = 'I' or 'i' ( ( normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANTR as described above.
UPLO – [in]
UPLO is CHARACTER*1
Specifies 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.DIAG – [in]
DIAG is CHARACTER*1
Specifies whether or not the matrix A has unit diagonal.
= ‘N’: Non-unit diagonal
= ‘U’: Unit diagonal
M – [in]
M is INTEGER
The number of rows of the matrix A. M >= 0, and if UPLO = ‘U’, M <= N. When M = 0, SLANTR is set to zero.
N – [in]
N is INTEGER
The number of columns of the matrix A. N >= 0, and if UPLO = ‘L’, N <= M. When N = 0, SLANTR is set to zero.
A – [in]
A is REAL array, dimension (LDA,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.
LDA – [in]
LDA is INTEGER
The leading dimension of the array A. LDA >= fla_max(M,1).
WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= M when NORM = ‘I’; otherwise, WORK is not referenced.
- Returns:
Returns value of the norm.
-
template<typename T>
LANTP#
- group lantp
Functions
-
template<typename T>
T lantp(char *norm, char *uplo, char *diag, integer *n, T *ap, T *work)# LANTP returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a triangular matrix A, supplied in packed form.
Purpose:
SLANTP = ( fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( ( norm1(A), NORM = '1', 'O' or 'o' ( ( normI(A), NORM = 'I' or 'i' ( ( normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANTP as described above.
UPLO – [in]
UPLO is CHARACTER*1
Specifies whether the matrix A is upper or lower triangular.
= ‘U’: Upper triangular
= ‘L’: Lower triangular
DIAG – [in]
DIAG is CHARACTER*1
Specifies whether or not the matrix A is unit triangular.
= ‘N’: Non-unit triangular
= ‘U’: Unit triangular
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, SLANTP is set to zero.
AP – [in]
AP is REAL array, dimension (N*(N+1)/2)
The upper or lower triangular matrix A, packed columnwise in a linear array. The j-th column of A is stored in the array AP as follows:
if UPLO = ‘U’, AP(i + (j-1)*j/2) = A(i,j) for 1<=i<=j;
if UPLO = ‘L’, AP(i + (j-1)*(2n-j)/2) = A(i,j) for j<=i<=n.
Note that when DIAG = ‘U’, the elements of the array AP corresponding to the diagonal elements of the matrix A are not referenced, but are assumed to be one.WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’; otherwise, WORK is not referenced.
- Returns:
Returns value of the norm.
-
template<typename T>
LANTB#
- group lantb
Functions
-
template<typename T>
T lantb(char *norm, char *uplo, char *diag, integer *n, integer *k, T *ab, integer *ldab, T *work)# LANTB returns the value of the one norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of an n by n triangular band matrix A, with ( k + 1 ) diagonals.
Purpose:
SLANTB = ( fla_max(abs(A(i,j))), NORM = 'M' or 'm' ( ( norm1(A), NORM = '1', 'O' or 'o' ( ( normI(A), NORM = 'I' or 'i' ( ( normF(A), NORM = 'F', 'f', 'E' 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 fla_max(abs(A(i,j))) is not a consistent matrix norm.
- Parameters:
NORM – [in]
NORM is CHARACTER*1
Specifies the value to be returned in SLANTB as described above.
UPLO – [in]
UPLO is CHARACTER*1
Specifies whether the matrix A is upper or lower triangular.
= ‘U’: Upper triangular
= ‘L’: Lower triangular
DIAG – [in]
DIAG is CHARACTER*1
Specifies whether or not the matrix A is unit triangular.
= ‘N’: Non-unit triangular
= ‘U’: Unit triangular
N – [in]
N is INTEGER
The order of the matrix A. N >= 0. When N = 0, SLANTB is set to zero.
K – [in]
K is INTEGER
The number of super-diagonals of the matrix A if UPLO = ‘U’, or the number of sub-diagonals of the matrix A if UPLO = ‘L’. K >= 0.
AB – [in]
AB is REAL array, dimension (LDAB,N)
The upper or lower triangular band matrix A, stored in the first k+1 rows of AB. The j-th column of A is stored in the j-th column of the array AB as follows:
if UPLO = ‘U’, AB(k+1+i-j,j) = A(i,j) for fla_max(1,j-k)<=i<=j;
if UPLO = ‘L’, AB(1+i-j,j) = A(i,j) for j<=i<=min(n,j+k).
Note that when DIAG = ‘U’, the elements of the array AB corresponding to the diagonal elements of the matrix A are not referenced, but are assumed to be one.LDAB – [in]
LDAB is INTEGER
The leading dimension of the array AB. LDAB >= K+1.
WORK – [out]
WORK is REAL array, dimension (MAX(1,LWORK)),
where LWORK >= N when NORM = ‘I’; otherwise, WORK is not referenced.
- Returns:
Returns value of the norm.
-
template<typename T>