oneapi::mkl::sparse::optimize_gemv
Performs internal optimizations for oneapi::mkl::sparse::gemv by
analyzing the matrix structure.
Description
Refer to Exceptions for a detailed description of the exceptions thrown.
The
oneapi::mkl::sparse::optimize_gemv
routine analyzes matrix structure and performs optimizations. Optimized
data is then stored in the matrix handle.API
Syntax
Currently, complex types are not supported.
Using SYCL buffers:
namespace oneapi::mkl::sparse {
void optimize_gemv (
cl::sycl::queue &queue,
oneapi::mkl::transpose transpose_flag,
oneapi::mkl::sparse::matrix_handle_t handle)
}
Using USM pointers:
Currently, the USM API might be a blocking call.
namespace oneapi::mkl::sparse {
cl::sycl::event optimize_gemv (
cl::sycl::queue &queue,
oneapi::mkl::transpose transpose_flag,
oneapi::mkl::sparse::matrix_handle_t handle,
const std::vector<cl::sycl::event> &dependencies)
}
Include Files
- oneapi/mkl/spblas.hpp
Input Parameters
- queue
- Specifies the SYCL command queue which will be used for SYCL kernels execution.
- transpose_flag
- Specifies operationop()on input matrix.oneapi::mkl::transpose::nontransNon-transpose,op(A)=A.oneapi::mkl::transpose::transTranspose,op(A)=AT.oneapi::mkl::transpose::conjtransConjugate transpose,op(A)=AH.Currently, the only supported case for operation isoneapi::mkl::transpose::nontrans.
- handle
- Handle to object containing sparse matrix and other internal data. Created using one of theoneapi::mkl::sparse::set_<sparse_matrix_type>_dataroutines.Currently, the only supported case for<sparse_matrix_type>is csr.
- dependencies
- A vector of typestd::vector<cl::sycl::event>containing the list of events that theoneapi::mkl::sparse::optimize_gemvroutine depends on.
Return Values (USM Only)
- cl::sycl::event
- SYCL event which can be waited upon or added as a dependency for the completion of theoptimize_gemvroutine.