Auxilliary Routines APIs#

LACN2#

group lacn2

Functions

template<typename T>
void lacn2(integer *n, T *v, T *x, integer *isgn, T *est, integer *kase, integer *isave)#

LACN2 estimates the 1-norm of a square matrix.

Purpose:

  LACN2 estimates the 1-norm of a square, real matrix A.
  Reverse communication is used for evaluating matrix-vector products.

Parameters:
  • N – [in]

    N is INTEGER

    The order of the matrix. N >= 1.

  • V – [out]

    V is REAL array, dimension (N)

    On the final return, V = A*W, where EST = norm(V)/norm(W) (W is not returned).

  • X – [inout]

    X is REAL array, dimension (N)

    On an intermediate return, X should be overwritten by

    A * X, if KASE=1,

    A**T * X, if KASE=2,

    and SLACN2 must be re-called with all the other parameters unchanged.

  • ISGN – [out] ISGN is INTEGER array, dimension (N)

  • EST – [inout]

    EST is REAL

    On entry with KASE = 1 or 2 and ISAVE(1) = 3, EST should be unchanged from the previous call to SLACN2.

    On exit, EST is an estimate (a lower bound) for norm(A).

  • KASE – [inout]

    KASE is INTEGER

    On the initial call to SLACN2, KASE should be 0.

    On an intermediate return, KASE will be 1 or 2, indicating whether X should be overwritten by A * X or A**T * X. On the final return from SLACN2, KASE will again be 0.

  • ISAVE – [inout]

    ISAVE is INTEGER array, dimension (3)

    ISAVE is used to save variables between calls to SLACN2

template<typename T, typename Ta>
void lacn2(integer *n, T *v, T *x, Ta *est, integer *kase, integer *isave)#

LACON#

group lacon

Functions

template<typename T>
void lacon(integer *n, T *v, T *x, integer *isgn, T *est, integer *kase)#

LACON estimates the 1-norm of a square matrix, using reverse communication for evaluating matrix-vector products.

Purpose:

   LACON estimates the 1-norm of a square, real matrix A.
   Reverse communication is used for evaluating matrix-vector products.

Parameters:
  • N – [in]

    N is INTEGER

    The order of the matrix. N >= 1.

  • V – [out]

    V is REAL array, dimension (N)

    On the final return, V = A*W, where EST = norm(V)/norm(W) (W is not returned).

  • X – [inout]

    X is REAL array, dimension (N)

    On an intermediate return, X should be overwritten by

    A * X, if KASE=1,

    A**T * X, if KASE=2,

    and SLACON must be re-called with all the other parameters unchanged.

  • ISGN – [out] ISGN is INTEGER array, dimension (N)

  • EST – [inout]

    EST is REAL

    On entry with KASE = 1 or 2 and JUMP = 3, EST should be unchanged from the previous call to SLACON.

    On exit, EST is an estimate (a lower bound) for norm(A).

  • KASE – [inout]

    KASE is INTEGER

    On the initial call to SLACON, KASE should be 0. On an intermediate return, KASE will be 1 or 2, indicating whether X should be overwritten by A * X or A**T * X. On the final return from SLACON, KASE will again be 0.

template<typename T, typename Ta>
void lacon(integer *n, T *v, T *x, Ta *est, integer *kase)#

LA_LIN_BERR#

group la_lin_berr

Functions

template<typename T>
void la_lin_berr(integer *n, integer *nz, integer *nrhs, T *res, T *ayb, T *berr)#

LA_LIN_BERR computes a component-wise relative backward error.

Purpose:

 LA_LIN_BERR computes componentwise relative backward error from
 the formula
     fla_max(i) (abs(R(i)) / (abs(op(A_s))*abs(Y) + abs(B_s))(i))
 where abs(Z) is the componentwise absolute value of the matrix
 or vector Z.

Parameters:
  • N – [in]

    N is INTEGER

    The number of linear equations, i.e., the order of the matrix A. N >= 0.

  • NZ – [in]

    NZ is INTEGER

    We add (NZ+1)*SLAMCH(‘Safe minimum’) to R(i) in the numerator to guard against spuriously zero residuals. Default value is N.

  • NRHS – [in]

    NRHS is INTEGER

    The number of right hand sides, i.e., the number of columns of the matrices AYB, RES, and BERR. NRHS >= 0.

  • RES – [in]

    RES is REAL array, dimension (N,NRHS)

    The residual matrix, i.e., the matrix R in the relative backward error formula above.

  • AYB – [in]

    AYB is REAL array, dimension (N, NRHS)

    The denominator in the relative backward error formula above, i.e., the matrix abs(op(A_s))*abs(Y) + abs(B_s). The matrices A, Y, and B are from iterative refinement (see sla_gerfsx_extended.f).

  • BERR – [out]

    BERR is REAL array, dimension (NRHS)

    The componentwise relative backward error from the formula above.

template<typename T, typename Ta>
void la_lin_berr(integer *n, integer *nz, integer *nrhs, T *res, Ta *ayb, Ta *berr)#