Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 2021.1
  • 12/04/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

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.