set_csr_data

Takes a matrix handle and the input CSR matrix arrays and fills the internal CSR data structure.

Description and Assumptions

Refer to Supported Types for a list of supported <fp> and <intType>. The 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.

set_csr_data (Buffer version)

Syntax

namespace oneapi::mkl::sparse {

   void set_csr_data (oneapi::mkl::sparse::matrix_handle_t  handle,
                      intType                               num_rows,
                      intType                               num_cols,
                      oneapi::mkl::index_base               index,
                      sycl::buffer<intType, 1>              &row_ptr,
                      sycl::buffer<intType, 1>              &col_ind,
                      sycl::buffer<fp, 1>                   &val);

}

Input Parameters

handle

Handle to object containing sparse matrix and other internal data for subsequent DPC++ 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. The possible options are described in index_base enum class.

row_ptr

SYCL memory object containing an array of length num_rows+1. Refer to CSR format for detailed description of row_ptr.

col_ind

SYCL memory object which stores an array containing the column indices in index-based numbering. Refer to CSR format for detailed description of col_ind.

val

SYCL memory object which stores an array containing non-zero elements of the input matrix. Refer to CSR format for detailed description of val.

Output Parameters

handle

Handle to object containing sparse matrix and other internal data for subsequent SYCL Sparse BLAS operations.

Throws

This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here.

oneapi::mkl::computation_error

oneapi::mkl::device_bad_alloc

oneapi::mkl::host_bad_alloc

oneapi::mkl::invalid_argument

oneapi::mkl::unimplemented

oneapi::mkl::uninitialized

oneapi::mkl::unsupported_device

set_csr_data (USM version)

Syntax

namespace oneapi::mkl::sparse {

   void set_csr_data (oneapi::mkl::sparse::matrix_handle_t  handle,
                      intType                               num_rows,
                      intType                               num_cols,
                      oneapi::mkl::index_base               index,
                      intType                               *row_ptr,
                      intType                               *col_ind,
                      fp                                    *val);

}

Input Parameters

handle

Handle to object containing sparse matrix and other internal data for subsequent DPC++ 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. The possible options are described in index_base enum class.

row_ptr

USM object containing an array of length num_rows+1. Refer to CSR format for detailed description of row_ptr

col_ind

USM object which stores an array containing the column indices in index-based numbering. Refer to CSR format for detailed description of col_ind

val

USM object which stores an array containing non-zero elements of the input matrix. Refer to CSR format for detailed description of val

Output Parameters

handle

Handle to object containing sparse matrix and other internal data for subsequent SYCL Sparse BLAS operations.

Throws

This routine shall throw the following exceptions if the associated condition is detected. An implementation may throw additional implementation-specific exception(s) in case of error conditions not covered here.

oneapi::mkl::computation_error

oneapi::mkl::device_bad_alloc

oneapi::mkl::host_bad_alloc

oneapi::mkl::invalid_argument

oneapi::mkl::unimplemented

oneapi::mkl::uninitialized

oneapi::mkl::unsupported_device

Parent topic: Sparse BLAS