ladiv(3)

πŸ’… ladiv(3)

okay so bestie, welcome to ladiv(3) β€” the LAPACK complex-division page, and honestly? it's giving "eight functions, one job, zero overflow." buckle up πŸŽ€


✨ NAME ✨

ladiv β€” ladiv: complex divide. that's it. that's the whole name. short, iconic, to the point. πŸ‘‘


🌸 SYNOPSIS 🌸

Functions

  • complex function cladiv (x, y) β€” CLADIV performs complex division in real arithmetic, avoiding unnecessary overflow. (real ones know πŸ’…)
  • subroutine dladiv (a, b, c, d, p, q) β€” DLADIV performs complex division in real arithmetic, avoiding unnecessary overflow.
  • subroutine dladiv1 (a, b, c, d, p, q) β€” no blurb for this one, it's mysterious like that πŸ™ˆ
  • double precision function dladiv2 (a, b, c, d, r, t) β€” also no blurb. silent. brooding. main character energy.
  • subroutine sladiv (a, b, c, d, p, q) β€” SLADIV performs complex division in real arithmetic, avoiding unnecessary overflow.
  • subroutine sladiv1 (a, b, c, d, p, q) β€” again, no description, we respect the mystery πŸ¦‹
  • real function sladiv2 (a, b, c, d, r, t) β€” same vibe, no blurb.
  • complex *16 function zladiv (x, y) β€” ZLADIV performs complex division in real arithmetic, avoiding unnecessary overflow.

🫢 Detailed Description 🫢

bestie. it's literally empty. nothing here. a whole heading with zero content. and you know what? we move. the actual tea is all in Function Documentation, so keep scrolling πŸ’–


πŸŽ€ Function Documentation πŸŽ€

complex function cladiv (complex x, complex y)

CLADIV performs complex division in real arithmetic, avoiding unnecessary overflow.

Purpose:

!>
!> CLADIV := X / Y, where X and Y are complex.  The computation of X / Y
!> will not overflow on an intermediary step unless the results
!> overflows.
!>

Parameters

  • X
!>          X is COMPLEX
!>
  • Y
!>          Y is COMPLEX
!>          The complex scalars X and Y.
!>

Author

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

Definition at line 63 of file cladiv.f.


subroutine dladiv (double precision a, double precision b, double precision c, double precision d, double precision p, double precision q)

DLADIV performs complex division in real arithmetic, avoiding unnecessary overflow.

Purpose:

!>
!> DLADIV performs complex division in  real arithmetic
!>
!>                       a + i*b
!>            p + i*q = ---------
!>                       c + i*d
!>
!> The algorithm is due to Michael Baudin and Robert L. Smith
!> and can be found in the paper
!>
!>

(ok the paper reference is just vibes, there's no citation in the source. we love a cryptic king πŸ”₯)

Parameters

  • A
!>          A is DOUBLE PRECISION
!>
  • B
!>          B is DOUBLE PRECISION
!>
  • C
!>          C is DOUBLE PRECISION
!>
  • D
!>          D is DOUBLE PRECISION
!>          The scalars a, b, c, and d in the above expression.
!>
  • P
!>          P is DOUBLE PRECISION
!>
  • Q
!>          Q is DOUBLE PRECISION
!>          The scalars p and q in the above expression.
!>

Author

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

Definition at line 90 of file dladiv.f.


subroutine dladiv1 (double precision a, double precision b, double precision c, double precision d, double precision p, double precision q)

no description. no purpose block. just a signature and a line number. the way this function simply exists 😭

Definition at line 176 of file dladiv.f.


double precision function dladiv2 (double precision a, double precision b, double precision c, double precision d, double precision r, double precision t)

zero description. zero parameters listed. just vibes and a source location, ngl.

Definition at line 215 of file dladiv.f.


subroutine sladiv (real a, real b, real c, real d, real p, real q)

SLADIV performs complex division in real arithmetic, avoiding unnecessary overflow.

Purpose:

!>
!> SLADIV performs complex division in  real arithmetic
!>
!>                       a + i*b
!>            p + i*q = ---------
!>                       c + i*d
!>
!> The algorithm is due to Michael Baudin and Robert L. Smith
!> and can be found in the paper
!>
!>

Parameters

  • A
!>          A is REAL
!>
  • B
!>          B is REAL
!>
  • C
!>          C is REAL
!>
  • D
!>          D is REAL
!>          The scalars a, b, c, and d in the above expression.
!>
  • P
!>          P is REAL
!>
  • Q
!>          Q is REAL
!>          The scalars p and q in the above expression.
!>

Author

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

Definition at line 90 of file sladiv.f.


subroutine sladiv1 (real a, real b, real c, real d, real p, real q)

no blurb, no parameters section, no author list β€” just the signature and where to find it. quiet luxury πŸ’…

Definition at line 176 of file sladiv.f.


real function sladiv2 (real a, real b, real c, real d, real r, real t)

same deal. no description. we stan a low-profile legend.

Definition at line 215 of file sladiv.f.


complex*16 function zladiv (complex*16 x, complex*16 y)

ZLADIV performs complex division in real arithmetic, avoiding unnecessary overflow.

Purpose:

!>
!> ZLADIV := X / Y, where X and Y are complex.  The computation of X / Y
!> will not overflow on an intermediary step unless the results
!> overflows.
!>

Parameters

  • X
!>          X is COMPLEX*16
!>
  • Y
!>          Y is COMPLEX*16
!>          The complex scalars X and Y.
!>

Author

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

Definition at line 63 of file zladiv.f.


πŸ‘‘ Author πŸ‘‘

Generated automatically by Doxygen for LAPACK from the source code. (yes bestie, a robot wrote this, and it ate πŸ€–βœ¨)


little reminder: the whole point of these routines is doing complex division in real arithmetic so it doesn't overflow on an intermediary step β€” the results themselves can still overflow, that part's not magic. πŸ’€

and that's the page! πŸ¦‹ LAPACK, Version 3.12.0, ladiv(3) β€” mwah, periodt. πŸ’–

πŸ“¦ where this page comes from