tbtrs#

Functions

void stbtrs(
    const char*          uplo,
    const char*          trans,
    const char*          diag,
    const INT            n,
    const INT            kd,
    const INT            nrhs,
    const f32*  restrict AB,
    const INT            ldab,
          f32*  restrict B,
    const INT            ldb,
          INT*           info
);
void stbtrs(const char *uplo, const char *trans, const char *diag, const INT n, const INT kd, const INT nrhs, const f32 *restrict AB, const INT ldab, f32 *restrict B, const INT ldb, INT *info)#

STBTRS solves a triangular system of the form.

A * X = B or A**T * X = B,

where A is a triangular band matrix of order N, and B is an N-by-NRHS matrix.

Parameters

in
uplo

= ‘U’: A is upper triangular = ‘L’: A is lower triangular

in
trans

= ‘N’: A * X = B (No transpose) = ‘T’: A**T * X = B (Transpose) = ‘C’: A**H * X = B (Conjugate transpose = Transpose)

in
diag

= ‘N’: A is non-unit triangular = ‘U’: A is unit triangular

in
n

The order of the matrix A. n >= 0.

in
kd

The number of superdiagonals (if uplo=’U’) or subdiagonals (if uplo=’L’). kd >= 0.

in
nrhs

The number of right hand sides. nrhs >= 0.

in
AB

The triangular band matrix A. Array of dimension (ldab, n).

in
ldab

The leading dimension of AB. ldab >= kd+1.

inout
B

On entry, the right hand side matrix B. On exit, the solution matrix X. Array of dimension (ldb, nrhs).

in
ldb

The leading dimension of B. ldb >= max(1,n).

out
info

  • = 0: successful exit

  • < 0: if info = -i, the i-th argument had an illegal value

  • > 0: if info = i, the i-th diagonal element is zero, indicating the matrix is singular

Functions

void dtbtrs(
    const char*          uplo,
    const char*          trans,
    const char*          diag,
    const INT            n,
    const INT            kd,
    const INT            nrhs,
    const f64*  restrict AB,
    const INT            ldab,
          f64*  restrict B,
    const INT            ldb,
          INT*           info
);
void dtbtrs(const char *uplo, const char *trans, const char *diag, const INT n, const INT kd, const INT nrhs, const f64 *restrict AB, const INT ldab, f64 *restrict B, const INT ldb, INT *info)#

DTBTRS solves a triangular system of the form.

A * X = B or A**T * X = B,

where A is a triangular band matrix of order N, and B is an N-by-NRHS matrix.

Parameters

in
uplo

= ‘U’: A is upper triangular = ‘L’: A is lower triangular

in
trans

= ‘N’: A * X = B (No transpose) = ‘T’: A**T * X = B (Transpose) = ‘C’: A**H * X = B (Conjugate transpose = Transpose)

in
diag

= ‘N’: A is non-unit triangular = ‘U’: A is unit triangular

in
n

The order of the matrix A. n >= 0.

in
kd

The number of superdiagonals (if uplo=’U’) or subdiagonals (if uplo=’L’). kd >= 0.

in
nrhs

The number of right hand sides. nrhs >= 0.

in
AB

The triangular band matrix A. Array of dimension (ldab, n).

in
ldab

The leading dimension of AB. ldab >= kd+1.

inout
B

On entry, the right hand side matrix B. On exit, the solution matrix X. Array of dimension (ldb, nrhs).

in
ldb

The leading dimension of B. ldb >= max(1,n).

out
info

  • = 0: successful exit

  • < 0: if info = -i, the i-th argument had an illegal value

  • > 0: if info = i, the i-th diagonal element is zero, indicating the matrix is singular

Functions

void ctbtrs(
    const char*          uplo,
    const char*          trans,
    const char*          diag,
    const INT            n,
    const INT            kd,
    const INT            nrhs,
    const c64*  restrict AB,
    const INT            ldab,
          c64*  restrict B,
    const INT            ldb,
          INT*           info
);
void ctbtrs(const char *uplo, const char *trans, const char *diag, const INT n, const INT kd, const INT nrhs, const c64 *restrict AB, const INT ldab, c64 *restrict B, const INT ldb, INT *info)#

CTBTRS solves a triangular system of the form.

A * X = B, A**T * X = B, or A**H * X = B,

where A is a triangular band matrix of order N, and B is an N-by-NRHS matrix.

Parameters

in
uplo

= ‘U’: A is upper triangular = ‘L’: A is lower triangular

in
trans

= ‘N’: A * X = B (No transpose) = ‘T’: A**T * X = B (Transpose) = ‘C’: A**H * X = B (Conjugate transpose)

in
diag

= ‘N’: A is non-unit triangular = ‘U’: A is unit triangular

in
n

The order of the matrix A. n >= 0.

in
kd

The number of superdiagonals (if uplo=’U’) or subdiagonals (if uplo=’L’). kd >= 0.

in
nrhs

The number of right hand sides. nrhs >= 0.

in
AB

The triangular band matrix A. Array of dimension (ldab, n).

in
ldab

The leading dimension of AB. ldab >= kd+1.

inout
B

On entry, the right hand side matrix B. On exit, the solution matrix X. Array of dimension (ldb, nrhs).

in
ldb

The leading dimension of B. ldb >= max(1,n).

out
info

  • = 0: successful exit

  • < 0: if info = -i, the i-th argument had an illegal value

  • > 0: if info = i, the i-th diagonal element is zero, indicating the matrix is singular

Functions

void ztbtrs(
    const char*          uplo,
    const char*          trans,
    const char*          diag,
    const INT            n,
    const INT            kd,
    const INT            nrhs,
    const c128* restrict AB,
    const INT            ldab,
          c128* restrict B,
    const INT            ldb,
          INT*           info
);
void ztbtrs(const char *uplo, const char *trans, const char *diag, const INT n, const INT kd, const INT nrhs, const c128 *restrict AB, const INT ldab, c128 *restrict B, const INT ldb, INT *info)#

ZTBTRS solves a triangular system of the form.

A * X = B, A**T * X = B, or A**H * X = B,

where A is a triangular band matrix of order N, and B is an N-by-NRHS matrix.

Parameters

in
uplo

= ‘U’: A is upper triangular = ‘L’: A is lower triangular

in
trans

= ‘N’: A * X = B (No transpose) = ‘T’: A**T * X = B (Transpose) = ‘C’: A**H * X = B (Conjugate transpose)

in
diag

= ‘N’: A is non-unit triangular = ‘U’: A is unit triangular

in
n

The order of the matrix A. n >= 0.

in
kd

The number of superdiagonals (if uplo=’U’) or subdiagonals (if uplo=’L’). kd >= 0.

in
nrhs

The number of right hand sides. nrhs >= 0.

in
AB

The triangular band matrix A. Array of dimension (ldab, n).

in
ldab

The leading dimension of AB. ldab >= kd+1.

inout
B

On entry, the right hand side matrix B. On exit, the solution matrix X. Array of dimension (ldb, nrhs).

in
ldb

The leading dimension of B. ldb >= max(1,n).

out
info

  • = 0: successful exit

  • < 0: if info = -i, the i-th argument had an illegal value

  • > 0: if info = i, the i-th diagonal element is zero, indicating the matrix is singular

On this page

This Page