zlarnv (l) - Linux Manuals

zlarnv: returns a vector of n random complex numbers from a uniform or normal distribution

NAME

ZLARNV - returns a vector of n random complex numbers from a uniform or normal distribution

SYNOPSIS

SUBROUTINE ZLARNV(
IDIST, ISEED, N, X )

    
INTEGER IDIST, N

    
INTEGER ISEED( 4 )

    
COMPLEX*16 X( * )

PURPOSE

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

ARGUMENTS

IDIST (input) INTEGER
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 (input/output) INTEGER array, dimension (4)
On entry, 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.
N (input) INTEGER
The number of random numbers to be generated.
X (output) COMPLEX*16 array, dimension (N)
The generated random numbers.

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.

Pages related to zlarnv

  • zlarnv (3)
  • zlar1v (l) - computes the (scaled) r-th column of the inverse of the sumbmatrix in rows B1 through BN of the tridiagonal matrix L D L^T - sigma I
  • zlar2v (l) - applies a vector of complex plane rotations with real cosines from both sides to a sequence of 2-by-2 complex Hermitian matrices,
  • zlarcm (l) - performs a very simple matrix-matrix multiplication
  • zlarf (l) - applies a complex elementary reflector H to a complex M-by-N matrix C, from either the left or the right
  • zlarfb (l) - applies a complex block reflector H or its transpose Haq to a complex M-by-N matrix C, from either the left or the right
  • zlarfg (l) - generates a complex elementary reflector H of order n, such that Haq * ( alpha ) = ( beta ), Haq * H = I
  • zlarfp (l) - generates a complex elementary reflector H of order n, such that Haq * ( alpha ) = ( beta ), Haq * H = I
  • zlarft (l) - forms the triangular factor T of a complex block reflector H of order n, which is defined as a product of k elementary reflectors
  • zlarfx (l) - applies a complex elementary reflector H to a complex m by n matrix C, from either the left or the right