la_porcond(3)

πŸ’… la_porcond(3) β€” Skeel condition number estimate πŸ’…

Okay bestie, welcome to la_porcond(3) from the Library Functions Manual. This page is the whole la_porcond situation: Skeel condition number estimate energy. It's a family of routines, and we're about to go through them one by one. 🫢

πŸ’– NAME πŸ’–

la_porcond β€” la_porcond: Skeel condition number estimate

✨ SYNOPSIS ✨

Functions

  • real function cla_porcond_c (uplo, n, a, lda, af, ldaf, c, capply, info, work, rwork) β€” CLA_PORCOND_C computes the infinity norm condition number of op(A)*inv(diag(c)) for Hermitian positive-definite matrices.
  • real function cla_porcond_x (uplo, n, a, lda, af, ldaf, x, info, work, rwork) β€” CLA_PORCOND_X computes the infinity norm condition number of op(A)*diag(x) for Hermitian positive-definite matrices.
  • double precision function dla_porcond (uplo, n, a, lda, af, ldaf, cmode, c, info, work, iwork) β€” DLA_PORCOND estimates the Skeel condition number for a symmetric positive-definite matrix.
  • real function sla_porcond (uplo, n, a, lda, af, ldaf, cmode, c, info, work, iwork) β€” SLA_PORCOND estimates the Skeel condition number for a symmetric positive-definite matrix.
  • double precision function zla_porcond_c (uplo, n, a, lda, af, ldaf, c, capply, info, work, rwork) β€” ZLA_PORCOND_C computes the infinity norm condition number of op(A)*inv(diag(c)) for Hermitian positive-definite matrices.
  • double precision function zla_porcond_x (uplo, n, a, lda, af, ldaf, x, info, work, rwork) β€” ZLA_PORCOND_X computes the infinity norm condition number of op(A)*diag(x) for Hermitian positive-definite matrices.

🌸 Detailed Description 🌸

This is the detailed docs zone, bestie. The function-by-function breakdown starts right below. πŸ’–

πŸ¦‹ Function Documentation πŸ¦‹

cla_porcond_c β€” real function

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

CLA_PORCOND_C computes the infinity norm condition number of op(A)*inv(diag(c)) for Hermitian positive-definite matrices.

Purpose

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

Parameters

  • UPLO β€” CHARACTER*1; = 'U': upper triangle of A is stored; = 'L': lower triangle of A is stored.
  • N β€” INTEGER; the number of linear equations, i.e., the order of the matrix A. N >= 0.
  • A β€” COMPLEX array, dimension (LDA,N); on entry, the N-by-N matrix A.
  • LDA β€” INTEGER; the leading dimension of the array A. LDA >= max(1,N).
  • AF β€” COMPLEX array, dimension (LDAF,N); the triangular factor U or L from the Cholesky factorization A = U**H*U or A = L*L**H, as computed by CPOTRF.
  • LDAF β€” INTEGER; the leading dimension of the array AF. LDAF >= max(1,N).
  • C β€” REAL array, dimension (N); the vector C in the formula op(A) * inv(diag(C)).
  • CAPPLY β€” LOGICAL; if .TRUE. then access the vector C in the formula above.
  • INFO β€” INTEGER; = 0: successful exit; i > 0: the ith argument is invalid.
  • WORK β€” COMPLEX array, dimension (2*N); workspace.
  • RWORK β€” REAL array, dimension (N); workspace.

Author

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

Definition at line 128 of file cla_porcond_c.f.


cla_porcond_x β€” real function

real function cla_porcond_x (character uplo, integer n, complex, dimension(
     lda, * ) a, integer lda, complex, dimension( ldaf, * ) af, integer ldaf,
     complex, dimension( * ) x, integer info, complex, dimension( * ) work,
     real, dimension( * ) rwork)

CLA_PORCOND_X computes the infinity norm condition number of op(A)*diag(x) for Hermitian positive-definite matrices.

Purpose

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

