BLAS/SRC/saxpy.f(3)

πŸ’– BLAS/SRC/saxpy.f(3) β€” the LAPACK manual, bestie edition πŸ’–

okay so this is a page from the LAPACK manual (that's section 3, the library-functions girlies) and it's all about one lil file: BLAS/SRC/saxpy.f. she's small, she's iconic, she does exactly one thing and does it flawlessly. no cap. ✨


🌸 NAME 🌸

BLAS/SRC/saxpy.f β€” that's the whole name, that's her, that's the file πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

Functions/Subroutines

  • subroutine saxpy (n, sa, sx, incx, sy, incy) β€” aka SAXPY, the main character πŸ‘‘

πŸŽ€ Function/Subroutine Documentation πŸŽ€

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

SAXPY β€” say it with me now 🫢

✨ Purpose ✨

so basically: SAXPY constant times a vector plus a vector.

and here's the lil flex β€” it uses unrolled loops for increments equal to one. speed demon behaviour, we love to see it πŸ”₯

🌈 Parameters 🌈

  • N β€” N is INTEGER. it's the number of elements in input vector(s). so like, how many numbers we're working with, bestie.
  • SA β€” SA is REAL. On entry, SA specifies the scalar alpha. yes she's that alpha πŸ’…
  • SX β€” SX is REAL array, dimension ( 1 + ( N - 1 )*abs( INCX ) ). the vector that's getting scaled, gorgeous, stunning.
  • INCX β€” INCX is INTEGER. it's the storage spacing between elements of SX. think of it like... how far apart the elements are sitting in memory. personal space, but for floats 🧚
  • SY β€” SY is REAL array, dimension ( 1 + ( N - 1 )*abs( INCY ) ). the vector that gets stuff added to it. she's receiving today 🎁
  • INCY β€” INCY is INTEGER. the storage spacing between elements of SY. same vibe as INCX but for the other girl.
ngl the dimension formulas are giving math but they're literally just saying "enough room for N elements spaced INCX (or INCY) apart" πŸ“

πŸ‘‘ Author πŸ‘‘

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

the whole squad showed up fr fr πŸ’œ

πŸ’€ Further Details πŸ’€

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

so yeah, jack dongarra, linpack, dated 3/11/78 β€” an elder, a legend, the blueprint. then it got modified 12/3/93 when the array(1) declarations changed to array(*). glow-up era, we respect it ⭐

Definition at line 88 of file saxpy.f. that's the exact spot, line 88, go look, i'll wait πŸ™ˆ


πŸ’« Author πŸ’«

Generated automatically by Doxygen for LAPACK from the source code.

not a human writing this one, it's the Doxygen bot doing its lil thing πŸ€–βœ¨ auto-generated and still serving looks.


and that's the whole page, bestie!! 🫢 this was Version 3.12.0, generated Tue Nov 28 2023 12:08:41, filed under BLAS/SRC/saxpy.f(3) β€” mwah, iconic, periodt πŸ’–πŸŒΈπŸ’