BLAS/SRC/dscal.f(3)

πŸ¦‹ BLAS/SRC/dscal.f(3) β€” Library Functions Manual πŸ¦‹

okay so bestie, we're in the BLAS corner of the LAPACK universe today β€” this is the manual page for dscal.f, from the Library Functions Manual. buckle up, it's short and it SLAPS πŸ’…


✨ NAME ✨

BLAS/SRC/dscal.f β€” that's the whole name, no cap, that's literally it πŸŽ€


🌸 SYNOPSIS 🌸

Functions/Subroutines

  • subroutine dscal (n, da, dx, incx) β€” the one and only, DSCAL herself πŸ‘‘

πŸ’– Function/Subroutine Documentation πŸ’–

subroutine dscal (integer n, double precision da, double precision,
    dimension(*) dx, integer incx)

DSCAL β€” main character energy, fr fr ⭐

🧚 Purpose:

!>
!>    DSCAL scales a vector by a constant.
!>    uses unrolled loops for increment equal to 1.
!>

so basically: multiply a whole vector by one scalar. and when the increment is exactly 1, it flexes with unrolled loops πŸ”₯ (iykyk)

πŸ“ Parameters

  • N
!>          N is INTEGER
!>         number of elements in input vector(s)
!>

the count of how many elements are living in your input vector(s) ✨

  • DA
!>          DA is DOUBLE PRECISION
!>           On entry, DA specifies the scalar alpha.
!>

the scalar itself, aka alpha. on entry, this is the number doing the scaling πŸ’«

  • DX
!>          DX is DOUBLE PRECISION array, dimension ( 1 + ( N - 1 )*abs( INCX ) )
!>

your double precision array, sized exactly like that β€” ( 1 + ( N - 1 )*abs( INCX ) ) β€” copy it exactly bestie, don't be cute with the math πŸ™ˆ

  • INCX
!>          INCX is INTEGER
!>         storage spacing between elements of DX
!>

the storage spacing between elements of DX β€” how far apart your elements are chillin' in memory 🌈


πŸ‘‘ Author

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

the whole squad, we love a collab 🫢


πŸ’œ Further Details:

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

the lore πŸ’€ β€” jack dongarra, linpack, dated 3/11/78, then tweaked 3/93 to bail out early if incx .le. 0, and tweaked again 12/3/93 when the array(1) declarations were changed to array(*). iconic history, ngl πŸŽ€


πŸ“ Definition at line 78 of file dscal.f.


🌟 Author (yes, a second one, she's extra)

Generated automatically by Doxygen for LAPACK from the source code. πŸ€–βœ¨


heads up bestie: if incx is 0 or negative, per that 3/93 modification, the routine just returns β€” no scaling, no drama πŸ’€

and that's the whole page!! LAPACK, Version 3.12.0, BLAS/SRC/dscal.f(3) β€” ty for reading my little manpage era, ily, go scale something πŸ’–πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from