Parameters

  • UPLO β€” CHARACTER*1; = 'U': upper triangle of A is stored; = 'L': lower triangle of A is stored.
  • N β€” INTEGER; the number of linear equations, i.e., the order of the matrix A. N >= 0.
  • A β€” COMPLEX array, dimension (LDA,N); on entry, the N-by-N matrix A.
  • LDA β€” INTEGER; the leading dimension of the array A. LDA >= max(1,N).
  • AF β€” COMPLEX array, dimension (LDAF,N); the triangular factor U or L from the Cholesky factorization A = U**H*U or A = L*L**H, as computed by CPOTRF.
  • LDAF β€” INTEGER; the leading dimension of the array AF. LDAF >= max(1,N).
  • X β€” COMPLEX array, dimension (N); the vector X in the formula op(A) * diag(X).
  • INFO β€” INTEGER; = 0: successful exit; i > 0: the ith argument is invalid.
  • WORK β€” COMPLEX array, dimension (2*N); workspace.
  • RWORK β€” REAL array, dimension (N); workspace.

Author

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

Definition at line 121 of file cla_porcond_x.f.


dla_porcond β€” double precision function

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

DLA_PORCOND estimates the Skeel condition number for a symmetric positive-definite matrix.

Purpose

DLA_PORCOND estimates the Skeel condition number of op(A) * op2(C) where op2 is determined by CMODE like this:

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

  • UPLO β€” CHARACTER*1; = 'U': upper triangle of A is stored; = 'L': lower triangle of A is stored.
  • N β€” INTEGER; the number of linear equations, i.e., the order of the matrix A. N >= 0.
  • A β€” DOUBLE PRECISION array, dimension (LDA,N); on entry, the N-by-N matrix A.
  • LDA β€” INTEGER; the leading dimension of the array A. LDA >= max(1,N).
  • AF β€” DOUBLE PRECISION array, dimension (LDAF,N); the triangular factor U or L from the Cholesky factorization A = U**T*U or A = L*L**T, as computed by DPOTRF.
  • LDAF β€” INTEGER; the leading dimension of the array AF. LDAF >= max(1,N).
  • CMODE β€” 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 β€” DOUBLE PRECISION array, dimension (N); the vector C in the formula op(A) * op2(C).
  • INFO β€” INTEGER; = 0: successful exit; i > 0: the ith argument is invalid.
  • WORK β€” DOUBLE PRECISION array, dimension (3*N); workspace.
  • IWORK β€” INTEGER array, dimension (N); workspace.

Author

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

Definition at line 139 of file dla_porcond.f.


sla_porcond β€” real function

real function sla_porcond (character uplo, integer n, real, dimension( lda,
     * ) a, integer lda, real, dimension( ldaf, * ) af, integer ldaf, integer
     cmode, real, dimension( * ) c, integer info, real, dimension( * ) work,
     integer, dimension( * ) iwork)

SLA_PORCOND estimates the Skeel condition number for a symmetric positive-definite matrix.

Purpose

SLA_PORCOND estimates the Skeel condition number of op(A) * op2(C) where op2 is determined by CMODE like this:

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

  • UPLO β€” CHARACTER*1; = 'U': upper triangle of A is stored; = 'L': lower triangle of A is stored.
  • N β€” INTEGER; the number of linear equations, i.e., the order of the matrix A. N >= 0.
  • A β€” REAL array, dimension (LDA,N); on entry, the N-by-N matrix A.
  • LDA β€” INTEGER; the leading dimension of the array A. LDA >= max(1,N).
  • AF β€” REAL array, dimension (LDAF,N); the triangular factor U or L from the Cholesky factorization A = U**T*U or A = L*L**T, as computed by SPOTRF.
  • LDAF β€” INTEGER; the leading dimension of the array AF. LDAF >= max(1,N).

CMODE

…

CMODE is INTEGER β€” it determines op2(C) in the formula op(A) * op2(C), like this:

  • CMODE = 1 β†’ op2(C) = C
  • CMODE = 0 β†’ op2(C) = I
  • CMODE = -1 β†’ op2(C) = inv(C)

