naginterfaces.library.lapacklin.zgttrs

naginterfaces.library.lapacklin.zgttrs(trans, dl, d, du, du2, ipiv, b)

zgttrs computes the solution to a complex system of linear equations $AX=B$ or $A^{T}X=B$ or $A^{H}X=B$, where $A$ is an $n\times n$ tridiagonal matrix and $X$ and $B$ are $n\times r$ matrices, using the $LU$ factorization returned by zgttrf().

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

https://www.nag.com/numeric/nl/nagdoc_29.3/flhtml/f07/f07csf.html

Parameters

transstr, length 1

Specifies the equations to be solved as follows:

$trans=\text{'N'}$

Solve $AX=B$ for $X$.

$trans=\text{'T'}$

Solve $A^{T}X=B$ for $X$.

$trans=\text{'C'}$

Solve $A^{H}X=B$ for $X$.

dlcomplex, array-like, shape $(n-1)$

Must contain the $(n-1)$ multipliers that define the matrix $L$ of the $LU$ factorization of $A$.

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

Must contain the $n$ diagonal elements of the upper triangular matrix $U$ from the $LU$ factorization of $A$.

ducomplex, array-like, shape $(n-1)$

Must contain the $(n-1)$ elements of the first superdiagonal of $U$.

du2complex, array-like, shape $(n-2)$

Must contain the $(n-2)$ elements of the second superdiagonal of $U$.

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

Must contain the $n$ pivot indices that define the permutation matrix $P$. At the $i$th step, row $i$ of the matrix was interchanged with row $ipiv[i-1]$, and $ipiv[i-1]$ must always be either $i$ or $(i+1)$, $ipiv[i-1]=i$ indicating that a row interchange was not performed.

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

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

Returns

bcomplex, 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 $\text{nrhs}$.

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

Notes

zgttrs should be preceded by a call to zgttrf(), which uses Gaussian elimination with partial pivoting and row interchanges to factorize the matrix $A$ as

$$A=PLU\text{,}$$

where $P$ is a permutation matrix, $L$ is unit lower triangular with at most one nonzero subdiagonal element in each column, and $U$ is an upper triangular band matrix, with two superdiagonals. zgttrs then utilizes the factorization to solve the required equations.

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, https://www.netlib.org/lapack/lug

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