axpy(3)

📦
version 3.12.1 · 9 versions
, in arch rolling

💖 NAME 💖

okay so this is axpy(3), straight out of the Library Functions Manual, and the name line is literally:

axpy - axpy: y = ax + y

that's the whole vibe, bestie: multiply a vector by a constant, add it to another vector, slay. 💅✨

✨ SYNOPSIS ✨

🌸 Functions

  • subroutine caxpy (n, ca, cx, incx, cy, incy) — CAXPY
  • subroutine daxpy (n, da, dx, incx, dy, incy) — DAXPY
  • subroutine saxpy (n, sa, sx, incx, sy, incy) — SAXPY
  • subroutine zaxpy (n, za, zx, incx, zy, incy) — ZAXPY

🦋 Detailed Description 🦋

this heading is here, and then the page immediately gets into the function documentation. no extra lore paragraph, no side quest — just the four subroutines below. 🫶

👑 Function Documentation 👑

🎀 subroutine caxpy 🎀

subroutine caxpy (integer n, complex ca, complex, dimension(*) cx, integer incx, complex, dimension(*) cy, integer incy)

CAXPY

🌸 Purpose

CAXPY does the iconic move: constant times a vector plus a vector. that's it, that's the whole purpose. ✨

💅 Parameters

  • N — N is INTEGER; number of elements in input vector(s).
  • CA — CA is COMPLEX; on entry, CA specifies the scalar alpha.
  • CX — CX is COMPLEX array, dimension ( 1 + ( N - 1 )*abs( INCX ) )
  • INCX — INCX is INTEGER; storage spacing between elements of CX.
  • CY — CY is COMPLEX array, dimension ( 1 + ( N - 1 )*abs( INCY ) )
  • INCY — INCY is INTEGER; storage spacing between elements of CY.

🌟 Author

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

⭐ Further Details:

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

Definition at line 87 of file caxpy.f.

🎀 subroutine daxpy 🎀

subroutine daxpy (integer n, double precision da, double precision, dimension(*) dx, integer incx, double precision, dimension(*) dy, integer incy)

DAXPY

🌸 Purpose

DAXPY is also constant times a vector plus a vector, and it uses unrolled loops for increments equal to one. okay, performance queen. 🔥

💅 Parameters

  • N — N is INTEGER; number of elements in input vector(s).
  • DA — DA is DOUBLE PRECISION; on entry, DA specifies the scalar alpha.
  • DX — DX is DOUBLE PRECISION array, dimension ( 1 + ( N - 1 )*abs( INCX ) )
  • INCX — INCX is INTEGER; storage spacing between elements of DX.
  • DY — DY is DOUBLE PRECISION array, dimension ( 1 + ( N - 1 )*abs( INCY ) )
  • INCY — INCY is INTEGER; storage spacing between elements of DY.

🌟 Author

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

⭐ Further Details:

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

Definition at line 88 of file daxpy.f.

🎀 subroutine saxpy 🎀

subroutine saxpy (integer n, real sa, real, dimension(*) sx, integer incx, real, dimension(*) sy, integer incy)

SAXPY

🌸 Purpose

SAXPY is the real-scalar version of the constant-times-a-vector-plus-a-vector agenda, and it uses unrolled loops for increments equal to one. yes bestie, same energy. 💖

💅 Parameters

  • N — N is INTEGER; number of elements in input vector(s).
  • SA — SA is REAL; on entry, SA specifies the scalar alpha.
  • SX — SX is REAL array, dimension ( 1 + ( N - 1 )*abs( INCX ) )
  • INCX — INCX is INTEGER; storage spacing between elements of SX.
  • SY — SY is REAL array, dimension ( 1 + ( N - 1 )*abs( INCY ) )
  • INCY — INCY is INTEGER; storage spacing between elements of SY.

🌟 Author

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

⭐ Further Details:

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

Definition at line 88 of file saxpy.f.

🎀 subroutine zaxpy 🎀

subroutine zaxpy (integer n, complex*16 za, complex*16, dimension(*) zx, integer incx, complex*16, dimension(*) zy, integer incy)

ZAXPY

🌸 Purpose

ZAXPY is the complex*16 edition: constant times a vector plus a vector. no extra notes, just double-complex business. 💜

💅 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.
  • 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(*)
!>

Definition at line 87 of file zaxpy.f.

🌈 Author 🌈

Generated automatically by Doxygen for LAPACK from the source code.

source/version check, bestie: this is LAPACK, Version 3.12.0, and the footer is giving axpy(3) — no date listed, so I'm not inventing one. periodt. 💖✨🎀

📦 where this page comes from