ZLAPMR(3)

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

πŸ’… NAME πŸ’…

okay so this is the manual page for zlapmr(3) β€” a "Library Functions Manual" entry, and the whole vibe is that it documents a file living at

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

bestie that path is long but we respect it 🫢


✨ SYNOPSIS ✨

Functions/Subroutines

subroutine ZLAPMR (forwrd, m, n, x, ldx, k)

ZLAPMR rearranges rows of a matrix as specified by a permutation vector. that's literally the whole job, no cap πŸŽ€


🌸 Function/Subroutine Documentation 🌸

subroutine ZLAPMR (logical forwrd, integer m, integer n, complex*16,
    dimension( ldx, * ) x, integer ldx, integer, dimension( * ) k)

ZLAPMR rearranges rows of a matrix as specified by a permutation vector. yes she's that girl πŸ’…

πŸ¦‹ Purpose πŸ¦‹

!>
!> ZLAPMR rearranges the rows of the M by N matrix X as specified
!> by the permutation K(1),K(2),...,K(M) of the integers 1,...,M.
!> If FORWRD = .TRUE.,  forward permutation:
!>
!>      X(K(I),*) is moved X(I,*) for I = 1,2,...,M.
!>
!> If FORWRD = .FALSE., backward permutation:
!>
!>      X(I,*) is moved to X(K(I),*) for I = 1,2,...,M.
!>

so like β€” you hand her a permutation K(1),K(2),...,K(M) of the integers 1,...,M and she shuffles the rows of your M by N matrix X around accordingly. one direction or the other, your call, main character energy ⭐

πŸŽ€ Parameters πŸŽ€

  • FORWRD β€” FORWRD is LOGICAL, and it picks the direction, iconic:
!>          FORWRD is LOGICAL
!>          = .TRUE., forward permutation
!>          = .FALSE., backward permutation
!>
  • M β€” M is INTEGER, the number of rows of the matrix X. and M >= 0. (yes, zero rows is legal, we love an edge case πŸ™ˆ)
!>          M is INTEGER
!>          The number of rows of the matrix X. M >= 0.
!>
  • N β€” N is INTEGER, the number of columns of the matrix X. also N >= 0. ✨
!>          N is INTEGER
!>          The number of columns of the matrix X. N >= 0.
!>
  • X β€” X is COMPLEX*16 array, dimension (LDX,N). on entry she's holding the M by N matrix X, and on exit X contains the permuted matrix X. glow-up complete πŸ’–
!>          X is COMPLEX*16 array, dimension (LDX,N)
!>          On entry, the M by N matrix X.
!>          On exit, X contains the permuted matrix X.
!>
  • LDX β€” LDX is INTEGER, the leading dimension of the array X, and she is not flexible about it: LDX >= MAX(1,M). 🫢
!>          LDX is INTEGER
!>          The leading dimension of the array X, LDX >= MAX(1,M).
!>
  • K β€” K is INTEGER array, dimension (M). on entry, K contains the permutation vector. and here's the cute part: K is used as internal workspace, but it gets reset to its original value on output. she borrows your stuff and puts it back, we stan πŸ˜­πŸ‘‘
!>          K is INTEGER array, dimension (M)
!>          On entry, K contains the permutation vector. K is used as
!>          internal workspace, but reset to its original value on
!>          output.
!>

🌈 Author 🌈

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

Definition at line 103 of file zlapmr.f. 🧚


⭐ Author ⭐

Generated automatically by Doxygen for LAPACK from the source code. (not a human, just vibes and a parser πŸ“)


and that's the whole page, bestie β€” LAPACK, Version 3.12.0, dated the same as that very long /home/abui...RC/zlapmr.f(3) path up top. go forth and permute responsibly πŸ’œβœ¨

πŸ“¦ where this page comes from