.TH "SRC/spbrfs.f" 3 "Version 3.12.0" "LAPACK" \" -*- nroff -*- .ad l .nh .SH NAME SRC/spbrfs.f .SH SYNOPSIS .br .PP .SS "Functions/Subroutines" .in +1c .ti -1c .RI "subroutine \fBspbrfs\fP (uplo, n, kd, nrhs, ab, ldab, afb, ldafb, b, ldb, x, ldx, ferr, berr, work, iwork, info)" .br .RI "\fBSPBRFS\fP " .in -1c .SH "Function/Subroutine Documentation" .PP .SS "subroutine spbrfs (character uplo, integer n, integer kd, integer nrhs, real, dimension( ldab, * ) ab, integer ldab, real, dimension( ldafb, * ) afb, integer ldafb, real, dimension( ldb, * ) b, integer ldb, real, dimension( ldx, * ) x, integer ldx, real, dimension( * ) ferr, real, dimension( * ) berr, real, dimension( * ) work, integer, dimension( * ) iwork, integer info)" .PP \fBSPBRFS\fP .PP \fBPurpose:\fP .RS 4 .PP .nf !> !> SPBRFS improves the computed solution to a system of linear !> equations when the coefficient matrix is symmetric positive definite !> and banded, and provides error bounds and backward error estimates !> for the solution\&. !> .fi .PP .RE .PP \fBParameters\fP .RS 4 \fIUPLO\fP .PP .nf !> UPLO is CHARACTER*1 !> = 'U': Upper triangle of A is stored; !> = 'L': Lower triangle of A is stored\&. !> .fi .PP .br \fIN\fP .PP .nf !> N is INTEGER !> The order of the matrix A\&. N >= 0\&. !> .fi .PP .br \fIKD\fP .PP .nf !> KD is INTEGER !> The number of superdiagonals of the matrix A if UPLO = 'U', !> or the number of subdiagonals if UPLO = 'L'\&. KD >= 0\&. !> .fi .PP .br \fINRHS\fP .PP .nf !> NRHS is INTEGER !> The number of right hand sides, i\&.e\&., the number of columns !> of the matrices B and X\&. NRHS >= 0\&. !> .fi .PP .br \fIAB\fP .PP .nf !> AB is REAL array, dimension (LDAB,N) !> The upper or lower triangle of the symmetric band matrix A, !> stored in the first KD+1 rows of the array\&. The j-th column !> of A is stored in the j-th column of the array AB as follows: !> if UPLO = 'U', AB(kd+1+i-j,j) = A(i,j) for max(1,j-kd)<=i<=j; !> if UPLO = 'L', AB(1+i-j,j) = A(i,j) for j<=i<=min(n,j+kd)\&. !> .fi .PP .br \fILDAB\fP .PP .nf !> LDAB is INTEGER !> The leading dimension of the array AB\&. LDAB >= KD+1\&. !> .fi .PP .br \fIAFB\fP .PP .nf !> AFB is REAL array, dimension (LDAFB,N) !> The triangular factor U or L from the Cholesky factorization !> A = U**T*U or A = L*L**T of the band matrix A as computed by !> SPBTRF, in the same storage format as A (see AB)\&. !> .fi .PP .br \fILDAFB\fP .PP .nf !> LDAFB is INTEGER !> The leading dimension of the array AFB\&. LDAFB >= KD+1\&. !> .fi .PP .br \fIB\fP .PP .nf !> B is REAL array, dimension (LDB,NRHS) !> The right hand side matrix B\&. !> .fi .PP .br \fILDB\fP .PP .nf !> LDB is INTEGER !> The leading dimension of the array B\&. LDB >= max(1,N)\&. !> .fi .PP .br \fIX\fP .PP .nf !> X is REAL array, dimension (LDX,NRHS) !> On entry, the solution matrix X, as computed by SPBTRS\&. !> On exit, the improved solution matrix X\&. !> .fi .PP .br \fILDX\fP .PP .nf !> LDX is INTEGER !> The leading dimension of the array X\&. LDX >= max(1,N)\&. !> .fi .PP .br \fIFERR\fP .PP .nf !> FERR is REAL array, dimension (NRHS) !> The estimated forward error bound for each solution vector !> X(j) (the j-th column of the solution matrix X)\&. !> If XTRUE is the true solution corresponding to X(j), FERR(j) !> is an estimated upper bound for the magnitude of the largest !> element in (X(j) - XTRUE) divided by the magnitude of the !> largest element in X(j)\&. The estimate is as reliable as !> the estimate for RCOND, and is almost always a slight !> overestimate of the true error\&. !> .fi .PP .br \fIBERR\fP .PP .nf !> BERR is REAL array, dimension (NRHS) !> The componentwise relative backward error of each solution !> vector X(j) (i\&.e\&., the smallest relative change in !> any element of A or B that makes X(j) an exact solution)\&. !> .fi .PP .br \fIWORK\fP .PP .nf !> WORK is REAL array, dimension (3*N) !> .fi .PP .br \fIIWORK\fP .PP .nf !> IWORK is INTEGER array, dimension (N) !> .fi .PP .br \fIINFO\fP .PP .nf !> INFO is INTEGER !> = 0: successful exit !> < 0: if INFO = -i, the i-th argument had an illegal value !> .fi .PP .RE .PP \fBInternal Parameters:\fP .RS 4 .PP .nf !> ITMAX is the maximum number of steps of iterative refinement\&. !> .fi .PP .RE .PP \fBAuthor\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP .PP Definition at line \fB187\fP of file \fBspbrfs\&.f\fP\&. .SH "Author" .PP Generated automatically by Doxygen for LAPACK from the source code\&.