CLACRT(3)

πŸ“¦ version 3.12.0, in opensuse-leap 16.0

πŸŽ€ CLACRT(3) πŸŽ€

okay so bestie, quick vibe check: this page is straight out of the Library Functions Manual, and it's the manpage for clacrt.f(3) β€” yeah, an auto-generated Doxygen situation, we love a machine-made king πŸ‘‘. Sit down, hydrate, and let me walk you through it πŸ’–


✨ NAME ✨

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

bestie the NAME is literally the entire file path πŸ’€ that's what happens when Doxygen generates your docs, it's giving "no thoughts, just path" and honestly? iconic. moving on 🫢


🌸 SYNOPSIS 🌸

Functions/Subroutines

subroutine CLACRT (n, cx, incx, cy, incy, c, s)

CLACRT performs a linear transformation of a pair of complex vectors. slay ✨


πŸ’œ Function/Subroutine Documentation πŸ’œ

subroutine CLACRT (integer n, complex, dimension( * ) cx, integer incx,
    complex, dimension( * ) cy, integer incy, complex c, complex s)

CLACRT performs a linear transformation of a pair of complex vectors. same girl, fuller signature β€” now you can see every arg's type at a glance πŸ‘‘

πŸ¦‹ Purpose

like, here's the whole thing verbatim because I would never paraphrase math at you:

!>
!> CLACRT performs the operation
!>
!>    (  c  s )( x )  ==> ( x )
!>    ( -s  c )( y )      ( y )
!>
!> where c and s are complex and the vectors x and y are complex.
!>

so it takes your two complex vectors and rotates/mixes them with that cute little 2x2 matrix. it's giving linear algebra glow-up πŸ’…

πŸ“ Parameters

  • N β€” N is INTEGER. The number of elements in the vectors CX and CY. like, how many besties are in the group chat πŸ’–
!>          N is INTEGER
!>          The number of elements in the vectors CX and CY.
  • CX β€” CX is COMPLEX array, dimension (N). On input it's the vector x; on output, CX is overwritten with c*x + s*y. it literally reinvents itself, main character energy πŸ”₯
!>          CX is COMPLEX array, dimension (N)
!>          On input, the vector x.
!>          On output, CX is overwritten with c*x + s*y.
  • INCX β€” INCX is INTEGER. The increment between successive values of CX. and listen: INCX <> 0. that's not a suggestion, bestie, that's a rule 🚨
!>          INCX is INTEGER
!>          The increment between successive values of CX.  INCX <> 0.
  • CY β€” CY is COMPLEX array, dimension (N). On input it's the vector y; on output, CY is overwritten with -s*x + c*y. notice the minus sign, don't lose it, that's the whole plot twist 😭
!>          CY is COMPLEX array, dimension (N)
!>          On input, the vector y.
!>          On output, CY is overwritten with -s*x + c*y.
  • INCY β€” INCY is INTEGER. The increment between successive values of CY. also INCY <> 0, same energy, same rule πŸ’€
!>          INCY is INTEGER
!>          The increment between successive values of CY.  INCY <> 0.
  • C β€” C is COMPLEX. one half of the transformation duo 🫢
!>          C is COMPLEX
  • S β€” S is COMPLEX. and here's the combo meal β€” C and S define the matrix:
!>          S is COMPLEX
!>          C and S define the matrix
!>             [  C   S  ].
!>             [ -S   C  ]

look at that matrix. symmetric-ish, complex, adorable. she ate 🌈


🌟 Author 🌟

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

and per the docs: Definition at line 104 of file clacrt.f. πŸ“ a whole little address for your girl, iykyk.


πŸ‘‘ Author (the Doxygen one) πŸ‘‘

Generated automatically by Doxygen for LAPACK from the source code. like, no human wrote this page, a robot did, and she still served βœ¨πŸ€–


ok so real quick β€” this page is auto-generated from the source, so the "documentation" is a pile of !> comment lines reproduced faithfully. I kept every one of them exactly as-is because that's the assignment, bestie. no cap πŸŽ€

and that's the whole page, fr fr πŸ’œ huge thank you to LAPACK, Version 3.12.0, and shoutout to /home/abui...RC/clacrt.f(3) β€” you did that, toodles bestie, go call CLACRT responsibly πŸ’…πŸ¦‹πŸŒΈ

πŸ“¦ where this page comes from