?hetrs

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 11/07/2023

Version

Public

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

Visible to Intel only — GUID: GUID-78F448C7-AC85-45E7-A90A-2D1A249BA71A

View Details

?hetrs_aa

BSolves a system of linear equations A*X = with a complex Hermitian matrix.

LAPACK_DECL lapack_int LAPACKE_chetrs_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_DECL lapack_int LAPACKE_zhetrs_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

?hetrs_aa solves a system of linear equations A*X = X with a complex Hermitian matrix A using the factorization A = U * T * U^H or A = L * T * L^H computed by ?hetrf_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.

If uplo = 'U': Upper triangular of the form A = U * T * U^H.

If uplo= 'L': Lower triangular of the form A = L * T * L^H.

n

The order of the matrix A. n≥ 0.

nrhs

The number of right hand sides: the number of columns of the matrix b. nrhs≥ 0.

a

Array of size lda*n. Details of factors computed by ?hetrf_aa.

lda

The leading dimension of the array a. lda≥ max(1,n).

ipiv

Array of size (n). Details of the interchanges as computed by ?hetrf_aa.

b

Array of size ldb*nrhs. On entry, the right hand side matrix B.

ldb

The leading dimension of the array b. ldb≥ max(1, n).

work

See Syntax - Workspace. Array of size (max(1, lwork)).

lwork

See Syntax - Workspace. lwork≥ max(1, 3*n-2).

Output Parameters

b: On exit, the solution matrix X.

Return Values

This function returns a value info.

If info = 0: successful exit.

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

Syntax - Workspace

Use this interface if you want to explicitly provide the workspace array.

LAPACK_DECL lapack_int LAPACKE_chetrs_aa_work (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_complex_float * work, lapack_int lwork );

LAPACK_DECL lapack_int LAPACKE_zhetrs_aa_work (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, lapack_complex_double * work, lapack_int lwork );

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