.TH "complex_blas_level1" 3 "Tue Dec 4 2018" "Version 3.8.0" "LAPACK" \" -*- nroff -*- .ad l .nh .SH NAME complex_blas_level1 .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 \fBcrotg\fP (CA, CB, C, S)" .br .RI "\fBCROTG\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 \fBDate:\fP .RS 4 November 2017 .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 \fBDate:\fP .RS 4 November 2017 .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 REAL 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 REAL 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 \fBDate:\fP .RS 4 November 2017 .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 REAL 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 REAL 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 \fBDate:\fP .RS 4 November 2017 .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 crotg (complex CA, complex CB, real C, complex S)" .PP \fBCROTG\fP .PP \fBPurpose: \fP .RS 4 .PP .nf CROTG determines a complex Givens rotation. .fi .PP .RE .PP \fBParameters:\fP .RS 4 \fICA\fP .PP .nf CA is COMPLEX .fi .PP .br \fICB\fP .PP .nf CB is COMPLEX .fi .PP .br \fIC\fP .PP .nf C is REAL .fi .PP .br \fIS\fP .PP .nf S is COMPLEX .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 \fBDate:\fP .RS 4 November 2017 .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 \fBDate:\fP .RS 4 November 2017 .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 \fBDate:\fP .RS 4 December 2016 .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 \fBDate:\fP .RS 4 November 2017 .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 \fBDate:\fP .RS 4 November 2017 .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\&.