aoclsparse_convert_csr() - 5.2 English - 68552

AOCL API Guide (68552)

Document ID
68552
Release Date
2025-12-29
Version
5.2 English
aoclsparse_status aoclsparse_convert_csr(const aoclsparse_matrix src_mat, const aoclsparse_operation op, aoclsparse_matrix *dest_mat)#

Convert internal representation of matrix into a sparse CSR matrix.

aoclsparse_convert_csr converts any supported matrix format into a CSR format matrix and returns it as a new aoclsparse_matrix. The new matrix can also be transposed, or conjugated and transposed during the conversion. It should be freed by calling aoclsparse_destroy(). The source matrix needs to be initialized using e.g. aoclsparse_create_scoo(), aoclsparse_create_scsr(), aoclsparse_create_scsc() or any of their variants.

Parameters:
  • src_mat[in] source matrix used for conversion.

  • op[in] operation to be performed on destination matrix

  • dest_mat[out] destination matrix output in CSR Format of the src_mat.

Return values:
  • aoclsparse_status_success – the operation completed successfully

  • aoclsparse_status_invalid_size – matrix dimension are invalid

  • aoclsparse_status_invalid_valuesrc_mat contains invalid value type

  • aoclsparse_status_invalid_pointer – pointers in src_mat or dest_mat are invalid

  • aoclsparse_status_not_implemented – conversion of the src_mat format given is not implemented

  • aoclsparse_status_memory_error – memory allocation for destination matrix failed