1CLARNV(1)           LAPACK auxiliary routine (version 3.1)           CLARNV(1)
2
3
4

NAME

6       CLARNV  - a vector of n random complex numbers from a uniform or normal
7       distribution
8

SYNOPSIS

10       SUBROUTINE CLARNV( IDIST, ISEED, N, X )
11
12           INTEGER        IDIST, N
13
14           INTEGER        ISEED( 4 )
15
16           COMPLEX        X( * )
17

PURPOSE

19       CLARNV returns a vector of n random complex numbers from a  uniform  or
20       normal distribution.
21
22

ARGUMENTS

24       IDIST   (input) INTEGER
25               Specifies the distribution of the random numbers:
26               = 1:  real and imaginary parts each uniform (0,1)
27               = 2:  real and imaginary parts each uniform (-1,1)
28               = 3:  real and imaginary parts each normal (0,1)
29               = 4:  uniformly distributed on the disc abs(z) < 1
30               = 5:  uniformly distributed on the circle abs(z) = 1
31
32       ISEED   (input/output) INTEGER array, dimension (4)
33               On  entry,  the  seed of the random number generator; the array
34               elements must be between 0 and 4095, and ISEED(4) must be  odd.
35               On exit, the seed is updated.
36
37       N       (input) INTEGER
38               The number of random numbers to be generated.
39
40       X       (output) COMPLEX array, dimension (N)
41               The generated random numbers.
42

FURTHER DETAILS

44       This routine calls the auxiliary routine SLARUV to generate random real
45       numbers from a uniform (0,1) distribution, in  batches  of  up  to  128
46       using  vectorisable  code.  The  Box-Muller method is used to transform
47       numbers from a uniform to a normal distribution.
48
49
50
51
52 LAPACK auxiliary routine (versionNo3v.e1m)ber 2006                       CLARNV(1)