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

## Detailed Description

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

Univ. of Colorado Denver

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

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.

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

Univ. of Colorado Denver

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**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.

Definition at line **98** of file **zlarnv.f**.

## Author

Generated automatically by Doxygen for LAPACK from the source code.