Utility Functions

This module holds all sparse utility routines.

The sparse utility routines allow for testing whether matrix data is valid for different matrix formats

The routines in this module do not support execution in a hipGraph context.

rocsparse_check_matrix_csr_buffer_size()

rocsparse_status rocsparse_scheck_matrix_csr_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const float *csr_val, const rocsparse_int *csr_row_ptr, const rocsparse_int *csr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_dcheck_matrix_csr_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const double *csr_val, const rocsparse_int *csr_row_ptr, const rocsparse_int *csr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_ccheck_matrix_csr_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_float_complex *csr_val, const rocsparse_int *csr_row_ptr, const rocsparse_int *csr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_zcheck_matrix_csr_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_double_complex *csr_val, const rocsparse_int *csr_row_ptr, const rocsparse_int *csr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

Check matrix to see if it is valid.

rocsparse_check_matrix_csr_buffer_size computes the required buffer size needed when calling rocsparse_check_matrix_csr

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• m – [in] number of rows of the sparse CSR matrix.

• n – [in] number of columns of the sparse CSR matrix.

• nnz – [in] number of non-zero entries of the sparse CSR matrix.

• csr_val – [in] array of nnz elements of the sparse CSR matrix.

• csr_row_ptr – [in] array of m+1 elements that point to the start of every row of the sparse CSR matrix.

• csr_col_ind – [in] array of nnz elements containing the column indices of the sparse CSR matrix.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• buffer_size – [out] number of bytes of the temporary storage buffer required by rocsparse_scheck_matrix_csr(), rocsparse_dcheck_matrix_csr(), rocsparse_ccheck_matrix_csr() and rocsparse_zcheck_matrix_csr().

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – m n or nnz is invalid.

• rocsparse_status_invalid_pointer – csr_val, csr_row_ptr, csr_col_ind or buffer_size pointer is invalid.

rocsparse_check_matrix_csr()

