naginterfaces.library.lapacklin.dgbtrs

naginterfaces.library.lapacklin.dgbtrs(trans, kl, ku, ab, ipiv, b)

dgbtrs solves a real band system of linear equations with multiple right-hand sides,

$$AX=B\text{or}{A}^{T}X=B\text{,}$$

where $A$ has been factorized by dgbtrf().

For full information please refer to the NAG Library document for f07be

https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/f07/f07bef.html

Parameters

transstr, length 1

Indicates the form of the equations.

$trans=\text{'N'}$

$AX=B$ is solved for $X$.

$trans=\text{'T'}$ or $\text{'C'}$

$A^{T}X=B$ is solved for $X$.

klint

$k_l$, the number of subdiagonals within the band of the matrix $A$.

kuint

$k_u$, the number of superdiagonals within the band of the matrix $A$.

abfloat, array-like, shape $(2\times kl+ku+1,n)$

The $LU$ factorization of $A$, as returned by dgbtrf().

ipivint, array-like, shape $\left(n\right)$

The pivot indices, as returned by dgbtrf().

bfloat, array-like, shape $(n,\text{nrhs})$

The $n\times r$ right-hand side matrix $B$.

Returns

bfloat, ndarray, shape $(n,\text{nrhs})$

The $n\times r$ solution matrix $X$.

Raises

NagValueError

(errno $-1$)

On entry, error in parameter $trans$.

Constraint: $trans=\text{'N'}$, $\text{'T'}$ or $\text{'C'}$.

(errno $-2$)

On entry, error in parameter $\text{n}$.

Constraint: $n\ge 0$.

(errno $-3$)

On entry, error in parameter $kl$.

Constraint: $kl\ge 0$.

(errno $-4$)

On entry, error in parameter $ku$.

Constraint: $ku\ge 0$.

(errno $-5$)

On entry, error in parameter $\text{nrhs}$.

Constraint: $\text{nrhs}\ge 0$.

Notes

dgbtrs is used to solve a real band system of linear equations $AX=B$ or $A^{T}X=B$, the function must be preceded by a call to dgbtrf() which computes the $LU$ factorization of $A$ as $A=PLU$. The solution is computed by forward and backward substitution.

If $trans=\text{'N'}$, the solution is computed by solving $PLY=B$ and then $UX=Y$.

If $trans=\text{'T'}$ or $\text{'C'}$, the solution is computed by solving $U^{T}Y=B$ and then $L^T{P}^{T}X=Y$.

References

Golub, G H and Van Loan, C F, 1996, Matrix Computations, (3rd Edition), Johns Hopkins University Press, Baltimore