complex16_blas_level1(3)

📦
version 3.11.0 · 2 versions
, in debian bookworm

💖 complex16_blas_level1 — complex16 💖

okay bestie, gather round, because this is the page: complex16_blas_level1, aka the complex16 level 1 BLAS squad. if you're here, you're doing vector math and you want it to be fast and correct, and honestly? iconic behavior. 🎀

✨ SYNOPSIS ✨

🦋 Functions

  • subroutine zaxpy (N, ZA, ZX, INCX, ZY, INCY) — ZAXPY
  • subroutine zcopy (N, ZX, INCX, ZY, INCY) — ZCOPY
  • complex *16 function zdotc (N, ZX, INCX, ZY, INCY) — ZDOTC
  • complex *16 function zdotu (N, ZX, INCX, ZY, INCY) — ZDOTU
  • subroutine zdrot (N, ZX, INCX, ZY, INCY, C, S) — ZDROT
  • subroutine zdscal (N, DA, ZX, INCX) — ZDSCAL
  • subroutine zscal (N, ZA, ZX, INCX) — ZSCAL
  • subroutine zswap (N, ZX, INCX, ZY, INCY) — ZSWAP

🌸 Detailed Description 🌸

This is the group of complex16 LEVEL 1 BLAS routines. eight little legends, one big vibe. no cap. 💅

👑 Function Documentation 👑

🧚 subroutine zaxpy (integer N, complex*16 ZA, complex*16, dimension() ZX, integer INCX, complex16, dimension(*) ZY, integer INCY)

ZAXPY

Purpose:

ZAXPY constant times a vector plus a vector.

like, y = a*x + y energy. it's giving "do the math, slay, move on." ⭐

Parameters

  • N — N is INTEGER. number of elements in input vector(s). the count, the headcount, the how-many-besties. 💖
  • ZA — ZA is COMPLEX*16. On entry, ZA specifies the scalar alpha. (yes bestie, that alpha.)
  • ZX — ZX is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCX ) ). 📏
  • INCX — INCX is INTEGER. storage spacing between elements of ZX. the stride, the skip, the walk-pattern. 🚶
  • ZY — ZY is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCY ) ). 📏
  • INCY — INCY is INTEGER. storage spacing between elements of ZY.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Further Details:

jack dongarra, 3/11/78.
modified 12/3/93, array(1) declarations changed to array(*)

🦋 subroutine zcopy (integer N, complex*16, dimension() ZX, integer INCX, complex16, dimension(*) ZY, integer INCY)

ZCOPY

Purpose:

ZCOPY copies a vector, x, to a vector, y.

copy-paste but make it linear algebra. no clipboard needed, bestie. 📋✨

Parameters

  • N — N is INTEGER. number of elements in input vector(s).
  • ZX — ZX is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCX ) ).
  • INCX — INCX is INTEGER. storage spacing between elements of ZX.
  • ZY — ZY is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCY ) ).
  • INCY — INCY is INTEGER. storage spacing between elements of ZY.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Further Details:

jack dongarra, linpack, 4/11/78.
modified 12/3/93, array(1) declarations changed to array(*)

🌈 complex*16 function zdotc (integer N, complex*16, dimension() ZX, integer INCX, complex16, dimension(*) ZY, integer INCY)

ZDOTC

Purpose:

ZDOTC forms the dot product of two complex vectors
     ZDOTC = X^H * Y

note the H bestie — that's the conjugate transpose. she's that girl. 💅

Parameters

  • N — N is INTEGER. number of elements in input vector(s).
  • ZX — ZX is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCX ) ).
  • INCX — INCX is INTEGER. storage spacing between elements of ZX.
  • ZY — ZY is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCY ) ).
  • INCY — INCY is INTEGER. storage spacing between elements of ZY.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Further Details:

jack dongarra, 3/11/78.
modified 12/3/93, array(1) declarations changed to array(*)

🍓 complex*16 function zdotu (integer N, complex*16, dimension() ZX, integer INCX, complex16, dimension(*) ZY, integer INCY)

ZDOTU

Purpose:

ZDOTU forms the dot product of two complex vectors
     ZDOTU = X^T * Y

the un-conjugated sibling. T, not H. don't mix them up or your math gets weird. 😭

