getri_batch (Out-of-place, USM Strided Version)¶
Computes the batch of inverses of an LU-factored general matrices
determined by getrf_batch
(USM stride version) function. This routine
belongs to the oneapi::mkl::lapack
namespace.
Description¶
The routine computes the inverses A
i-1 of a general
matrices A
i. Before calling this routine, call
getrf_batch (USM Strided Version) function
to factorize A
i.
API¶
Syntax¶
namespace oneapi::mkl::lapack {
sycl::event getri_batch(sycl::queue &queue,
std::int64_t n,
T *a,
std::int64_t lda,
std::int64_t stride_a,
std::int64_t *ipiv,
std::int64_t stride_ipiv,
T* ainv,
std::int64_t ldainv,
std::int64_t stride_ainv,
std::int64_t batch_size,
T *scratchpad,
std::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.
- n
The order of the matrices
A
i (0 ≤ n
).- a
Result of the getrf_batch (USM Strided Version) function
- lda
The leading dimension of
A
i (lda ≥ n
).- stride_a
The stride between the beginnings of matrices
A
i inside the batch arraya
.- ipiv
The array as returned by getrf_batch (USM Strided Version).
- stride_ipiv
The stride between the beginnings of arrays
ipiv
i inside the arrayipiv
.- ldainv
The leading dimension of
Ainv
i (n ≤ ldainv
).- stride_ainv
The stride between the beginnings of matrices
Ainv
i inside the batch arrayainv
.- batch_size
The number of problems in a batch.
- 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 than the value returned by the out-of-place, stride version of getri_batch_scratchpad_size (Strided Version) function.- events
List of events to wait for before starting computation. Defaults to empty list.
Output Parameters¶
- ainv
Overwritten by the n-by-n matrices
A
i-1.
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: If If |
Return Values¶
Output event to wait on to ensure computation is complete.