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>
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>
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>