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.