Parameters

  • N — N is INTEGER. number of elements in input vector(s).
  • ZX — ZX is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCX ) ).
  • INCX — INCX is INTEGER. storage spacing between elements of ZX.
  • ZY — ZY is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCY ) ).
  • INCY — INCY is INTEGER. storage spacing between elements of ZY.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Further Details:

jack dongarra, 3/11/78.
modified 12/3/93, array(1) declarations changed to array(*)

🎀 subroutine zdrot (integer N, complex*16, dimension( * ) ZX, integer INCX, complex*16, dimension( * ) ZY, integer INCY, double precision C, double precision S)

ZDROT

Purpose:

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.

spinning those complex vectors with a real cos and real sin. rotational main character energy. 🌀

Parameters

  • N — N is INTEGER. On entry, N specifies the order of the vectors cx and cy. N must be at least zero.
  • ZX — ZX is COMPLEX*16 array, dimension at least ( 1 + ( N - 1 )*abs( INCX ) ). Before entry, the incremented array ZX must contain the n element vector cx. On exit, ZX is overwritten by the updated vector cx.
  • INCX — INCX is INTEGER. On entry, INCX specifies the increment for the elements of ZX. INCX must not be zero.
  • ZY — ZY is COMPLEX*16 array, dimension at least ( 1 + ( N - 1 )*abs( INCY ) ). Before entry, the incremented array ZY must contain the n element vector cy. On exit, ZY is overwritten by the updated vector cy.
  • INCY — INCY is INTEGER. On entry, INCY specifies the increment for the elements of ZY. INCY must not be zero.
  • C — C is DOUBLE PRECISION. On entry, C specifies the cosine, cos.
  • S — S is DOUBLE PRECISION. On entry, S specifies the sine, sin.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

🌟 subroutine zdscal (integer N, double precision DA, complex*16, dimension(*) ZX, integer INCX)

ZDSCAL

Purpose:

ZDSCAL scales a vector by a constant.

real constant, complex vector. it's giving mixed-marriage but make it math. 🫶

Parameters

  • N — N is INTEGER. number of elements in input vector(s).
  • DA — DA is DOUBLE PRECISION. On entry, DA specifies the scalar alpha.
  • ZX — ZX is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCX ) ).
  • INCX — INCX is INTEGER. storage spacing between elements of ZX.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Further Details:

jack dongarra, 3/11/78.
modified 3/93 to return if incx .le. 0.
modified 12/3/93, array(1) declarations changed to array(*)

💜 subroutine zscal (integer N, complex*16 ZA, complex*16, dimension(*) ZX, integer INCX)

ZSCAL

Purpose:

ZSCAL scales a vector by a constant.

same vibe as ZDSCAL but the constant is complex this time. glow-up. ✨

Parameters

  • N — N is INTEGER. number of elements in input vector(s).
  • ZA — ZA is COMPLEX*16. On entry, ZA specifies the scalar alpha.
  • ZX — ZX is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCX ) ).
  • INCX — INCX is INTEGER. storage spacing between elements of ZX.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Further Details:

jack dongarra, 3/11/78.
modified 3/93 to return if incx .le. 0.
modified 12/3/93, array(1) declarations changed to array(*)

🔥 subroutine zswap (integer N, complex*16, dimension() ZX, integer INCX, complex16, dimension(*) ZY, integer INCY)

ZSWAP

Purpose:

ZSWAP interchanges two vectors.

trading places, but the vectors are the ones swapping. no train involved. 🚂💫

Parameters

  • N — N is INTEGER. number of elements in input vector(s).
  • ZX — ZX is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCX ) ).
  • INCX — INCX is INTEGER. storage spacing between elements of ZX.
  • ZY — ZY is COMPLEX*16 array, dimension ( 1 + ( N - 1 )*abs( INCY ) ).
  • INCY — INCY is INTEGER. storage spacing between elements of ZY.

Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Further Details:

jack dongarra, 3/11/78.
modified 12/3/93, array(1) declarations changed to array(*)

💖 Author 💖

Generated automatically by Doxygen for LAPACK from the source code. the bots did this one, bestie. 🤖✨

okay and that's the whole page, no skips, no skims. this was LAPACK Version 3.11.0, dated Sun Nov 27 2022, and you read it in full which means you are lowkey a scholar now. go forth and multiply (vectors). periodt. 💅👑🌸

📦 where this page comes from