?dttrsb

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 3/22/2024

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

?dttrsb

Solves a system of linear equations with a diagonally dominant tridiagonal coefficient matrix using the LU factorization computed by ?dttrfb.

Syntax

void sdttrsb (const char * trans, const MKL_INT * n, const MKL_INT * nrhs, const float * dl, const float * d, const float * du, float * b, const MKL_INT * ldb, MKL_INT * info );

void ddttrsb (const char * trans, const MKL_INT * n, const MKL_INT * nrhs, const double * dl, const double * d, const double * du, double * b, const MKL_INT * ldb, MKL_INT * info );

void cdttrsb (const char * trans, const MKL_INT * n, const MKL_INT * nrhs, const MKL_Complex8 * dl, const MKL_Complex8 * d, const MKL_Complex8 * du, MKL_Complex8 * b, const MKL_INT * ldb, MKL_INT * info );

void zdttrsb (const char * trans, const MKL_INT * n, const MKL_INT * nrhs, const MKL_Complex16 * dl, const MKL_Complex16 * d, const MKL_Complex16 * du, MKL_Complex16 * b, const MKL_INT * ldb, MKL_INT * info );

Include Files

mkl.h

Description

The ?dttrsb routine solves the following systems of linear equations with multiple right hand sides for X:

`A`*`X` = `B`	if trans='N',
`A`^T*`X` = `B`	if trans='T',
`A`^H*`X` = `B`	if trans='C' (for complex matrices only).

Before calling this routine, call ?dttrfb to compute the factorization of A.

Input Parameters

trans	Must be 'N' or 'T' or 'C'. Indicates the form of the equations solved for `X`: If `trans = 'N'`, then `AX = B`. If `trans = 'T'`, then `A`^T`X` = `B`. If `trans = 'C'`, then `A`^H*`X` = `B`.
n	The order of `A`; n≥ 0.
nrhs	The number of right-hand sides, that is, the number of columns in `B`; nrhs≥ 0.
dl, d, du	Arrays: `dl(n -1)`, `d(n)`, `du(n -1)`. The array dl contains the `(n - 1)` multipliers that define the matrices `L`₁, `L`₂ from the factorization of `A`. The array d contains the n diagonal elements of the upper triangular matrix `U` from the factorization of `A`. The array du contains the (n - 1) elements of the superdiagonal of `U`.
b	Array of size max(1, ldb*nrhs). Contains the matrix `B` whose columns are the right-hand sides for the systems of equations.
ldb	The leading dimension of b; `ldb≥ max(1, n)`.

Output Parameters

Overwritten by the solution matrix X.

info

If info = 0, the execution is successful.

If info = -i, the i-th parameter had an illegal value.

Parent topic: Solving Systems of Linear Equations: LAPACK Computational Routines

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for C

?dttrsb

Syntax

Include Files

Description

Input Parameters

Output Parameters