Developer Reference for Intel® oneAPI Math Kernel Library for C
?hetrs_aa
B Solves a system of linear equations A * X = with a complex Hermitian matrix.
Syntax
LAPACK_DECLlapack_intLAPACKE_chetrs_aa ( intmatrix_layout , charuplo , lapack_intn , lapack_intnrhs , constlapack_complex_float*a , lapack_intlda , constlapack_int*ipiv , lapack_complex_float*b , lapack_intldb );
LAPACK_DECLlapack_intLAPACKE_zhetrs_aa ( intmatrix_layout , charuplo , lapack_intn , lapack_intnrhs , constlapack_complex_double*a , lapack_intlda , constlapack_int*ipiv , lapack_complex_double*b , lapack_intldb );
Description
?hetrs_aa solves a system of linear equations A * X = X with a complex Hermitian matrix A using the factorization A = U * T * UH or A = L * T * LH 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 * UH . If uplo = ‘L’: Lower triangular of the form A = L * T * LH .
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
-
COMPLEX for chetrs_aa COMPLEX*16 for zhetrs_aa
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
-
COMPLEX for chetrs_aa COMPLEX*16 for zhetrs_aa
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_DECLlapack_intLAPACKE_chetrs_aa_work ( intmatrix_layout , charuplo , lapack_intn , lapack_intnrhs , constlapack_complex_float*a , lapack_intlda , constlapack_int*ipiv , lapack_complex_float*b , lapack_intldb , lapack_complex_float*work , lapack_intlwork );
LAPACK_DECLlapack_intLAPACKE_zhetrs_aa_work ( intmatrix_layout , charuplo , lapack_intn , lapack_intnrhs , constlapack_complex_double*a , lapack_intlda , constlapack_int*ipiv , lapack_complex_double*b , lapack_intldb , lapack_complex_double*work , lapack_intlwork );