# larnv - Man Page

larnv: random vector

## Synopsis

### Functions

subroutine clarnv (idist, iseed, n, x)
CLARNV returns a vector of random numbers from a uniform or normal distribution.
subroutine dlarnv (idist, iseed, n, x)
DLARNV returns a vector of random numbers from a uniform or normal distribution.
subroutine slarnv (idist, iseed, n, x)
SLARNV returns a vector of random numbers from a uniform or normal distribution.
subroutine zlarnv (idist, iseed, n, x)
ZLARNV returns a vector of random numbers from a uniform or normal distribution.

## Function Documentation

### subroutine clarnv (integer idist, integer, dimension( 4 ) iseed, integer n, complex, dimension( * ) x)

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

Purpose:

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

IDIST

IDIST is 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

ISEED is 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

N is INTEGER
The number of random numbers to be generated.

X

X is COMPLEX array, dimension (N)
The generated random numbers.
Author

Univ. of Tennessee

Univ. of California Berkeley

NAG Ltd.

Further Details:

This routine calls the auxiliary routine SLARUV 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.

Definition at line 98 of file clarnv.f.

### subroutine dlarnv (integer idist, integer, dimension( 4 ) iseed, integer n, double precision, dimension( * ) x)

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

Purpose:

DLARNV returns a vector of n random real numbers from a uniform or
normal distribution.
Parameters

IDIST

IDIST is INTEGER
Specifies the distribution of the random numbers:
= 1:  uniform (0,1)
= 2:  uniform (-1,1)
= 3:  normal (0,1)

ISEED

ISEED is 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

N is INTEGER
The number of random numbers to be generated.

X

X is DOUBLE PRECISION array, dimension (N)
The generated random numbers.
Author

Univ. of Tennessee

Univ. of California Berkeley

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.

Definition at line 96 of file dlarnv.f.

### subroutine slarnv (integer idist, integer, dimension( 4 ) iseed, integer n, real, dimension( * ) x)

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

Purpose:

SLARNV returns a vector of n random real numbers from a uniform or
normal distribution.
Parameters

IDIST

IDIST is INTEGER
Specifies the distribution of the random numbers:
= 1:  uniform (0,1)
= 2:  uniform (-1,1)
= 3:  normal (0,1)

ISEED

ISEED is 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

N is INTEGER
The number of random numbers to be generated.

X

X is REAL array, dimension (N)
The generated random numbers.
Author

Univ. of Tennessee

Univ. of California Berkeley

NAG Ltd.

Further Details:

This routine calls the auxiliary routine SLARUV 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.

Definition at line 96 of file slarnv.f.

### 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.
Parameters

IDIST

IDIST is 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

ISEED is 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

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

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.

Definition at line 98 of file zlarnv.f.

## Author

Generated automatically by Doxygen for LAPACK from the source code.

## Info

Tue Nov 28 2023 12:08:43 Version 3.12.0 LAPACK