la_gercond(3)

🌸 NAME 🌸

okay bestie, this is la_gercond(3) from the Library Functions Manual, and this is part 1. πŸ’–

la_gercond β€” la_gercond: Skeel condition number estimate. That’s the whole point of this icon. ✨


✨ SYNOPSIS ✨

Functions

Here’s the whole cast, bestie β€” signatures first, then the one-line vibe for each 🫢

real function cla_gercond_c (trans, n, a, lda, af, ldaf, ipiv, c,
           capply, info, work, rwork)
real function cla_gercond_x (trans, n, a, lda, af, ldaf, ipiv, x, info,
           work, rwork)
double precision function dla_gercond (trans, n, a, lda, af, ldaf, ipiv,
           cmode, c, info, work, iwork)
real function sla_gercond (trans, n, a, lda, af, ldaf, ipiv, cmode, c,
           info, work, iwork)
double precision function zla_gercond_c (trans, n, a, lda, af, ldaf,
           ipiv, c, capply, info, work, rwork)
double precision function zla_gercond_x (trans, n, a, lda, af, ldaf,
           ipiv, x, info, work, rwork)
  • cla_gercond_c β€” CLA_GERCOND_C computes the infinity norm condition number of op(A)*inv(diag(c)) for general matrices. πŸ’…
  • cla_gercond_x β€” CLA_GERCOND_X computes the infinity norm condition number of op(A)*diag(x) for general matrices. 🌸
  • dla_gercond β€” DLA_GERCOND estimates the Skeel condition number for a general matrix. πŸ”₯
  • sla_gercond β€” SLA_GERCOND estimates the Skeel condition number for a general matrix. ⭐
  • zla_gercond_c β€” ZLA_GERCOND_C computes the infinity norm condition number of op(A)*inv(diag(c)) for general matrices. πŸ¦‹
  • zla_gercond_x β€” ZLA_GERCOND_X computes the infinity norm condition number of op(A)*diag(x) for general matrices. πŸŽ€

πŸ’– Detailed Description πŸ’–

okay so this page is basically the la_gercond family reunion: real and double precision, complex and real, with the _c and _x variants showing up too. The detailed docs below are where the actual function-by-function lore lives. no cap. πŸ‘‘

🧚 Function Documentation 🧚

πŸ’… cla_gercond_c

   real function cla_gercond_c (character trans, integer n, complex, dimension(
       lda, * ) a, integer lda, complex, dimension( ldaf, * ) af, integer ldaf,
       integer, dimension( * ) ipiv, real, dimension( * ) c, logical capply,
       integer info, complex, dimension( * ) work, real, dimension( * ) rwork)

CLA_GERCOND_C computes the infinity norm condition number of op(A)*inv(diag(c)) for general matrices. literally that. ✨

Purpose

CLA_GERCOND_C computes the infinity norm condition number of op(A) * inv(diag(C)) where C is a REAL vector. πŸ’–

Parameters

  • TRANS β€” TRANS is CHARACTER*1. Specifies the form of the system of equations:
    • 'N': A * X = B (No transpose)
    • 'T': A**T * X = B (Transpose)
    • 'C': A**H * X = B (Conjugate Transpose = Transpose)
  • N β€” N is INTEGER. The number of linear equations, i.e., the order of the matrix A. N >= 0. 🌸
  • A β€” A is COMPLEX array, dimension (LDA,N). On entry, the N-by-N matrix A. πŸ’…
  • LDA β€” LDA is INTEGER. The leading dimension of the array A. LDA >= max(1,N).
  • AF β€” AF is COMPLEX array, dimension (LDAF,N). The factors L and U from the factorization A = P*L*U as computed by CGETRF. πŸ”₯
  • LDAF β€” LDAF is INTEGER. The leading dimension of the array AF. LDAF >= max(1,N).
  • IPIV β€” IPIV is INTEGER array, dimension (N). The pivot indices from the factorization A = P*L*U as computed by CGETRF; row i of the matrix was interchanged with row IPIV(i). 🫢
  • C β€” C is REAL array, dimension (N). The vector C in the formula op(A) * inv(diag(C)). πŸ“
  • CAPPLY β€” CAPPLY is LOGICAL. If .TRUE. then access the vector C in the formula above. ⭐
  • INFO β€” INFO is INTEGER.
    • = 0: Successful exit.
    • i > 0: The ith argument is invalid. πŸ’€
  • WORK β€” WORK is COMPLEX array, dimension (2*N). Workspace. 🧚
  • RWORK β€” RWORK is REAL array, dimension (N). Workspace. πŸ’œ

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 140 of file cla_gercond_c.f.


