.TH "complex_blas_level1" 3 "Sun Nov 27 2022" "Version 3.11.0" "LAPACK" \" -*- nroff -*- .ad l .nh .SH NAME complex_blas_level1 \- complex .SH SYNOPSIS .br .PP .SS "Functions" .in +1c .ti -1c .RI "subroutine \fBcaxpy\fP (N, CA, CX, INCX, CY, INCY)" .br .RI "\fBCAXPY\fP " .ti -1c .RI "subroutine \fBccopy\fP (N, CX, INCX, CY, INCY)" .br .RI "\fBCCOPY\fP " .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 "subroutine \fBcscal\fP (N, CA, CX, INCX)" .br .RI "\fBCSCAL\fP " .ti -1c .RI "subroutine \fBcsrot\fP (N, CX, INCX, CY, INCY, C, S)" .br .RI "\fBCSROT\fP " .ti -1c .RI "subroutine \fBcsscal\fP (N, SA, CX, INCX)" .br .RI "\fBCSSCAL\fP " .ti -1c .RI "subroutine \fBcswap\fP (N, CX, INCX, CY, INCY)" .br .RI "\fBCSWAP\fP " .in -1c .SH "Detailed Description" .PP This is the group of complex LEVEL 1 BLAS routines\&. .SH "Function Documentation" .PP .SS "subroutine caxpy (integer N, complex CA, complex, dimension(*) CX, integer INCX, complex, dimension(*) CY, integer INCY)" .PP \fBCAXPY\fP .PP \fBPurpose:\fP .RS 4 .PP .nf CAXPY constant times a vector plus a vector\&. .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 \fICA\fP .PP .nf CA is COMPLEX On entry, CA specifies the scalar alpha\&. .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 "subroutine ccopy (integer N, complex, dimension(*) CX, integer INCX, complex, dimension(*) CY, integer INCY)" .PP \fBCCOPY\fP .PP \fBPurpose:\fP .RS 4 .PP .nf CCOPY copies a vector x to a vector 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 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 "subroutine cscal (integer N, complex CA, complex, dimension(*) CX, integer INCX)" .PP \fBCSCAL\fP .PP \fBPurpose:\fP .RS 4 .PP .nf CSCAL scales a vector by a constant\&. .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 \fICA\fP .PP .nf CA is COMPLEX On entry, CA specifies the scalar alpha\&. .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 .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 3/93 to return if incx \&.le\&. 0\&. modified 12/3/93, array(1) declarations changed to array(*) .fi .PP .RE .PP .SS "subroutine csrot (integer N, complex, dimension( * ) CX, integer INCX, complex, dimension( * ) CY, integer INCY, real C, real S)" .PP \fBCSROT\fP .PP \fBPurpose:\fP .RS 4 .PP .nf CSROT applies a plane rotation, where the cos and sin (c and s) are real and the vectors cx and cy are complex\&. jack dongarra, linpack, 3/11/78\&. .fi .PP .RE .PP \fBParameters\fP .RS 4 \fIN\fP .PP .nf N is INTEGER On entry, N specifies the order of the vectors cx and cy\&. N must be at least zero\&. .fi .PP .br \fICX\fP .PP .nf CX is COMPLEX array, dimension at least ( 1 + ( N - 1 )*abs( INCX ) )\&. Before entry, the incremented array CX must contain the n element vector cx\&. On exit, CX is overwritten by the updated vector cx\&. .fi .PP .br \fIINCX\fP .PP .nf INCX is INTEGER On entry, INCX specifies the increment for the elements of CX\&. INCX must not be zero\&. .fi .PP .br \fICY\fP .PP .nf CY is COMPLEX array, dimension at least ( 1 + ( N - 1 )*abs( INCY ) )\&. Before entry, the incremented array CY must contain the n element vector cy\&. On exit, CY is overwritten by the updated vector cy\&. .fi .PP .br \fIINCY\fP .PP .nf INCY is INTEGER On entry, INCY specifies the increment for the elements of CY\&. INCY must not be zero\&. .fi .PP .br \fIC\fP .PP .nf C is REAL On entry, C specifies the cosine, cos\&. .fi .PP .br \fIS\fP .PP .nf S is REAL On entry, S specifies the sine, sin\&. .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 .SS "subroutine csscal (integer N, real SA, complex, dimension(*) CX, integer INCX)" .PP \fBCSSCAL\fP .PP \fBPurpose:\fP .RS 4 .PP .nf CSSCAL scales a complex vector by a real constant\&. .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 \fISA\fP .PP .nf SA is REAL On entry, SA specifies the scalar alpha\&. .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 .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 3/93 to return if incx \&.le\&. 0\&. modified 12/3/93, array(1) declarations changed to array(*) .fi .PP .RE .PP .SS "subroutine cswap (integer N, complex, dimension(*) CX, integer INCX, complex, dimension(*) CY, integer INCY)" .PP \fBCSWAP\fP .PP \fBPurpose:\fP .RS 4 .PP .nf CSWAP interchanges two vectors\&. .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 .SH "Author" .PP Generated automatically by Doxygen for LAPACK from the source code\&.