getri¶
Computes the inverse of an LU-factored general matrix determined by
getrf.This routine
belongs to the oneapi::mkl::lapacknamespace.
Syntax
-
void
getri(cl::sycl::queue &queue, std::int64_t n, cl::sycl::buffer<T> &a, std::int64_t lda, std::int64_t *ipiv, cl::sycl::buffer<T> &scratchpad, std::int64_t scratchpad_size)¶
getri 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 inverse inv(A) of a general matrix
A. Before calling this routine, call
getrf
to factorize A.
Input Parameters
- queue
Device queue where calculations will be performed.
- n
The order of the matrix
A(0≤n).- a
The buffer returned by getrf. 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. 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.
Output Parameters
- a
Overwritten by the n-by-n matrix
A.
Exceptions
mkl::lapack::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 |
Known Limitations
GPU support is for only real precisions.
For GPU support, errors are reportedthrough the info parameter, but computation does not halt for an algorithmic error.