Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
?dotui
Computes the unconjugated dot product of a compressed sparse complex vector by a full-storage complex vector.
Syntax
res = cdotui ( nz, x, indx, y )
res = zdotui ( nz, x, indx, y )
res = dotui ( x , indx , y )
Include Files
mkl.fi , mkl_blas.f90
Description
The ?dotui routines return the dot product of x and y defined as
\[res = x(1)\cdot y(\text{indx}(1)) + x(2)\cdot y(\text{indx}(2)) + \dots + x(\text{nz} )\cdot y(\text{indx}(\text{nz}))\]
where the triple ( nz, x, indx ) defines a sparse complex vector stored in compressed form, and y is a real vector in full storage form. The functions reference only the elements of y whose indices are listed in the array indx . The values in indx must be distinct.
Input Parameters
nz
INTEGER .
The number of elements in x and indx .
x
COMPLEX |
for cdotui |
DOUBLE COMPLEX |
for zdotui |
Array, size at least nz .
indx
INTEGER.
Specifies the indices for the elements of x. Array, size at least nz .
y
COMPLEX |
for cdotci |
DOUBLE COMPLEX |
for zdotci |
Array, size at least \(\max(\text{indx}(i))\).
Output Parameters
res
COMPLEX |
for cdotui |
DOUBLE COMPLEX |
for zdotui |
Value of the unconjugated dot product of x and y , if nz is positive. Otherwise, it has value 0 .
BLAS 95 Interface Notes
Routines in Fortran 95 interface have fewer arguments in the calling sequence than their FORTRAN 77 counterparts. For general conventions applied to skip redundant or reconstructible arguments, see BLAS 95 Interface Conventions .
Specific details for the routine dotui interface are the following:
- x
-
Holds the vector with the number of elements nz .
- indx
-
Holds the vector with the number of elements nz .
- y
-
Holds the vector with the number of elements nz .