1. Manuals
  2. Tumbleweed
  3. lapack-man
  4. larnv(3)

Scroll to navigation

larnv(3) Library Functions Manual 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.
!>

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

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

Definition at line 98 of file zlarnv.f.

Author

Generated automatically by Doxygen for LAPACK from the source code.

Version 3.12.0 LAPACK