Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
?hetrs_aa
B Solves a system of linear equations A * X = with a complex Hermitian matrix.
Syntax
call chetrs_aa(uplo, n, nrhs, a, lda, ipiv, b, ldb, work, lwork, info)
call zhetrs_aa(uplo, n, nrhs, a, lda, ipiv, b, ldb, work, lwork, info)
Description
?hetrs_aa solves a system of linear equations \(A * X = B\) 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
uplo
CHARACTER*1 . 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
-
INTEGER. Specifies the order of the matrix A. The value of n must be at least zero.
nrhs
INTEGER . 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
INTEGER . The leading dimension of the array a . lda ≥ max(1, n ).
ipiv
INTEGER . 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
INTEGER . The leading dimension of the array b . ldb ≥ max(1, n ).
work
DOUBLE . Array of size (max(1, lwork )).
lwork
INTEGER . lwork ≥ max(1, 3* n -2).
Output Parameters
- b
-
On exit, the solution matrix X .
info
INTEGER .
If info = 0: successful exit.
If info < 0: if info = - i , the i -th argument had an illegal value.
Return Values
No return value, info is an Output Parameter.
Syntax - Workspace
Use this interface if you want to explicitly provide the workspace array.