Developer Reference

Contents

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::zero
Zero-based (C-style) indexing: indices start at 0.
oneapi::mkl::index_base::one
One-based (Fortran-style) indexing: indices start at 1.
row_ptr
SYCL memory object containing an array of length
num_rows+1
. Could be a SYCL buffer or a device-accessible USM pointer. Refer to Sparse Storage Formats for a detailed description of
row_ptr
.
col_ind
SYCL memory object which stores an array containing the column indices in
index
-based numbering. Could be a SYCL buffer or a device-accessible USM pointer. Refer to Sparse Storage Formats for a detailed description of
col_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 of
val
.
Output Parameters
handle
Handle to object containing sparse matrix and other internal data for subsequent DPC++ Sparse BLAS operations.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.