Provided by: liblapack-doc_3.12.0-3build1_all bug

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.