.TH "dot" 3 "Wed Feb 7 2024 11:30:40" "Version 3.12.0" "LAPACK" \" -*- nroff -*- .ad l .nh .SH NAME dot \- dot: x^H x and x^T x .SH SYNOPSIS .br .PP .SS "Functions" .in +1c .ti -1c .RI "complex function \fBcdotc\fP (n, cx, incx, cy, incy)" .br .RI "\fBCDOTC\fP " .ti -1c .RI "complex function \fBcdotu\fP (n, cx, incx, cy, incy)" .br .RI "\fBCDOTU\fP " .ti -1c .RI "double precision function \fBddot\fP (n, dx, incx, dy, incy)" .br .RI "\fBDDOT\fP " .ti -1c .RI "double precision function \fBdsdot\fP (n, sx, incx, sy, incy)" .br .RI "\fBDSDOT\fP " .ti -1c .RI "real function \fBsdot\fP (n, sx, incx, sy, incy)" .br .RI "\fBSDOT\fP " .ti -1c .RI "real function \fBsdsdot\fP (n, sb, sx, incx, sy, incy)" .br .RI "\fBSDSDOT\fP " .ti -1c .RI "complex *16 function \fBzdotc\fP (n, zx, incx, zy, incy)" .br .RI "\fBZDOTC\fP " .ti -1c .RI "complex *16 function \fBzdotu\fP (n, zx, incx, zy, incy)" .br .RI "\fBZDOTU\fP " .in -1c .SH "Detailed Description" .PP .SH "Function Documentation" .PP .SS "complex function cdotc (integer n, complex, dimension(*) cx, integer incx, complex, dimension(*) cy, integer incy)" .PP \fBCDOTC\fP .PP \fBPurpose:\fP .RS 4 .PP .nf CDOTC forms the dot product of two complex vectors CDOTC = X^H * Y .fi .PP .RE .PP \fBParameters\fP .RS 4 \fIN\fP .PP .nf N is INTEGER number of elements in input vector(s) .fi .PP .br \fICX\fP .PP .nf CX is COMPLEX array, dimension ( 1 + ( N - 1 )*abs( INCX ) ) .fi .PP .br \fIINCX\fP .PP .nf INCX is INTEGER storage spacing between elements of CX .fi .PP .br \fICY\fP .PP .nf CY is COMPLEX array, dimension ( 1 + ( N - 1 )*abs( INCY ) ) .fi .PP .br \fIINCY\fP .PP .nf INCY is INTEGER storage spacing between elements of CY .fi .PP .RE .PP \fBAuthor\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBFurther Details:\fP .RS 4 .PP .nf jack dongarra, linpack, 3/11/78\&. modified 12/3/93, array(1) declarations changed to array(*) .fi .PP .RE .PP .SS "complex function cdotu (integer n, complex, dimension(*) cx, integer incx, complex, dimension(*) cy, integer incy)" .PP \fBCDOTU\fP .PP \fBPurpose:\fP .RS 4 .PP .nf CDOTU forms the dot product of two complex vectors CDOTU = X^T * Y .fi .PP .RE .PP \fBParameters\fP .RS 4 \fIN\fP .PP .nf N is INTEGER number of elements in input vector(s) .fi .PP .br \fICX\fP .PP .nf CX is COMPLEX array, dimension ( 1 + ( N - 1 )*abs( INCX ) ) .fi .PP .br \fIINCX\fP .PP .nf INCX is INTEGER storage spacing between elements of CX .fi .PP .br \fICY\fP .PP .nf CY is COMPLEX array, dimension ( 1 + ( N - 1 )*abs( INCY ) ) .fi .PP .br \fIINCY\fP .PP .nf INCY is INTEGER storage spacing between elements of CY .fi .PP .RE .PP \fBAuthor\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBFurther Details:\fP .RS 4 .PP .nf jack dongarra, linpack, 3/11/78\&. modified 12/3/93, array(1) declarations changed to array(*) .fi .PP .RE .PP .SS "double precision function ddot (integer n, double precision, dimension(*) dx, integer incx, double precision, dimension(*) dy, integer incy)" .PP \fBDDOT\fP .PP \fBPurpose:\fP .RS 4 .PP .nf DDOT forms the dot product of two vectors\&. uses unrolled loops for increments equal to one\&. .fi .PP .RE .PP \fBParameters\fP .RS 4 \fIN\fP .PP .nf N is INTEGER number of elements in input vector(s) .fi .PP .br \fIDX\fP .PP .nf DX is DOUBLE PRECISION array, dimension ( 1 + ( N - 1 )*abs( INCX ) ) .fi .PP .br \fIINCX\fP .PP .nf INCX is INTEGER storage spacing between elements of DX .fi .PP .br \fIDY\fP .PP .nf DY is DOUBLE PRECISION array, dimension ( 1 + ( N - 1 )*abs( INCY ) ) .fi .PP .br \fIINCY\fP .PP .nf INCY is INTEGER storage spacing between elements of DY .fi .PP .RE .PP \fBAuthor\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBFurther Details:\fP .RS 4 .PP .nf jack dongarra, linpack, 3/11/78\&. modified 12/3/93, array(1) declarations changed to array(*) .fi .PP .RE .PP .SS "double precision function dsdot (integer n, real, dimension(*) sx, integer incx, real, dimension(*) sy, integer incy)" .PP \fBDSDOT\fP .PP \fBPurpose:\fP .RS 4 .PP .nf Compute the inner product of two vectors with extended precision accumulation and result\&. Returns D\&.P\&. dot product accumulated in D\&.P\&., for S\&.P\&. SX and SY DSDOT = sum for I = 0 to N-1 of SX(LX+I*INCX) * SY(LY+I*INCY), where LX = 1 if INCX \&.GE\&. 0, else LX = 1+(1-N)*INCX, and LY is defined in a similar way using INCY\&. .fi .PP .RE .PP \fBParameters\fP .RS 4 \fIN\fP .PP .nf N is INTEGER number of elements in input vector(s) .fi .PP .br \fISX\fP .PP .nf SX is REAL array, dimension(N) single precision vector with N elements .fi .PP .br \fIINCX\fP .PP .nf INCX is INTEGER storage spacing between elements of SX .fi .PP .br \fISY\fP .PP .nf SY is REAL array, dimension(N) single precision vector with N elements .fi .PP .br \fIINCY\fP .PP .nf INCY is INTEGER storage spacing between elements of SY .fi .PP .RE .PP \fBReturns\fP .RS 4 DSDOT .PP .nf DSDOT is DOUBLE PRECISION DSDOT double precision dot product (zero if N\&.LE\&.0) .fi .PP .RE .PP \fBAuthor\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBFurther Details:\fP .RS 4 .PP .nf .fi .PP .RE .PP \fBReferences:\fP .RS 4 .PP .nf C\&. L\&. Lawson, R\&. J\&. Hanson, D\&. R\&. Kincaid and F\&. T\&. Krogh, Basic linear algebra subprograms for Fortran usage, Algorithm No\&. 539, Transactions on Mathematical Software 5, 3 (September 1979), pp\&. 308-323\&. REVISION HISTORY (YYMMDD) 791001 DATE WRITTEN 890831 Modified array declarations\&. (WRB) 890831 REVISION DATE from Version 3\&.2 891214 Prologue converted to Version 4\&.0 format\&. (BAB) 920310 Corrected definition of LX in DESCRIPTION\&. (WRB) 920501 Reformatted the REFERENCES section\&. (WRB) 070118 Reformat to LAPACK style (JL) .fi .PP .RE .PP .SS "real function sdot (integer n, real, dimension(*) sx, integer incx, real, dimension(*) sy, integer incy)" .PP \fBSDOT\fP .PP \fBPurpose:\fP .RS 4 .PP .nf SDOT forms the dot product of two vectors\&. uses unrolled loops for increments equal to one\&. .fi .PP .RE .PP \fBParameters\fP .RS 4 \fIN\fP .PP .nf N is INTEGER number of elements in input vector(s) .fi .PP .br \fISX\fP .PP .nf SX is REAL array, dimension ( 1 + ( N - 1 )*abs( INCX ) ) .fi .PP .br \fIINCX\fP .PP .nf INCX is INTEGER storage spacing between elements of SX .fi .PP .br \fISY\fP .PP .nf SY is REAL array, dimension ( 1 + ( N - 1 )*abs( INCY ) ) .fi .PP .br \fIINCY\fP .PP .nf INCY is INTEGER storage spacing between elements of SY .fi .PP .RE .PP \fBAuthor\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBFurther Details:\fP .RS 4 .PP .nf jack dongarra, linpack, 3/11/78\&. modified 12/3/93, array(1) declarations changed to array(*) .fi .PP .RE .PP .SS "real function sdsdot (integer n, real sb, real, dimension(*) sx, integer incx, real, dimension(*) sy, integer incy)" .PP \fBSDSDOT\fP .PP \fBPurpose:\fP .RS 4 .PP .nf Compute the inner product of two vectors with extended precision accumulation\&. Returns S\&.P\&. result with dot product accumulated in D\&.P\&. SDSDOT = SB + sum for I = 0 to N-1 of SX(LX+I*INCX)*SY(LY+I*INCY), where LX = 1 if INCX \&.GE\&. 0, else LX = 1+(1-N)*INCX, and LY is defined in a similar way using INCY\&. .fi .PP .RE .PP \fBParameters\fP .RS 4 \fIN\fP .PP .nf N is INTEGER number of elements in input vector(s) .fi .PP .br \fISB\fP .PP .nf SB is REAL single precision scalar to be added to inner product .fi .PP .br \fISX\fP .PP .nf SX is REAL array, dimension ( 1 + ( N - 1 )*abs( INCX ) ) single precision vector with N elements .fi .PP .br \fIINCX\fP .PP .nf INCX is INTEGER storage spacing between elements of SX .fi .PP .br \fISY\fP .PP .nf SY is REAL array, dimension ( 1 + ( N - 1 )*abs( INCX ) ) single precision vector with N elements .fi .PP .br \fIINCY\fP .PP .nf INCY is INTEGER storage spacing between elements of SY .fi .PP .RE .PP \fBAuthor\fP .RS 4 Lawson, C\&. L\&., (JPL), Hanson, R\&. J\&., (SNLA), .PP Kincaid, D\&. R\&., (U\&. of Texas), Krogh, F\&. T\&., (JPL) .PP Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBFurther Details:\fP .RS 4 .PP .nf REFERENCES C\&. L\&. Lawson, R\&. J\&. Hanson, D\&. R\&. Kincaid and F\&. T\&. Krogh, Basic linear algebra subprograms for Fortran usage, Algorithm No\&. 539, Transactions on Mathematical Software 5, 3 (September 1979), pp\&. 308-323\&. REVISION HISTORY (YYMMDD) 791001 DATE WRITTEN 890531 Changed all specific intrinsics to generic\&. (WRB) 890831 Modified array declarations\&. (WRB) 890831 REVISION DATE from Version 3\&.2 891214 Prologue converted to Version 4\&.0 format\&. (BAB) 920310 Corrected definition of LX in DESCRIPTION\&. (WRB) 920501 Reformatted the REFERENCES section\&. (WRB) 070118 Reformat to LAPACK coding style .fi .PP .RE .PP .SS "complex*16 function zdotc (integer n, complex*16, dimension(*) zx, integer incx, complex*16, dimension(*) zy, integer incy)" .PP \fBZDOTC\fP .PP \fBPurpose:\fP .RS 4 .PP .nf ZDOTC forms the dot product of two complex vectors ZDOTC = X^H * Y .fi .PP .RE .PP \fBParameters\fP .RS 4 \fIN\fP .PP .nf N is INTEGER number of elements in input vector(s) .fi .PP .br \fIZX\fP .PP .nf ZX is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCX ) ) .fi .PP .br \fIINCX\fP .PP .nf INCX is INTEGER storage spacing between elements of ZX .fi .PP .br \fIZY\fP .PP .nf ZY is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCY ) ) .fi .PP .br \fIINCY\fP .PP .nf INCY is INTEGER storage spacing between elements of ZY .fi .PP .RE .PP \fBAuthor\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBFurther Details:\fP .RS 4 .PP .nf jack dongarra, 3/11/78\&. modified 12/3/93, array(1) declarations changed to array(*) .fi .PP .RE .PP .SS "complex*16 function zdotu (integer n, complex*16, dimension(*) zx, integer incx, complex*16, dimension(*) zy, integer incy)" .PP \fBZDOTU\fP .PP \fBPurpose:\fP .RS 4 .PP .nf ZDOTU forms the dot product of two complex vectors ZDOTU = X^T * Y .fi .PP .RE .PP \fBParameters\fP .RS 4 \fIN\fP .PP .nf N is INTEGER number of elements in input vector(s) .fi .PP .br \fIZX\fP .PP .nf ZX is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCX ) ) .fi .PP .br \fIINCX\fP .PP .nf INCX is INTEGER storage spacing between elements of ZX .fi .PP .br \fIZY\fP .PP .nf ZY is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCY ) ) .fi .PP .br \fIINCY\fP .PP .nf INCY is INTEGER storage spacing between elements of ZY .fi .PP .RE .PP \fBAuthor\fP .RS 4 Univ\&. of Tennessee .PP Univ\&. of California Berkeley .PP Univ\&. of Colorado Denver .PP NAG Ltd\&. .RE .PP \fBFurther Details:\fP .RS 4 .PP .nf jack dongarra, 3/11/78\&. modified 12/3/93, array(1) declarations changed to array(*) .fi .PP .RE .PP .SH "Author" .PP Generated automatically by Doxygen for LAPACK from the source code\&.