DSDOT(3)

๐Ÿ“ฆ version 3.12.0, in opensuse-leap 16.0

๐ŸŒธ DSDOT(3) โ€” Library Functions Manual ๐ŸŒธ

okay so bestie, gather round, because this is the manpage for /home/abui...SRC/dsdot.f(3) and it's lowkey a whole vibe. it lives in the Library Functions Manual section, and it's fr fr just a Fortran file doing math with more precision than your situationship. ๐Ÿ’…


โœจ NAME โœจ

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/BLAS/SRC/dsdot.f

like, that's the whole name. that's the path. it's giving "I was generated by a build system and I'm proud of it." ๐ŸŽ€


๐Ÿฆ‹ SYNOPSIS ๐Ÿฆ‹

Functions/Subroutines

double precision function DSDOT (n, sx, incx, sy, incy)
    DSDOT

that's it. that's the girl. โœจ


๐Ÿ‘‘ Function/Subroutine Documentation ๐Ÿ‘‘

double precision function DSDOT (integer n, real, dimension(*) sx, integer
    incx, real, dimension(*) sy, integer incy)

DSDOT

๐ŸŽฏ Purpose ๐ŸŽฏ

!> !> Compute the inner product of two vectors with extended !> precision accumulation and result. !> !> Returns D.P. dot product accumulated in D.P., for S.P. SX and SY !> DSDOT = sum for I = 0 to N-1 of SX(LX+I*INCX) * SY(LY+I*INCY), !> where LX = 1 if INCX .GE. 0, else LX = 1+(1-N)*INCX, and LY is !> defined in a similar way using INCY. !>

so basically: you feed it two single-precision vectors, it multiplies them element by element, adds it all up, and hands you back a double precision result. the accumulation is double precision too, so she's careful the whole way through. highkey iconic behavior. ๐Ÿงฎ๐Ÿ’–

and yes, that LX / LY business is just how she figures out where to start reading when your INCX is negative. don't overthink it, she's got it handled.


๐ŸŒˆ Parameters ๐ŸŒˆ

  • N โ€” between you and me, she's an INTEGER.
!>          N is INTEGER
!>         number of elements in input vector(s)
!>
  • SX โ€” SX is REAL array, dimension(N), a single precision vector with N elements.
!>          SX is REAL array, dimension(N)
!>         single precision vector with N elements
!>
  • INCX โ€” she's an INTEGER, and she's the storage spacing between elements of SX. like, the stride. the vibe spacing. ๐Ÿฆ‹
!>          INCX is INTEGER
!>          storage spacing between elements of SX
!>
  • SY โ€” SY is REAL array, dimension(N), single precision vector with N elements. the other half of the duo, obvi. ๐Ÿ‘ฏ
!>          SY is REAL array, dimension(N)
!>         single precision vector with N elements
!>
  • INCY โ€” INTEGER, storage spacing between elements of SY. same deal as INCX but for the other vector. ๐Ÿ’ซ
!>          INCY is INTEGER
!>         storage spacing between elements of SY
!>

๐Ÿ’œ Returns ๐Ÿ’œ

DSDOT

!>          DSDOT is DOUBLE PRECISION
!>         DSDOT  double precision dot product (zero if N.LE.0)
!>

so: the result is DOUBLE PRECISION, and if N.LE.0 you get zero. no drama, no error, just a clean 0. she's not gonna make a scene about it. ๐Ÿ˜Œ


๐Ÿซถ Author ๐Ÿซถ

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

four whole institutions. the group project that actually got finished. ๐Ÿ”ฅ


๐ŸŒธ Further Details: ๐ŸŒธ

!>

...that's it. that's the further details. an empty comment block. honestly? relatable. sometimes there's just nothing to add and you go to bed. ๐Ÿ˜ญ๐Ÿ’€


๐Ÿ“š References: ๐Ÿ“š

!>
!>
!>  C. L. Lawson, R. J. Hanson, D. R. Kincaid and F. T.
!>  Krogh, Basic linear algebra subprograms for Fortran
!>  usage, Algorithm No. 539, Transactions on Mathematical
!>  Software 5, 3 (September 1979), pp. 308-323.
!>
!>  REVISION HISTORY  (YYMMDD)
!>
!>  791001  DATE WRITTEN
!>  890831  Modified array declarations.  (WRB)
!>  890831  REVISION DATE from Version 3.2
!>  891214  Prologue converted to Version 4.0 format.  (BAB)
!>  920310  Corrected definition of LX in DESCRIPTION.  (WRB)
!>  920501  Reformatted the REFERENCES section.  (WRB)
!>  070118  Reformat to LAPACK style (JL)
!>

not the revision history going back to 791001. she's been on her grind since 1979 and still shows up to work. main character energy fr. ๐ŸŒŸ


๐Ÿ“ Definition at line 118 of file dsdot.f. ๐Ÿ“

yes bestie, line 118. we counted. ๐ŸŽ€


๐Ÿ’… Author ๐Ÿ’…

Generated automatically by Doxygen for LAPACK from the source code.

so nobody wrote this manpage, a robot did. and honestly the robot ate. ๐Ÿค–โœจ


ok that's the whole page!! every flag, every parameter, every revision date, all of it. no skips, no cuts. periodt. ๐Ÿซถ

and that's a wrap, bestie โ€” this little love letter is from LAPACK, Version 3.12.0, dated /home/abui...SRC/dsdot.f(3). go forth and dot-product responsibly. ๐Ÿ’–๐ŸŒˆโญ

๐Ÿ“ฆ where this page comes from