🌈 cla_gercond_x

   real function cla_gercond_x (character trans, integer n, complex, dimension(
       lda, * ) a, integer lda, complex, dimension( ldaf, * ) af, integer ldaf,
       integer, dimension( * ) ipiv, complex, dimension( * ) x, integer info,
       complex, dimension( * ) work, real, dimension( * ) rwork)

CLA_GERCOND_X computes the infinity norm condition number of op(A)*diag(x) for general matrices. iconic. πŸ’…

Purpose

CLA_GERCOND_X computes the infinity norm condition number of op(A) * diag(X) where X is a COMPLEX vector. ✨

Parameters

  • TRANS β€” TRANS is CHARACTER*1. Specifies the form of the system of equations:
    • 'N': A * X = B (No transpose)
    • 'T': A**T * X = B (Transpose)
    • 'C': A**H * X = B (Conjugate Transpose = Transpose)
  • N β€” N is INTEGER. The number of linear equations, i.e., the order of the matrix A. N >= 0. 🌸
  • A β€” A is COMPLEX array, dimension (LDA,N). On entry, the N-by-N matrix A. πŸ’–
  • LDA β€” LDA is INTEGER. The leading dimension of the array A. LDA >= max(1,N).
  • AF β€” AF is COMPLEX array, dimension (LDAF,N). The factors L and U from the factorization A = P*L*U as computed by CGETRF. πŸ”₯
  • LDAF β€” LDAF is INTEGER. The leading dimension of the array AF. LDAF >= max(1,N).
  • IPIV β€” IPIV is INTEGER array, dimension (N). The pivot indices from the factorization A = P*L*U as computed by CGETRF; row i of the matrix was interchanged with row IPIV(i). 🫢
  • X β€” X is COMPLEX array, dimension (N). The vector X in the formula op(A) * diag(X). πŸ“
  • INFO β€” INFO is INTEGER.
    • = 0: Successful exit.
    • i > 0: The ith argument is invalid. πŸ’€
  • WORK β€” WORK is COMPLEX array, dimension (2*N). Workspace. 🧚
  • RWORK β€” RWORK is REAL array, dimension (N). Workspace. πŸ’œ

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 133 of file cla_gercond_x.f.


πŸ‘‘ dla_gercond

   double precision function dla_gercond (character trans, integer n, double
       precision, dimension( lda, * ) a, integer lda, double precision,
       dimension( ldaf, * ) af, integer ldaf, integer, dimension( * ) ipiv,
       integer cmode, double precision, dimension( * ) c, integer info, double
       precision, dimension( * ) work, integer, dimension( * ) iwork)

DLA_GERCOND estimates the Skeel condition number for a general matrix. main character energy fr fr. πŸ’…

Purpose

DLA_GERCOND estimates the Skeel condition number of op(A) * op2(C) where op2 is determined by CMODE as follows:

CMODE =  1    op2(C) = C
CMODE =  0    op2(C) = I
CMODE = -1    op2(C) = inv(C)

The Skeel condition number cond(A) = norminf( |inv(A)||A| ) is computed by computing scaling factors R such that diag(R)*A*op2(C) is row equilibrated and computing the standard infinity-norm condition number. πŸ”₯

