Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 11/07/2023
Public

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

Document Table of Contents

?sytrs_aa

Solves a system of linear equations A * X = B with a symmetric matrix.

lapack_int LAPACKE_ssytrs_aa (int matrix_layout, char uplo, lapack_int n, lapack_int nrhs, const float * A, lapack_int lda, const lapack_int * ipiv, float * B, lapack_int ldb);

lapack_int LAPACKE_dsytrs_aa (int matrix_layout, char uplo, lapack_int n, lapack_int nrhs, const double * A, lapack_int lda, const lapack_int * ipiv, double * B, lapack_int ldb);

lapack_int LAPACKE_csytrs_aa (int matrix_layout, char uplo, lapack_int n, lapack_int nrhs, const lapack_complex_float * A, lapack_int lda, const lapack_int * ipiv, lapack_complex_float * B, lapack_int ldb);

lapack_int LAPACKE_zsytrs_aa (int matrix_layout, char uplo, lapack_int n, lapack_int nrhs, const lapack_complex_double * A, lapack_int lda, const lapack_int * ipiv, lapack_complex_double * B, lapack_int ldb);

Description

?sytrs_aa solves a system of linear equations A * X = B with a symmetric matrix A using the factorization A = U*T*UT or A = L*T*LT computed by ?sytrf_aa.

Input Parameters

matrix_layout

Specifies whether matrix storage layout is row major (LAPACK_ROW_MAJOR) or column major (LAPACK_COL_MAJOR).

uplo

Specifies whether the details of the factorization are stored as an upper or lower triangular matrix.

  • = 'U': Upper triangular; the form is A = U*T*UT.
  • = 'L': Lower triangular; the form is A = L*T*LT.
n

The order of the matrix A. n ≥ 0.

nrhs

The number of right-hand sides; that is, the number of columns of the matrix B. nrhs ≥ 0.

A

Array of size max(1, lda*n). Details of factors computed by ?sytrf_aa.

lda

The leading dimension of the array A.

ipiv

Array of size n. Details of the interchanges as computed by ?sytrf_aa.

B

Array of size max(1, ldb*nrhs). On entry, the right-hand side matrix B.

ldb

The leading dimension of the array B. ldb ≥ max(1, n) for column-major layout and ldbnrhs for row-major layout.

Output Parameters

B

On exit, the solution matrix X.

Return Values

This function returns a value info.

= 0: Successful exit.

< 0: If info = -i, the ith argument had an illegal value.