SRC/slarf.f(3)

πŸ’… SRC/slarf.f β€” like, the whole vibe

okay so bestie, welcome to the slarf manual page (it lives in the LAPACK library functions manual, section 3, and honestly? she's iconic). Buckle up, we're about to make linear algebra feel like a group chat. πŸŽ€


✨ SYNOPSIS ✨

🧚 Functions/Subroutines

  • subroutine slarf (side, m, n, v, incv, tau, c, ldc, work) β€” SLARF applies an elementary reflector to a general rectangular matrix. that's the whole personality fr fr πŸ’…

πŸ”₯ Function/Subroutine Documentation πŸ”₯

πŸ’– subroutine slarf (character side, integer m, integer n, real, dimension( * ) v, integer incv, real tau, real, dimension( ldc, * ) c, integer ldc, real, dimension( * ) work)

SLARF applies an elementary reflector to a general rectangular matrix. periodt. ✨

🌸 Purpose:

!>
!> SLARF applies a real elementary reflector H to a real m by n matrix
!> C, from either the left or the right. H is represented in the form
!>
!>       H = I - tau * v * v**T
!>
!> where tau is a real scalar and v is a real vector.
!>
!> If tau = 0, then H is taken to be the unit matrix.
!>

so basically H is built from tau (a real scalar) and v (a real vector), and if tau = 0 then H just quietly becomes the unit matrix β€” no drama, no notes. πŸ’€


πŸ¦‹ Parameters

  • SIDE β€” SIDE is CHARACTER*1. it picks the side, obviously:
!>          = 'L': form  H * C
!>          = 'R': form  C * H
!>
  • M β€” M is INTEGER, and it's the number of rows of the matrix C. that's it, that's the whole job. 🫢
  • N β€” N is INTEGER, the number of columns of the matrix C. slay.
  • V β€” V is REAL array, dimension:
!>                     (1 + (M-1)*abs(INCV)) if SIDE = 'L'
!>                  or (1 + (N-1)*abs(INCV)) if SIDE = 'R'

this is the vector v in the representation of H. important: V is not used if TAU = 0 β€” she's off duty in that case, respect it. πŸ™ˆ

  • INCV β€” INCV is INTEGER, the increment between elements of v. and INCV <> 0 β€” non-negotiable bestie, zero is not invited. ⭐
  • TAU β€” TAU is REAL, the value tau in the representation of H. main character scalar energy. πŸ‘‘
  • C β€” C is REAL array, dimension (LDC,N).
    • On entry: the m by n matrix C.
    • On exit: C is overwritten by the matrix H * C if SIDE = 'L', or C * H if SIDE = 'R'.

so yeah, she gets replaced. no cap, that's literally the point. πŸ”₯

  • LDC β€” LDC is INTEGER, the leading dimension of the array C. and LDC >= max(1,M) β€” gotta hold that line, fr fr. πŸ’œ
  • WORK β€” WORK is REAL array, dimension:
!>                         (N) if SIDE = 'L'
!>                      or (M) if SIDE = 'R'

the lil scratchpad. give her the room she needs. πŸ“


🌈 Author

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

look at that squad. genuinely obsessed. 🫢✨


πŸŽ€ Definition at line 123 of file slarf.f.

(yeah, line 123 β€” cute number, no notes) πŸ’…


⭐ Author

Generated automatically by Doxygen for LAPACK from the source code. so like, a robot wrote this part, but we made it cute. πŸ€–πŸ’–


🧚 and that's the whole page bestie! no skipped sections, no missing options, we kept every single detail because that's the vibe check and we passed it. πŸ’…βœ¨

okay bye, this was SRC/slarf.f(3) from LAPACK, Version 3.12.0 β€” catch you on the flip side! πŸŒΈπŸ¦‹πŸ’œ

πŸ“¦ where this page comes from