getri_batch (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.
Syntax
namespace oneapi::mkl::lapack {
cl::sycl::event getri_batch(cl::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, std::int64_t batch_size, T *scratchpad, std::int64_t scratchpad_size, const cl::sycl::vector_class<cl::sycl::event> &events = {})
}
Function supports the following precisions and devices.
T |
Devices supported |
---|---|
|
Host, CPU, and GPU |
|
Host, CPU, and GPU |
|
Host, CPU, and GPU |
|
Host, CPU, and GPU |
Description
The routine computes the inverses A
1-1 of a general
matrices A
1. Before calling this routine, call
getrf_batch (USM Strided
Version) function
to factorize A
1.
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 (n
≤lda
).- 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
.- batch_size
Specifies 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 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
- a
Overwritten by the n-by-n matrices
A
i-1.
Exceptions
mkl::lapack::batch_exception |
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 |
Return Values
Output event to wait on to ensure computation is complete.