Developer Reference

  • 098
  • 03/30/2020
  • Public Content
Contents

mkl_sparse_sp2m

Computes the product of two sparse matrices. The result is stored in a newly allocated sparse matrix.

Syntax

stat = mkl_sparse_sp2m
(
opA
,
descrA
,
A
,
opB
,
descrB
,
B
,
request
,
C
)
Include Files
  • mkl_spblas.f90
Description
The
mkl_sparse_sp2m
routine performs a matrix-matrix operation:
C
:= op
A
(
A
) *op
B
(
B
)
where
A
,
B
, and
C
are sparse matrices,
opA
and
opB
are matrix modifiers for matrices
A
and
B
, respectively.
Input Parameters
opA
C_INT
.
Specifies operation on input matrix.
SPARSE_OPERATION_NON_TRANSPOSE
Non-transpose, op(
A
)=
A
SPARSE_OPERATION_TRANSPOSE
Transpose, op(
A
)=
A
T
SPARSE_OPERATION_CONJUGATE_TRANSPOSE
Conjugate transpose, op(
A
)=
A
H
opB
C_INT
.
Specifies operation on input matrix.
SPARSE_OPERATION_NON_TRANSPOSE
Non-transpose, op(
B
)=
B
SPARSE_OPERATION_TRANSPOSE
Transpose, op(
B
)=
B
T
SPARSE_OPERATION_CONJUGATE_TRANSPOSE
Conjugate transpose, op(
B
)=
B
H
descrA
MATRIX_DESCR
.
Structure that specifies sparse matrix properties.
Currently, only SPARSE_MATRIX_TYPE_GENERAL is supported.
sparse_matrix_type_t
type
specifies the type of sparse matrix.
SPARSE_MATRIX_TYPE_GENERAL
The matrix is processed as is.
SPARSE_MATRIX_TYPE_SYMMETRIC
The matrix is symmetric (only the requested triangle is processed).
SPARSE_MATRIX_TYPE_HERMITIAN
The matrix is Hermitian (only the requested triangle is processed).
SPARSE_MATRIX_TYPE_TRIANGULAR
The matrix is triangular (only the requested triangle is processed).
SPARSE_MATRIX_TYPE_DIAGONAL
The matrix is diagonal (only diagonal elements are processed).
SPARSE_MATRIX_TYPE_BLOCK_TRIANGULAR
The matrix is block-triangular (only the requested triangle is processed). This applies to BSR format only.
SPARSE_MATRIX_TYPE_BLOCK_DIAGONAL
The matrix is block-diagonal (only the requested triangle is processed). This applies to BSR format only.
sparse_fill_mode_t
mode
specifies the triangular matrix portion for symmetric, Hermitian, triangular, and block-triangular matrices.
SPARSE_FILL_MODE_LOWER
The lower triangular matrix is processed.
SPARSE_FILL_MODE_UPPER
The upper triangular matrix is processed.
sparse_diag_type_t
diag
specifies the type of diagonal for non-general matrices.
SPARSE_DIAG_NON_UNIT
Diagonal elements must not be equal to 1.
SPARSE_DIAG_UNIT
Diagonal elements are equal to 1.
descrB
C_INT
.
Structure that specifies sparse matrix properties.
Currently, only SPARSE_MATRIX_TYPE_GENERAL is supported.
sparse_matrix_type_t
type
specifies the type of sparse matrix.
SPARSE_MATRIX_TYPE_GENERAL
The matrix is processed as is.
SPARSE_MATRIX_TYPE_SYMMETRIC
The matrix is symmetric (only the requested triangle is processed).
SPARSE_MATRIX_TYPE_HERMITIAN
The matrix is Hermitian (only the requested triangle is processed).
SPARSE_MATRIX_TYPE_TRIANGULAR
The matrix is triangular (only the requested triangle is processed).
SPARSE_MATRIX_TYPE_DIAGONAL
The matrix is diagonal (only diagonal elements are processed).
SPARSE_MATRIX_TYPE_BLOCK_TRIANGULAR
The matrix is block-triangular (only the requested triangle is processed). This applies to BSR format only.
SPARSE_MATRIX_TYPE_BLOCK_DIAGONAL
The matrix is block-diagonal (only the requested triangle is processed). This applies to BSR format only.