NAG Library Routine Document
F07HAF (DPBSV)
1 Purpose
F07HAF (DPBSV) computes the solution to a real system of linear equations
where
is an
by
symmetric positive definite band matrix of bandwidth
and
and
are
by
matrices.
2 Specification
INTEGER |
N, KD, NRHS, LDAB, LDB, INFO |
REAL (KIND=nag_wp) |
AB(LDAB,*), B(LDB,*) |
CHARACTER(1) |
UPLO |
|
The routine may be called by its
LAPACK
name dpbsv.
3 Description
F07HAF (DPBSV) uses the Cholesky decomposition to factor as if or if , where is an upper triangular band matrix, and is a lower triangular band matrix, with the same number of superdiagonals or subdiagonals as . The factored form of is then used to solve the system of equations .
4 References
Anderson E, Bai Z, Bischof C, Blackford S, Demmel J, Dongarra J J, Du Croz J J, Greenbaum A, Hammarling S, McKenney A and Sorensen D (1999)
LAPACK Users' Guide (3rd Edition) SIAM, Philadelphia
http://www.netlib.org/lapack/lug
Golub G H and Van Loan C F (1996) Matrix Computations (3rd Edition) Johns Hopkins University Press, Baltimore
5 Parameters
- 1: UPLO – CHARACTER(1)Input
On entry: if
, the upper triangle of
is stored.
If , the lower triangle of is stored.
Constraint:
or .
- 2: N – INTEGERInput
On entry: , the number of linear equations, i.e., the order of the matrix .
Constraint:
.
- 3: KD – INTEGERInput
On entry: , the number of superdiagonals of the matrix if , or the number of subdiagonals if .
Constraint:
.
- 4: NRHS – INTEGERInput
On entry: , the number of right-hand sides, i.e., the number of columns of the matrix .
Constraint:
.
- 5: AB(LDAB,) – REAL (KIND=nag_wp) arrayInput/Output
-
Note: the second dimension of the array
AB
must be at least
.
On entry: the upper or lower triangle of the symmetric band matrix
.
The matrix is stored in rows
to
, more precisely,
- if , the elements of the upper triangle of within the band must be stored with element in ;
- if , the elements of the lower triangle of within the band must be stored with element in
On exit: if , the triangular factor or from the Cholesky factorization or of the band matrix , in the same storage format as .
- 6: LDAB – INTEGERInput
On entry: the first dimension of the array
AB as declared in the (sub)program from which F07HAF (DPBSV) is called.
Constraint:
.
- 7: B(LDB,) – REAL (KIND=nag_wp) arrayInput/Output
-
Note: the second dimension of the array
B
must be at least
.
On entry: the by right-hand side matrix .
On exit: if , the by solution matrix .
- 8: LDB – INTEGERInput
On entry: the first dimension of the array
B as declared in the (sub)program from which F07HAF (DPBSV) is called.
Constraint:
.
- 9: INFO – INTEGEROutput
On exit:
unless the routine detects an error (see
Section 6).
6 Error Indicators and Warnings
Errors or warnings detected by the routine:
If , the th argument had an illegal value. An explanatory message is output, and execution of the program is terminated.
If , the leading minor of order of is not positive definite, so the factorization could not be completed, and the solution has not been computed.
7 Accuracy
The computed solution for a single right-hand side,
, satisfies an equation of the form
where
and
is the
machine precision. An approximate error bound for the computed solution is given by
where
, the condition number of
with respect to the solution of the linear equations. See Section 4.4 of
Anderson et al. (1999) for further details.
F07HBF (DPBSVX) is a comprehensive LAPACK driver that returns forward and backward error bounds and an estimate of the condition number. Alternatively,
F04BFF solves
and returns a forward error bound and condition estimate.
F04BFF calls F07HAF (DPBSV) to solve the equations.
When , the total number of floating point operations is approximately , where is the number of superdiagonals and is the number of right-hand sides.
The complex analogue of this routine is
F07HNF (ZPBSV).
9 Example
This example solves the equations
where
is the symmetric positive definite band matrix
Details of the Cholesky factorization of are also output.
9.1 Program Text
Program Text (f07hafe.f90)
9.2 Program Data
Program Data (f07hafe.d)
9.3 Program Results
Program Results (f07hafe.r)