rocsparse_status rocsparse_scheck_matrix_csr(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const float *csr_val, const rocsparse_int *csr_row_ptr, const rocsparse_int *csr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_dcheck_matrix_csr(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const double *csr_val, const rocsparse_int *csr_row_ptr, const rocsparse_int *csr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_ccheck_matrix_csr(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_float_complex *csr_val, const rocsparse_int *csr_row_ptr, const rocsparse_int *csr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_zcheck_matrix_csr(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_double_complex *csr_val, const rocsparse_int *csr_row_ptr, const rocsparse_int *csr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

Check matrix to see if it is valid.

rocsparse_check_matrix_csr checks if the input CSR matrix is valid.

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• m – [in] number of rows of the sparse CSR matrix.

• n – [in] number of columns of the sparse CSR matrix.

• nnz – [in] number of non-zero entries of the sparse CSR matrix.

• csr_val – [in] array of nnz elements of the sparse CSR matrix.

• csr_row_ptr – [in] array of m+1 elements that point to the start of every row of the sparse CSR matrix.

• csr_col_ind – [in] array of nnz elements containing the column indices of the sparse CSR matrix.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• data_status – [out] modified to indicate the status of the data

• temp_buffer – [in] temporary storage buffer allocated by the user.

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – m n or nnz is invalid.

• rocsparse_status_invalid_pointer – csr_val, csr_row_ptr, csr_col_ind, temp_buffer or data_status pointer is invalid.

rocsparse_check_matrix_csc_buffer_size()

rocsparse_status rocsparse_scheck_matrix_csc_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const float *csc_val, const rocsparse_int *csc_col_ptr, const rocsparse_int *csc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_dcheck_matrix_csc_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const double *csc_val, const rocsparse_int *csc_col_ptr, const rocsparse_int *csc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_ccheck_matrix_csc_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_float_complex *csc_val, const rocsparse_int *csc_col_ptr, const rocsparse_int *csc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_zcheck_matrix_csc_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_double_complex *csc_val, const rocsparse_int *csc_col_ptr, const rocsparse_int *csc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

Check matrix to see if it is valid.

rocsparse_check_matrix_csc_buffer_size computes the required buffer size needed when calling rocsparse_check_matrix_csc

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• m – [in] number of rows of the sparse CSC matrix.

• n – [in] number of columns of the sparse CSC matrix.

• nnz – [in] number of non-zero entries of the sparse CSC matrix.

• csc_val – [in] array of nnz elements of the sparse CSC matrix.

• csc_col_ptr – [in] array of m+1 elements that point to the start of every column of the sparse CSC matrix.

• csc_row_ind – [in] array of nnz elements containing the row indices of the sparse CSC matrix.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• buffer_size – [out] number of bytes of the temporary storage buffer required by rocsparse_scheck_matrix_csc(), rocsparse_dcheck_matrix_csc(), rocsparse_ccheck_matrix_csc() and rocsparse_zcheck_matrix_csc().

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – m n or nnz is invalid.

• rocsparse_status_invalid_pointer – csc_val, csc_col_ptr, csc_row_ind or buffer_size pointer is invalid.

rocsparse_check_matrix_csc()

rocsparse_status rocsparse_scheck_matrix_csc(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const float *csc_val, const rocsparse_int *csc_col_ptr, const rocsparse_int *csc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_dcheck_matrix_csc(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const double *csc_val, const rocsparse_int *csc_col_ptr, const rocsparse_int *csc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_ccheck_matrix_csc(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_float_complex *csc_val, const rocsparse_int *csc_col_ptr, const rocsparse_int *csc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_zcheck_matrix_csc(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_double_complex *csc_val, const rocsparse_int *csc_col_ptr, const rocsparse_int *csc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

Check matrix to see if it is valid.

rocsparse_check_matrix_csc checks if the input CSC matrix is valid.

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• m – [in] number of rows of the sparse CSC matrix.

• n – [in] number of columns of the sparse CSC matrix.

• nnz – [in] number of non-zero entries of the sparse CSC matrix.

• csc_val – [in] array of nnz elements of the sparse CSC matrix.

• csc_col_ptr – [in] array of m+1 elements that point to the start of every column of the sparse CSC matrix.

• csc_row_ind – [in] array of nnz elements containing the row indices of the sparse CSC matrix.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• data_status – [out] modified to indicate the status of the data

• temp_buffer – [in] temporary storage buffer allocated by the user.

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – m n or nnz is invalid.

• rocsparse_status_invalid_pointer – csc_val, csc_col_ptr, csc_row_ind, temp_buffer or data_status pointer is invalid.

rocsparse_check_matrix_coo_buffer_size()

rocsparse_status rocsparse_scheck_matrix_coo_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const float *coo_val, const rocsparse_int *coo_row_ind, const rocsparse_int *coo_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_dcheck_matrix_coo_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const double *coo_val, const rocsparse_int *coo_row_ind, const rocsparse_int *coo_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_ccheck_matrix_coo_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_float_complex *coo_val, const rocsparse_int *coo_row_ind, const rocsparse_int *coo_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_zcheck_matrix_coo_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_double_complex *coo_val, const rocsparse_int *coo_row_ind, const rocsparse_int *coo_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

Check matrix to see if it is valid.

rocsparse_check_matrix_coo_buffer_size computes the required buffer size needed when calling rocsparse_check_matrix_coo

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• m – [in] number of rows of the sparse CSR matrix.

• n – [in] number of columns of the sparse CSR matrix.

• nnz – [in] number of non-zero entries of the sparse CSR matrix.

• coo_val – [in] array of nnz elements of the sparse COO matrix.

• coo_row_ind – [in] array of nnz elements containing the row indices of the sparse COO matrix.

• coo_col_ind – [in] array of nnz elements containing the column indices of the sparse COO matrix.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• buffer_size – [out] number of bytes of the temporary storage buffer required by rocsparse_scheck_matrix_coo(), rocsparse_dcheck_matrix_coo(), rocsparse_ccheck_matrix_coo() and rocsparse_zcheck_matrix_coo().

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – m n or nnz is invalid.

• rocsparse_status_invalid_pointer – coo_val, coo_row_ind, coo_col_ind or buffer_size pointer is invalid.

rocsparse_check_matrix_coo()

rocsparse_status rocsparse_scheck_matrix_coo(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const float *coo_val, const rocsparse_int *coo_row_ind, const rocsparse_int *coo_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_dcheck_matrix_coo(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const double *coo_val, const rocsparse_int *coo_row_ind, const rocsparse_int *coo_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_ccheck_matrix_coo(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_float_complex *coo_val, const rocsparse_int *coo_row_ind, const rocsparse_int *coo_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_zcheck_matrix_coo(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int nnz, const rocsparse_double_complex *coo_val, const rocsparse_int *coo_row_ind, const rocsparse_int *coo_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

Check matrix to see if it is valid.

rocsparse_check_matrix_coo checks if the input COO matrix is valid.

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• m – [in] number of rows of the sparse COO matrix.

• n – [in] number of columns of the sparse COO matrix.

• nnz – [in] number of non-zero entries of the sparse COO matrix.

• coo_val – [in] array of nnz elements of the sparse COO matrix.

• coo_row_ind – [in] array of nnz elements containing the row indices of the sparse COO matrix.

• coo_col_ind – [in] array of nnz elements containing the column indices of the sparse COO matrix.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• data_status – [out] modified to indicate the status of the data

• temp_buffer – [in] temporary storage buffer allocated by the user.

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – m n or nnz is invalid.

• rocsparse_status_invalid_pointer – coo_val, coo_row_ind, coo_col_ind, temp_buffer or data_status pointer is invalid.

rocsparse_check_matrix_gebsr_buffer_size()

rocsparse_status rocsparse_scheck_matrix_gebsr_buffer_size(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const float *bsr_val, const rocsparse_int *bsr_row_ptr, const rocsparse_int *bsr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_dcheck_matrix_gebsr_buffer_size(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const double *bsr_val, const rocsparse_int *bsr_row_ptr, const rocsparse_int *bsr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_ccheck_matrix_gebsr_buffer_size(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const rocsparse_float_complex *bsr_val, const rocsparse_int *bsr_row_ptr, const rocsparse_int *bsr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_zcheck_matrix_gebsr_buffer_size(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const rocsparse_double_complex *bsr_val, const rocsparse_int *bsr_row_ptr, const rocsparse_int *bsr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

Check matrix to see if it is valid.

rocsparse_check_matrix_gebsr_buffer_size computes the required buffer size needed when calling rocsparse_check_matrix_gebsr

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• dir – [in] matrix storage of GEBSR blocks.

• mb – [in] number of block rows of the sparse GEBSR matrix.

• nb – [in] number of block columns of the sparse GEBSR matrix.

• nnzb – [in] number of non-zero blocks of the sparse GEBSR matrix.

• row_block_dim – [in] row block dimension of the sparse GEBSR matrix.

• col_block_dim – [in] column block dimension of the sparse GEBSR matrix.

• bsr_val – [in] array of nnzb elements of the sparse GEBSR matrix.

• bsr_row_ptr – [in] array of mb+1 elements that point to the start of every row of the sparse GEBSR matrix.

• bsr_col_ind – [in] array of nnzb elements containing the column indices of the sparse GEBSR matrix.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• buffer_size – [out] number of bytes of the temporary storage buffer required by rocsparse_scheck_matrix_gebsr(), rocsparse_dcheck_matrix_gebsr(), rocsparse_ccheck_matrix_gebsr() and rocsparse_zcheck_matrix_gebsr().

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – dir or idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – mb nb nnzb row_block_dim or col_block_dim is invalid.

• rocsparse_status_invalid_pointer – bsr_val, bsr_row_ptr, bsr_col_ind or buffer_size pointer is invalid.

rocsparse_check_matrix_gebsr()

rocsparse_status rocsparse_scheck_matrix_gebsr(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const float *bsr_val, const rocsparse_int *bsr_row_ptr, const rocsparse_int *bsr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_dcheck_matrix_gebsr(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const double *bsr_val, const rocsparse_int *bsr_row_ptr, const rocsparse_int *bsr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_ccheck_matrix_gebsr(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const rocsparse_float_complex *bsr_val, const rocsparse_int *bsr_row_ptr, const rocsparse_int *bsr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_zcheck_matrix_gebsr(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const rocsparse_double_complex *bsr_val, const rocsparse_int *bsr_row_ptr, const rocsparse_int *bsr_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

Check matrix to see if it is valid.

rocsparse_check_matrix_gebsr checks if the input GEBSR matrix is valid.

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• dir – [in] matrix storage of GEBSR blocks.

• mb – [in] number of block rows of the sparse GEBSR matrix.

• nb – [in] number of block columns of the sparse GEBSR matrix.

• nnzb – [in] number of non-zero blocks of the sparse GEBSR matrix.

• row_block_dim – [in] row block dimension of the sparse GEBSR matrix.

• col_block_dim – [in] column block dimension of the sparse GEBSR matrix.

• bsr_val – [in] array of nnzb elements of the sparse GEBSR matrix.

• bsr_row_ptr – [in] array of mb+1 elements that point to the start of every row of the sparse GEBSR matrix.

• bsr_col_ind – [in] array of nnzb elements containing the column indices of the sparse GEBSR matrix.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• data_status – [out] modified to indicate the status of the data

• temp_buffer – [in] temporary storage buffer allocated by the user.

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – dir or idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – mb nb nnzb row_block_dim or col_block_dim is invalid.

• rocsparse_status_invalid_pointer – bsr_val, bsr_row_ptr, bsr_col_ind, temp_buffer or data_status pointer is invalid.

rocsparse_check_matrix_gebsc_buffer_size()

rocsparse_status rocsparse_scheck_matrix_gebsc_buffer_size(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const float *bsc_val, const rocsparse_int *bsc_col_ptr, const rocsparse_int *bsc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_dcheck_matrix_gebsc_buffer_size(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const double *bsc_val, const rocsparse_int *bsc_col_ptr, const rocsparse_int *bsc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_ccheck_matrix_gebsc_buffer_size(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const rocsparse_float_complex *bsc_val, const rocsparse_int *bsc_col_ptr, const rocsparse_int *bsc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_zcheck_matrix_gebsc_buffer_size(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const rocsparse_double_complex *bsc_val, const rocsparse_int *bsc_col_ptr, const rocsparse_int *bsc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

Check matrix to see if it is valid.

rocsparse_check_matrix_gebsc_buffer_size computes the required buffer size needed when calling rocsparse_check_matrix_gebsc

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• dir – [in] matrix storage of GEBSC blocks.

• mb – [in] number of block rows of the sparse GEBSC matrix.

• nb – [in] number of block columns of the sparse GEBSC matrix.

• nnzb – [in] number of non-zero blocks of the sparse GEBSC matrix.

• row_block_dim – [in] row block dimension of the sparse GEBSC matrix.

• col_block_dim – [in] column block dimension of the sparse GEBSC matrix.

• bsc_val – [in] array of nnzb elements of the sparse GEBSC matrix.

• bsc_col_ptr – [in] array of nb+1 elements that point to the start of every column of the sparse GEBSC matrix.

• bsc_row_ind – [in] array of nnzb elements containing the row indices of the sparse GEBSC matrix.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• buffer_size – [out] number of bytes of the temporary storage buffer required by rocsparse_scheck_matrix_gebsc(), rocsparse_dcheck_matrix_gebsc(), rocsparse_ccheck_matrix_gebsc() and rocsparse_zcheck_matrix_gebsc().

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – dir or idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – mb nb nnzb row_block_dim or col_block_dim is invalid.

• rocsparse_status_invalid_pointer – bsc_val, bsc_col_ptr, bsc_row_ind or buffer_size pointer is invalid.

rocsparse_check_matrix_gebsc()

rocsparse_status rocsparse_scheck_matrix_gebsc(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const float *bsc_val, const rocsparse_int *bsc_col_ptr, const rocsparse_int *bsc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_dcheck_matrix_gebsc(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const double *bsc_val, const rocsparse_int *bsc_col_ptr, const rocsparse_int *bsc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_ccheck_matrix_gebsc(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const rocsparse_float_complex *bsc_val, const rocsparse_int *bsc_col_ptr, const rocsparse_int *bsc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_zcheck_matrix_gebsc(rocsparse_handle handle, rocsparse_direction dir, rocsparse_int mb, rocsparse_int nb, rocsparse_int nnzb, rocsparse_int row_block_dim, rocsparse_int col_block_dim, const rocsparse_double_complex *bsc_val, const rocsparse_int *bsc_col_ptr, const rocsparse_int *bsc_row_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

Check matrix to see if it is valid.

rocsparse_check_matrix_gebsc checks if the input GEBSC matrix is valid.

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• dir – [in] matrix storage of GEBSC blocks.

• mb – [in] number of block rows of the sparse GEBSC matrix.

• nb – [in] number of block columns of the sparse GEBSC matrix.

• nnzb – [in] number of non-zero blocks of the sparse GEBSC matrix.

• row_block_dim – [in] row block dimension of the sparse GEBSC matrix.

• col_block_dim – [in] column block dimension of the sparse GEBSC matrix.

• bsc_val – [in] array of nnzb elements of the sparse GEBSC matrix.

• bsc_col_ptr – [in] array of nb+1 elements that point to the start of every column of the sparse GEBSC matrix.

• bsc_row_ind – [in] array of nnzb elements containing the row indices of the sparse GEBSC matrix.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• data_status – [out] modified to indicate the status of the data

• temp_buffer – [in] temporary storage buffer allocated by the user.

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – dir or idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – mb nb nnzb row_block_dim or col_block_dim is invalid.

• rocsparse_status_invalid_pointer – bsc_val, bsc_col_ptr, bsc_row_ind, temp_buffer or data_status pointer is invalid.

rocsparse_check_matrix_ell_buffer_size()

rocsparse_status rocsparse_scheck_matrix_ell_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int ell_width, const float *ell_val, const rocsparse_int *ell_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_dcheck_matrix_ell_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int ell_width, const double *ell_val, const rocsparse_int *ell_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_ccheck_matrix_ell_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int ell_width, const rocsparse_float_complex *ell_val, const rocsparse_int *ell_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

rocsparse_status rocsparse_zcheck_matrix_ell_buffer_size(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int ell_width, const rocsparse_double_complex *ell_val, const rocsparse_int *ell_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

Check matrix to see if it is valid.

rocsparse_check_matrix_ell_buffer_size computes the required buffer size needed when calling rocsparse_check_matrix_ell

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• m – [in] number of rows of the sparse ELL matrix.

• n – [in] number of columns of the sparse ELL matrix.

• ell_width – [in] number of non-zero elements per row of the sparse ELL matrix.

• ell_val – [in] array that contains the elements of the sparse ELL matrix. Padded elements should be zero.

• ell_col_ind – [in] array that contains the column indices of the sparse ELL matrix. Padded column indices should be -1.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• buffer_size – [out] number of bytes of the temporary storage buffer required by rocsparse_scheck_matrix_ell(), rocsparse_dcheck_matrix_ell(), rocsparse_ccheck_matrix_ell() and rocsparse_zcheck_matrix_ell().

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – m n or ell_width is invalid.

• rocsparse_status_invalid_pointer – ell_val, ell_col_ind or buffer_size pointer is invalid.

rocsparse_check_matrix_ell()

rocsparse_status rocsparse_scheck_matrix_ell(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int ell_width, const float *ell_val, const rocsparse_int *ell_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_dcheck_matrix_ell(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int ell_width, const double *ell_val, const rocsparse_int *ell_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_ccheck_matrix_ell(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int ell_width, const rocsparse_float_complex *ell_val, const rocsparse_int *ell_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

rocsparse_status rocsparse_zcheck_matrix_ell(rocsparse_handle handle, rocsparse_int m, rocsparse_int n, rocsparse_int ell_width, const rocsparse_double_complex *ell_val, const rocsparse_int *ell_col_ind, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

Check matrix to see if it is valid.

rocsparse_check_matrix_ell checks if the input ELL matrix is valid.

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• m – [in] number of rows of the sparse ELL matrix.

• n – [in] number of columns of the sparse ELL matrix.

• ell_width – [in] number of non-zero elements per row of the sparse ELL matrix.

• ell_val – [in] array that contains the elements of the sparse ELL matrix. Padded elements should be zero.

• ell_col_ind – [in] array that contains the column indices of the sparse ELL matrix. Padded column indices should be -1.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• data_status – [out] modified to indicate the status of the data

• temp_buffer – [in] temporary storage buffer allocated by the user.

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_size – m n or ell_width is invalid.

• rocsparse_status_invalid_pointer – ell_val, ell_col_ind, temp_buffer or data_status pointer is invalid.

rocsparse_check_matrix_hyb_buffer_size()

rocsparse_status rocsparse_check_matrix_hyb_buffer_size(rocsparse_handle handle, const rocsparse_hyb_mat hyb, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, size_t *buffer_size)

Check matrix to see if it is valid.

rocsparse_check_matrix_hyb_buffer_size computes the required buffer size needed when calling rocsparse_check_matrix_hyb

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• hyb – [in] matrix in HYB storage format.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• buffer_size – [out] number of bytes of the temporary storage buffer required by rocsparse_check_matrix_hyb().

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_pointer – hyb or buffer_size pointer is invalid.

rocsparse_check_matrix_hyb()

rocsparse_status rocsparse_check_matrix_hyb(rocsparse_handle handle, const rocsparse_hyb_mat hyb, rocsparse_index_base idx_base, rocsparse_matrix_type matrix_type, rocsparse_fill_mode uplo, rocsparse_storage_mode storage, rocsparse_data_status *data_status, void *temp_buffer)

Check matrix to see if it is valid.

rocsparse_check_matrix_hyb checks if the input HYB matrix is valid.

Parameters:

• handle – [in] handle to the rocsparse library context queue.

• hyb – [in] matrix in HYB storage format.

• idx_base – [in] rocsparse_index_base_zero or rocsparse_index_base_one.

• matrix_type – [in] rocsparse_matrix_type_general, rocsparse_matrix_type_symmetric, rocsparse_matrix_type_hermitian or rocsparse_matrix_type_triangular.

• uplo – [in] rocsparse_fill_mode_lower or rocsparse_fill_mode_upper.

• storage – [in] rocsparse_storage_mode_sorted or rocsparse_storage_mode_sorted.

• data_status – [out] modified to indicate the status of the data

• temp_buffer – [in] temporary storage buffer allocated by the user.

Return values:

• rocsparse_status_success – the operation completed successfully.

• rocsparse_status_invalid_handle – the library context was not initialized.

• rocsparse_status_invalid_value – idx_base or matrix_type or uplo or storage is invalid.

• rocsparse_status_invalid_pointer – hyb or data_status pointer is invalid.