getrsnp_batch (USM Strided Version)#
Solves a system of linear equations with a batch of LU-factored square
coefficient matrices, with multiple right-hand sides. This routine
belongs to the oneapi::mkl::lapack namespace.
Description#
The routine solves for Xi the following systems of
linear equations:
Ai *Xi =Bi Iftrans = mkl::transpose::notransAiT *Xi =Bi Iftrans = mkl::transpose::transAiH *Xi =Bi Iftrans = mkl::transpose::conjtrans
Before calling this routine you must call getrfnp_batch (USM Strided Version) (without pivoting) to compute the LU factorization of A i.
API#
Syntax#
namespace oneapi::mkl::lapack {
sycl::event getrsnp_batch(sycl::queue &queue,
mkl::transpose trans,
int64_t n,
int64_t nrhs,
const T *a,
int64_t lda,
int64_t stride_a,
T *b,
int64_t ldb,
int64_t stride_b,
int64_t batch_size,
T *scratchpad,
int64_t scratchpad_size,
const std::vector<sycl::event> &events = {})
}
This function supports the following precisions and devices:
T |
Devices supported |
|---|---|
|
CPU and GPU |
|
CPU and GPU |
|
CPU and GPU |
|
CPU and GPU |
Input Parameters#
- queue
Device queue where calculations will be performed.
- trans
Indicates the form of the equations:
If trans = mkl::transpose::nontrans, then
Ai*Xi =Bi is solved forXi.If trans = mkl::transpose::trans, then
AiT*Xi =Bi is solved forXi.If trans = mkl::transpose::conjtrans, then
AiH*Xi =Bi is solved forXi.- n
The order of the matrices
Ai and the number of rows in matricesBi (n ≥ 0).- nrhs
The number of right hand sides
(nrhs ≥ 0).- a
Array containing the factorizations of the matrices
Ai, as returned by getrf_batch (USM Strided Version).- lda
The leading dimension of
Ai (lda≥max(1, n)).- stride_a
The stride between the beginnings of matrices
Ai inside the batch arraya(stride_a≥max(1, lda * n)).- b
The array containing the matrices
Bi whose columns are the right-hand sides for the systems of equations.- ldb
The leading dimensions of
Bi (ldb≥max(1, n)).- stride_b
The stride between the beginnings of matrices
Bi inside the batch arrayb(stride_b≥max(1, ldb * nrhs)).- batch_size
The number of problems in a batch (
batch_size≥ 0).- scratchpad
Scratchpad memory to be used by routine for storing intermediate results.
- scratchpad_size
Size of scratchpad memory as a number of floating point elements of type T. Size should not be less then the value returned by stride version of getrsnp_batch_scratchpad_size (Strided Version) function.
- events
List of events to wait for before starting computation. Defaults to empty list.
Output Parameters#
- b
Overwritten by the solution matrices
Xi.
Exceptions#
Exception |
Description |
|---|---|
|
This exception is thrown when problems occur during calculations. You can obtain the info code of the problem using the info() method of the exception object:
|
Return Values#
Output event to wait on to ensure computation is complete.