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, typename Ta>
Ta lange(char *norm, integer *m, integer *n, T *a, integer *lda, Ta *work)#

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, typename Ta>
Ta langb(char *norm, integer *n, integer *kl, integer *ku, T *ab, integer *ldab, Ta *work)#

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, typename Ta>
Ta langt(char *norm, integer *n, T *dl, T *d, T *du)#

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, typename Ta>
Ta lanhs(char *norm, integer *n, T *a, integer *lda, Ta *work)#

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.

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, typename Ta>
Ta lansy(char *norm, char *uplo, integer *n, T *a, integer *lda, Ta *work)#

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.

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.

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.

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, typename Ta>
Ta lansp(char *norm, char *uplo, integer *n, T *ap, Ta *work)#

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.

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.

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.

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.

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, typename Ta>
Ta lantr(char *norm, char *uplo, char *diag, integer *m, integer *n, T *a, integer *lda, Ta *work)#

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, typename Ta>
Ta lantp(char *norm, char *uplo, char *diag, integer *n, T *ap, Ta *work)#

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, typename Ta>
Ta lantb(char *norm, char *uplo, char *diag, integer *n, integer *k, T *ab, integer *ldab, Ta *work)#