Parameters

  • TRANS β€” TRANS is CHARACTER*1. Specifies the form of the system of equations:
    • 'N': A * X = B (No transpose)
    • 'T': A**T * X = B (Transpose)
    • 'C': A**H * X = B (Conjugate Transpose = Transpose)
  • N β€” N is INTEGER. The number of linear equations, i.e., the order of the matrix A. N >= 0. 🌸
  • A β€” A is DOUBLE PRECISION array, dimension (LDA,N). On entry, the N-by-N matrix A. πŸ’–
  • LDA β€” LDA is INTEGER. The leading dimension of the array A. LDA >= max(1,N).
  • AF β€” AF is DOUBLE PRECISION array, dimension (LDAF,N). The factors L and U from the factorization A = P*L*U as computed by DGETRF. πŸ”₯
  • LDAF β€” LDAF is INTEGER. The leading dimension of the array AF. LDAF >= max(1,N).
  • IPIV β€” IPIV is INTEGER array, dimension (N). The pivot indices from the factorization A = P*L*U as computed by DGETRF; row i of the matrix was interchanged with row IPIV(i). 🫢
  • CMODE β€” CMODE is INTEGER. Determines op2(C) in the formula op(A) * op2(C) as follows:
    • CMODE = 1: op2(C) = C
    • CMODE = 0: op2(C) = I
    • CMODE = -1: op2(C) = inv(C) 🌈
  • C β€” C is DOUBLE PRECISION array, dimension (N). The vector C in the formula op(A) * op2(C). πŸ“
  • INFO β€” INFO is INTEGER.
    • = 0: Successful exit.
    • i > 0: The ith argument is invalid. πŸ’€
  • WORK β€” WORK is DOUBLE PRECISION array, dimension (3*N). Workspace. 🧚
  • IWORK β€” IWORK is INTEGER array, dimension (N). Workspace. πŸ’œ

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 149 of file dla_gercond.f.


⭐ sla_gercond

   real function sla_gercond (character trans, integer n, real, dimension( lda,
       * ) a, integer lda, real, dimension( ldaf, * ) af, integer ldaf,
       integer, dimension( * ) ipiv, integer cmode, real, dimension( * ) c,
       integer info, real, dimension( * ) work, integer, dimension( * ) iwork)

SLA_GERCOND estimates the Skeel condition number for a general matrix. slay. ✨

Purpose

SLA_GERCOND estimates the Skeel condition number of op(A) * op2(C) where op2 is determined by CMODE as follows:

CMODE =  1    op2(C) = C
CMODE =  0    op2(C) = I
CMODE = -1    op2(C) = inv(C)

The Skeel condition number cond(A) = norminf( |inv(A)||A| ) is computed by computing scaling factors R such that diag(R)*A*op2(C) is row equilibrated and computing the standard infinity-norm condition number. πŸ’…

Parameters

TRANS

okay so we’re still in the parameter list, and TRANS is first up πŸ’…

  • TRANS β€” is CHARACTER*1. Specifies the form of the system of equations:
    • = 'N': A * X = B (No transpose)
    • = 'T': A**T * X = B (Transpose)
    • = 'C': A**H * X = B (Conjugate Transpose = Transpose)
  • N β€” is INTEGER. The number of linear equations, i.e., the order of the matrix A. N >= 0.
  • A β€” is REAL array, dimension (LDA,N). On entry, the N-by-N matrix A.
  • LDA β€” is INTEGER. The leading dimension of the array A. LDA >= max(1,N).
  • AF β€” is REAL array, dimension (LDAF,N). The factors L and U from the factorization A = P*L*U as computed by SGETRF.
  • LDAF β€” is INTEGER. The leading dimension of the array AF. LDAF >= max(1,N).
  • IPIV β€” is INTEGER array, dimension (N). The pivot indices from the factorization A = P*L*U as computed by SGETRF; row i of the matrix was interchanged with row IPIV(i).
  • CMODE β€” is INTEGER. Determines op2(C) in the formula op(A) * op2(C) as follows:
    • CMODE = 1 β†’ op2(C) = C
    • CMODE = 0 β†’ op2(C) = I
    • CMODE = -1 β†’ op2(C) = inv(C)
  • C β€” is REAL array, dimension (N). The vector C in the formula op(A) * op2(C).
  • INFO β€” is INTEGER
    • = 0: Successful exit.
    • i > 0: The ith argument is invalid.
  • WORK β€” is REAL array, dimension (3*N). Workspace.
  • IWORK β€” is INTEGER array, dimension (N). Workspace.2 πŸ‘€

Author πŸ‘‘

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 148 of file sla_gercond.f.


zla_gercond_c πŸ¦‹

double precision function zla_gercond_c (character trans, integer n,
     complex*16, dimension( lda, * ) a, integer lda, complex*16, dimension(
     ldaf, * ) af, integer ldaf, integer, dimension( * ) ipiv, double
     precision, dimension( * ) c, logical capply, integer info, complex*16,
     dimension( * ) work, double precision, dimension( * ) rwork)

ZLA_GERCOND_C computes the infinity norm condition number of op(A)*inv(diag(c)) for general matrices. no cap, that’s the whole vibe ✨

