Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
mkl_sparse_?_spmmd
Computes the product of two sparse matrices and stores the result as a dense matrix.
Syntax
stat = mkl_sparse_s_spmmd ( op, A, B, layout, C, ldc )
stat = mkl_sparse_d_spmmd ( op, A, B, layout, C, ldc )
stat = mkl_sparse_c_spmmd ( op, A, B, layout, C, ldc )
stat = mkl_sparse_z_spmmd ( op, A, B, layout, C, ldc )
Include Files
mkl_spblas.f90
Description
The mkl_sparse_?_spmmd routine performs a matrix-matrix operation:
\[C \leftarrow op(A)\cdot B\]
where \(A\) and \(B\) are sparse matrices, \(op()\) is a matrix modifier for matrix \(A\) , and \(C\) is a dense matrix.
( SPARSE_INDEX_BASE_ZERO, SPARSE_LAYOUT_ROW_MAJOR )
( SPARSE_INDEX_BASE_ONE, SPARSE_LAYOUT_COLUMN_MAJOR )
Input Parameters
op
C_INT.
Specifies operation on input matrix \(A\).
op |
Description |
|---|---|
SPARSE_OPERATION_NON_TRANSPOSE |
\(op(A) = A\) |
SPARSE_OPERATION_TRANSPOSE |
\(op(A) = A^{T}\) |
SPARSE_OPERATION_CONJUGATE_TRANSPOSE |
\(op(A) = A^{H}\) |
A
SPARSE_MATRIX_T.
Handle which contains the sparse matrix \(A\) .
B
SPARSE_MATRIX_T.
Handle which contains the sparse matrix \(B\) .
layout
C_INT .
Describes the storage scheme for the dense matrix \(C\):
SPARSE_LAYOUT_COLUMN_MAJOR |
Storage of elements uses column major layout. |
SPARSE_LAYOUT_ROW_MAJOR |
Storage of elements uses row major layout. |
ldc
C_INT .
Leading dimension of matrix \(C\) .
Output Parameters
C
C_FLOAT |
for mkl_sparse_s_spmmd |
C_DOUBLE |
for mkl_sparse_d_spmmd |
C_FLOAT_COMPLEX |
for mkl_sparse_c_spmmd |
C_DOUBLE_COMPLEX |
for mkl_sparse_z_spmmd |
The resulting dense matrix.
stat
INTEGER
Value indicating whether the operation was successful, and if not, why:
SPARSE_STATUS_SUCCESS |
The operation was successful. |
SPARSE_STATUS_NOT_INITIALIZED |
The routine encountered an empty handle or matrix array. |
SPARSE_STATUS_ALLOC_FAILED |
Internal memory allocation failed. |
SPARSE_STATUS_INVALID_VALUE |
The input parameters contain an invalid value. |
SPARSE_STATUS_EXECUTION_FAILED |
Execution failed. |
SPARSE_STATUS_INTERNAL_ERROR |
An error in algorithm implementation occurred. |
SPARSE_STATUS_NOT_SUPPORTED |
The requested operation is not supported. |
Return Values
See Output Parameter stat.