Scroll to navigation

larnv(3) LAPACK larnv(3)

NAME

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

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.

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.

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

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.

Author

Generated automatically by Doxygen for LAPACK from the source code.

Wed Feb 7 2024 11:30:40 Version 3.12.0