getri (USM Version)¶
Computes the inverse of an LU-factored general matrix determined by
getrf (USM Version). This routine belongs to the
oneapi::mkl::lapack namespace.
Description¶
The routine computes the inverse inv(A) of a general matrix
A. Before calling this routine, call getrf (USM Version) to
factorize A.
API¶
Syntax¶
namespace oneapi::mkl::lapack {
cl::sycl::event getri(cl::sycl::queue &queue,
std::int64_t n,
T *a,
std::int64_t lda,
std::int64_t *ipiv,
T *scratchpad,
std::int64_t scratchpad_size,
const std::vector<cl::sycl::event> &events = {})
}
getri (USM version) 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 |
Input Parameters¶
- queue
Device queue where calculations will be performed.
- n
The order of the matrix
A(0≤n).- a
The pointer returned by getrf (USM Version). Must be of size at least
lda*max(1,n).- lda
The leading dimension of a
(n≤lda).- ipiv
The array as returned by getrf (USM Version). The dimension of ipiv must be at least
max(1, n).- scratchpad
Pointer to scratchpad memory to be used by the 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 getri_scratchpad_size function.- events
List of events to wait for before starting computation. Defaults to empty list.
Output Parameters¶
- a
Overwritten by the n-by-n matrix
inv(A).
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.