Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 0.9
  • 09/09/2020
  • Public Content
Contents

?hetrs_aa

B
Solves 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
Array of size (max(1,
lwork
)).
lwork
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
);

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804