Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
mkl_sparse_?_dotmv
Computes a sparse matrix-vector product followed by a dot product.
Syntax
stat = mkl_sparse_s_dotmv ( operation, alpha, A, descr, x, beta, y, d )
stat = mkl_sparse_d_dotmv ( operation, alpha, A, descr, x, beta, y, d )
stat = mkl_sparse_c_dotmv ( operation, alpha, A, descr, x, beta, y, d )
stat = mkl_sparse_z_dotmv ( operation, alpha, A, descr, x, beta, y, d )Include Files
mkl_spblas.f90
Description
The mkl_sparse_?_dotmv routine computes a sparse matrix-vector product and dot product:
\[y &\leftarrow \alpha\cdot op(A)\cdot x + \beta\cdot y \\ d &\leftarrow \sum_{i}x_{i}\cdot y_{i} \text{ (real case)} \\ d &\leftarrow \sum_{i}\text{conj}(x_{i})\cdot y_{i} \text{ (complex case)}\]
where \(\alpha\) and \(\beta\) are scalars. \(x\) and \(y\) are vectors. \(A\) is an \(m\) -by- \(k\) matrix. \(\text{conj}\) represents complex conjugation. \(op(A)\) is a matrix modifier.
Available options for \(op(A)\) are \(A\), \(A^{T}\), or \(A^{H}\).
( SPARSE_INDEX_BASE_ZERO, SPARSE_LAYOUT_ROW_MAJOR ) or
( SPARSE_INDEX_BASE_ONE, SPARSE_LAYOUT_COLUMN_MAJOR ).
Input Parameters
operation
C_INT .
Specifies operation op() on input matrix \(A\):
operation |
Description |
|---|---|
SPARSE_OPERATION_NON_TRANSPOSE |
\(op(A) = A\) |
SPARSE_OPERATION_TRANSPOSE |
\(op(A) = A^{T}\) |
SPARSE_OPERATION_CONJUGATE_TRANSPOSE |
\(op(A) = A^{H}\) |
alpha
C_FLOAT |
for mkl_sparse_s_dotmv |
C_DOUBLE |
for mkl_sparse_d_dotmv |
C_FLOAT_COMPLEX |
for mkl_sparse_c_dotmv |
C_DOUBLE_COMPLEX |
for mkl_sparse_z_dotmv |
Specifies the scalar, \(\alpha\) .
A
SPARSE_MATRIX_T.
Handle which contains the sparse matrix \(A\) .
descr
MATRIX_DESCR .
Descriptor specifying sparse matrix properties.
sparse_matrix_type_t type |
Specifies the type of a sparse matrix:
|
sparse_fill_mode_t mode |
Specifies the triangular matrix part for symmetric, Hermitian, triangular, and block-triangular matrices:
|
sparse_diag_type_t diag |
Specifies diagonal type for non-general matrices:
|
x
C_FLOAT |
for mkl_sparse_s_dotmv |
C_DOUBLE |
for mkl_sparse_d_dotmv |
C_FLOAT_COMPLEX |
for mkl_sparse_c_dotmv |
C_DOUBLE_COMPLEX |
for mkl_sparse_z_dotmv |
If operation = SPARSE_OPERATION_NON_TRANSPOSE, array of size at least \(k\), where \(k\) is the number of columns of matrix \(A\) . Otherwise, array of size at least \(m\), where \(m\) is the number of rows of matrix \(A\) . On entry, the array x must contain the vector x .
beta
C_FLOAT |
for mkl_sparse_s_dotmv |
C_DOUBLE |
for mkl_sparse_d_dotmv |
C_FLOAT_COMPLEX |
for mkl_sparse_c_dotmv |
C_DOUBLE_COMPLEX |
for mkl_sparse_z_dotmv |
Specifies the scalar, \(\beta\) .
y
C_FLOAT |
for mkl_sparse_s_dotmv |
C_DOUBLE |
for mkl_sparse_d_dotmv |
C_FLOAT_COMPLEX |
for mkl_sparse_c_dotmv |
C_DOUBLE_COMPLEX |
for mkl_sparse_z_dotmv |
If operation = SPARSE_OPERATION_NON_TRANSPOSE, array of size at least \(m\) , where \(m\) is the number of rows of matrix \(A\) . Otherwise, array of size at least \(k\) , where \(k\) is the number of columns of matrix \(A\) . On entry, the array y must contain the vector y .
Output Parameters
- y
-
Overwritten by the updated vector y .
d
C_FLOAT |
for mkl_sparse_s_dotmv |
C_DOUBLE |
for mkl_sparse_d_dotmv |
C_FLOAT_COMPLEX |
for mkl_sparse_c_dotmv |
C_DOUBLE_COMPLEX |
for mkl_sparse_z_dotmv |
Overwritten by the dot product of x and y .
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.