ZLARNV(3)

💅 ZLARNV(3) — Library Functions Manual 💅

okay bestie, this is the ZLARNV(3) page from the Library Functions Manual, and the raw header keeps pointing at /home/abui...RC/zlarnv.f(3) (twice, because it's dramatic like that). This routine is giving random complex numbers, and we're obsessed. Let's get into the lore ✨

🌸 NAME 🌸

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

✨ SYNOPSIS ✨

🌟 Functions/Subroutines 🌟

subroutine ZLARNV (idist, iseed, n, x)

ZLARNV returns a vector of random numbers from a uniform or normal distribution.

💖 Function/Subroutine Documentation 💖

subroutine ZLARNV (integer idist, integer, dimension( 4 ) iseed, integer n,
    complex*16, dimension( * ) x)

ZLARNV returns a vector of random numbers from a uniform or normal distribution.

🦋 Purpose 🦋

ZLARNV returns a vector of n random complex numbers from a uniform or normal distribution. (The source wraps this in those little Doxygen !> comment markers, iykyk.)

🌸 Parameters 🌸

• IDIST — IDIST is INTEGER. It specifies the distribution of the random numbers:
  • = 1: real and imaginary parts each uniform (0,1)
  • = 2: real and imaginary parts each uniform (-1,1)
  • = 3: real and imaginary parts each normal (0,1)
  • = 4: uniformly distributed on the disc abs(z) < 1
  • = 5: uniformly distributed on the circle abs(z) = 1
• ISEED — ISEED is INTEGER array, dimension (4). On entry, it's the seed of the random number generator; the array elements must be between 0 and 4095, and ISEED(4) must be odd. On exit, the seed is updated. (Yes, odd. It's a whole thing 💅)
• N — N is INTEGER. The number of random numbers to be generated.
• X — X is COMPLEX*16 array, dimension (N). The generated random numbers.

👑 Author 👑

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

🔥 Further Details 🔥

This routine calls the auxiliary routine DLARUV to generate random real numbers from a uniform (0,1) distribution, in batches of up to 128 using vectorisable code. The Box-Muller method is used to transform numbers from a uniform to a normal distribution. No cap, that's the whole tea ☕

Definition at line 98 of file zlarnv.f.

🧚 Author 🧚

Generated automatically by Doxygen for LAPACK from the source code.

---

okay bestie, that's the whole page 🫶. The footer facts are LAPACK Version 3.12.0 and /home/abui...RC/zlarnv.f(3) — no separate date line is listed, so that's the cute little sign-off, mwah 💋✨