oneapi::mkl::sparse::set_csr_data
Takes a matrix handle and the input Compressed Sparse Row (CSR) matrix arrays and fills the
internal CSR data structure.
Description
The
oneapi::mkl::sparse::set_csr_data
routine takes a matrix handle
for a sparse matrix of dimensions num_rows
-by- num_cols
represented in the CSR format, and fills the internal CSR data
structure.
Refer to Supported Types for a list of supported
<fp>
and <intType>
, and refer to Exceptions for a detailed description of the exceptions thrown. API
Syntax
Currently, complex types are not supported.
Using SYCL buffers:
namespace oneapi::mkl:sparse {
void set_csr_data (
oneapi::mkl::sparse::matrix_handle_t handle,
const intType num_rows,
const intType num_cols,
oneapi::mkl::index_base index,
cl::sycl::buffer<intType, 1> &row_ptr,
cl::sycl::buffer<intType, 1> &col_ind,
cl::sycl::buffer<fp, 1> &val)
}
Using USM pointers:
namespace oneapi::mkl:sparse {
void set_csr_data (
oneapi::mkl::sparse::matrix_handle_t handle,
const intType num_rows,
const intType num_cols,
oneapi::mkl::index_base index,
intType *row_ptr,
intType *col_ind,
fp *val)
}
Include Files
- oneapi/mkl/spblas.hpp
Input Parameters
- handle
- Handle to object containing sparse matrix and other internal data for subsequent Sparse BLAS operations.
- num_rows
- Number of rows of the input matrix.
- num_cols
- Number of columns of the input matrix.
- index
- Indicates how input arrays are indexed.oneapi::mkl::index_base::zeroZero-based (C-style) indexing: indices start at 0.oneapi::mkl::index_base::oneOne-based (Fortran-style) indexing: indices start at 1.
- row_ptr
- SYCL memory object containing an array of lengthnum_rows+1. Could be a SYCL buffer or a device-accessible USM pointer. Refer to Sparse Storage Formats for a detailed description ofrow_ptr.
- col_ind
- SYCL memory object which stores an array containing the column indices inindex-based numbering. Could be a SYCL buffer or a device-accessible USM pointer. Refer to Sparse Storage Formats for a detailed description ofcol_ind.
- val
- SYCL memory object which stores an array containing the non-zero elements of the input matrix. Could be a SYCL buffer or a device-accessible USM pointer. Refer to Sparse Storage Formats for a detailed description ofval.
Output Parameters
- handle
- Handle to object containing sparse matrix and other internal data for subsequent DPC++ Sparse BLAS operations.