πŸ“ C

C is REAL array, dimension (N) β€” literally the vector C in the formula op(A) * op2(C). That's the whole assignment, bestie.

🚨 INFO

INFO is INTEGER:

  • = 0: successful exit ✨
  • i > 0: the ith argument is invalid β€” not iconic, but important to know.

🧰 WORK

WORK is REAL array, dimension (3*N) β€” workspace. It's giving "behind the scenes" energy.

πŸ—‚οΈ IWORK

IWORK is INTEGER array, dimension (N) β€” also workspace. Periodt.

πŸ‘‘ Author

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

Definition: at line 138 of file sla_porcond.f.


πŸ’– zla_porcond_c

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

ZLA_PORCOND_C computes the infinity norm condition number of op(A)*inv(diag(c)) for Hermitian positive-definite matrices. It's giving "condition number but make it Cholesky-coded" ✨

🎯 Purpose

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

🧚 Parameters

  • UPLO β€” CHARACTER*1: = 'U': upper triangle of A is stored; = 'L': lower triangle of A is stored.
  • N β€” INTEGER: the number of linear equations, i.e., the order of the matrix A. N >= 0.
  • A β€” COMPLEX*16 array, dimension (LDA,N): on entry, the N-by-N matrix A.
  • LDA β€” INTEGER: the leading dimension of the array A. LDA >= max(1,N).
  • AF β€” COMPLEX*16 array, dimension (LDAF,N): the triangular factor U or L from the Cholesky factorization A = U**H*U or A = L*L**H, as computed by ZPOTRF.
  • LDAF β€” INTEGER: the leading dimension of the array AF. LDAF >= max(1,N).
  • C β€” DOUBLE PRECISION array, dimension (N): the vector C in the formula op(A) * inv(diag(C)).
  • CAPPLY β€” LOGICAL: if .TRUE. then access the vector C in the formula above.
  • INFO β€” INTEGER: = 0: successful exit. i > 0: the ith argument is invalid.
  • WORK β€” COMPLEX*16 array, dimension (2*N): workspace.
  • RWORK β€” DOUBLE PRECISION array, dimension (N): workspace.

πŸ‘‘ Author

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

Definition: at line 129 of file zla_porcond_c.f.


πŸ¦‹ zla_porcond_x

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

ZLA_PORCOND_X computes the infinity norm condition number of op(A)*diag(x) for Hermitian positive-definite matrices. Different flavor, same condition-number obsession πŸ’…

🎯 Purpose

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

🧚 Parameters

  • UPLO β€” CHARACTER*1: = 'U': upper triangle of A is stored; = 'L': lower triangle of A is stored.
  • N β€” INTEGER: the number of linear equations, i.e., the order of the matrix A. N >= 0.
  • A β€” COMPLEX*16 array, dimension (LDA,N): on entry, the N-by-N matrix A.
  • LDA β€” INTEGER: the leading dimension of the array A. LDA >= max(1,N).
  • AF β€” COMPLEX*16 array, dimension (LDAF,N): the triangular factor U or L from the Cholesky factorization A = U**H*U or A = L*L**H, as computed by ZPOTRF.
  • LDAF β€” INTEGER: the leading dimension of the array AF. LDAF >= max(1,N).
  • X β€” COMPLEX*16 array, dimension (N): the vector X in the formula op(A) * diag(X).
  • INFO β€” INTEGER: = 0: successful exit. i > 0: the ith argument is invalid.
  • WORK β€” COMPLEX*16 array, dimension (2*N): workspace.
  • RWORK β€” DOUBLE PRECISION array, dimension (N): workspace.

πŸ‘‘ Author

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

Definition: at line 122 of file zla_porcond_x.f.


πŸ‘‘ Author

Generated automatically by Doxygen for LAPACK from the source code.

This iconic little page is LAPACK Version 3.12.0, la_porcond(3) β€” mwah πŸ’‹

πŸ“¦ where this page comes from