Purpose 🌸

ZLA_GERCOND_C computes the infinity norm condition number of op(A) * inv(diag(C)) where C is a DOUBLE PRECISION vector.

Parameters πŸ’–

  • TRANS β€” is CHARACTER*1. Specifies the form of the system of equations:
    • = 'N': A * X = B (No transpose)
    • = 'T': A**T * X = B (Transpose)
    • = 'C': A**H * X = B (Conjugate Transpose = Transpose)
  • N β€” is INTEGER. The number of linear equations, i.e., the order of the matrix A. N >= 0.
  • A β€” is COMPLEX*16 array, dimension (LDA,N). On entry, the N-by-N matrix A
  • LDA β€” is INTEGER. The leading dimension of the array A. LDA >= max(1,N).
  • AF β€” is COMPLEX*16 array, dimension (LDAF,N). The factors L and U from the factorization A = P*L*U as computed by ZGETRF.
  • LDAF β€” is INTEGER. The leading dimension of the array AF. LDAF >= max(1,N).
  • IPIV β€” is INTEGER array, dimension (N). The pivot indices from the factorization A = P*L*U as computed by ZGETRF; row i of the matrix was interchanged with row IPIV(i).
  • C β€” is DOUBLE PRECISION array, dimension (N). The vector C in the formula op(A) * inv(diag(C)).
  • CAPPLY β€” is LOGICAL. If .TRUE. then access the vector C in the formula above.
  • INFO β€” is INTEGER
    • = 0: Successful exit.
    • i > 0: The ith argument is invalid.
  • WORK β€” is COMPLEX*16 array, dimension (2*N). Workspace.
  • RWORK β€” is DOUBLE PRECISION array, dimension (N). Workspace.

Author πŸ‘‘

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 140 of file zla_gercond_c.f.


zla_gercond_x πŸŽ€

double precision function zla_gercond_x (character trans, integer n,
     complex*16, dimension( lda, * ) a, integer lda, complex*16, dimension(
     ldaf, * ) af, integer ldaf, integer, dimension( * ) ipiv, complex*16,
     dimension( * ) x, integer info, complex*16, dimension( * ) work, double
     precision, dimension( * ) rwork)

ZLA_GERCOND_X computes the infinity norm condition number of op(A)*diag(x) for general matrices. literally the same energy but with X doing main character work πŸ’…

Purpose 🌈

ZLA_GERCOND_X computes the infinity norm condition number of op(A) * diag(X) where X is a COMPLEX*16 vector.

Parameters πŸ’œ

  • TRANS β€” is CHARACTER*1. Specifies the form of the system of equations:
    • = 'N': A * X = B (No transpose)
    • = 'T': A**T * X = B (Transpose)
    • = 'C': A**H * X = B (Conjugate Transpose = Transpose)
  • N β€” is INTEGER. The number of linear equations, i.e., the order of the matrix A. N >= 0.
  • A β€” is COMPLEX*16 array, dimension (LDA,N). On entry, the N-by-N matrix A.
  • LDA β€” is INTEGER. The leading dimension of the array A. LDA >= max(1,N).
  • AF β€” is COMPLEX*16 array, dimension (LDAF,N). The factors L and U from the factorization A = P*L*U as computed by ZGETRF.
  • LDAF β€” is INTEGER. The leading dimension of the array AF. LDAF >= max(1,N).
  • IPIV β€” is INTEGER array, dimension (N). The pivot indices from the factorization A = P*L*U as computed by ZGETRF; row i of the matrix was interchanged with row IPIV(i).
  • X β€” is COMPLEX*16 array, dimension (N). The vector X in the formula op(A) * diag(X).
  • INFO β€” is INTEGER
    • = 0: Successful exit.
    • i > 0: The ith argument is invalid.
  • WORK β€” is COMPLEX*16 array, dimension (2*N). Workspace.
  • RWORK β€” is DOUBLE PRECISION array, dimension (N). Workspace.

Author πŸ‘‘

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 133 of file zla_gercond_x.f.


Author 🫢

Generated automatically by Doxygen for LAPACK from the source code.

✨ okay bestie, that’s the whole lore β€” source/version stamp: LAPACK 3.12.0, page la_gercond(3), signing off with immaculate numerical-analysis energy πŸ’–

πŸ“¦ where this page comes from