version 1.6, 2010/08/13 21:04:10
|
version 1.13, 2014/01/27 09:28:39
|
Line 1
|
Line 1
|
|
*> \brief \b ZLARNV returns a vector of random numbers from a uniform or normal distribution. |
|
* |
|
* =========== DOCUMENTATION =========== |
|
* |
|
* Online html documentation available at |
|
* http://www.netlib.org/lapack/explore-html/ |
|
* |
|
*> \htmlonly |
|
*> Download ZLARNV + dependencies |
|
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/zlarnv.f"> |
|
*> [TGZ]</a> |
|
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/zlarnv.f"> |
|
*> [ZIP]</a> |
|
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/zlarnv.f"> |
|
*> [TXT]</a> |
|
*> \endhtmlonly |
|
* |
|
* Definition: |
|
* =========== |
|
* |
|
* SUBROUTINE ZLARNV( IDIST, ISEED, N, X ) |
|
* |
|
* .. Scalar Arguments .. |
|
* INTEGER IDIST, N |
|
* .. |
|
* .. Array Arguments .. |
|
* INTEGER ISEED( 4 ) |
|
* COMPLEX*16 X( * ) |
|
* .. |
|
* |
|
* |
|
*> \par Purpose: |
|
* ============= |
|
*> |
|
*> \verbatim |
|
*> |
|
*> ZLARNV returns a vector of n random complex numbers from a uniform or |
|
*> normal distribution. |
|
*> \endverbatim |
|
* |
|
* Arguments: |
|
* ========== |
|
* |
|
*> \param[in] IDIST |
|
*> \verbatim |
|
*> 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 |
|
*> \endverbatim |
|
*> |
|
*> \param[in,out] ISEED |
|
*> \verbatim |
|
*> 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. |
|
*> \endverbatim |
|
*> |
|
*> \param[in] N |
|
*> \verbatim |
|
*> N is INTEGER |
|
*> The number of random numbers to be generated. |
|
*> \endverbatim |
|
*> |
|
*> \param[out] X |
|
*> \verbatim |
|
*> X is COMPLEX*16 array, dimension (N) |
|
*> The generated random numbers. |
|
*> \endverbatim |
|
* |
|
* Authors: |
|
* ======== |
|
* |
|
*> \author Univ. of Tennessee |
|
*> \author Univ. of California Berkeley |
|
*> \author Univ. of Colorado Denver |
|
*> \author NAG Ltd. |
|
* |
|
*> \date September 2012 |
|
* |
|
*> \ingroup complex16OTHERauxiliary |
|
* |
|
*> \par Further Details: |
|
* ===================== |
|
*> |
|
*> \verbatim |
|
*> |
|
*> 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. |
|
*> \endverbatim |
|
*> |
|
* ===================================================================== |
SUBROUTINE ZLARNV( IDIST, ISEED, N, X ) |
SUBROUTINE ZLARNV( IDIST, ISEED, N, X ) |
* |
* |
* -- LAPACK auxiliary routine (version 3.2) -- |
* -- LAPACK auxiliary routine (version 3.4.2) -- |
* -- LAPACK is a software package provided by Univ. of Tennessee, -- |
* -- LAPACK is a software package provided by Univ. of Tennessee, -- |
* -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..-- |
* -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..-- |
* November 2006 |
* September 2012 |
* |
* |
* .. Scalar Arguments .. |
* .. Scalar Arguments .. |
INTEGER IDIST, N |
INTEGER IDIST, N |
Line 13
|
Line 112
|
COMPLEX*16 X( * ) |
COMPLEX*16 X( * ) |
* .. |
* .. |
* |
* |
* Purpose |
|
* ======= |
|
* |
|
* ZLARNV returns a vector of n random complex numbers from a uniform or |
|
* normal distribution. |
|
* |
|
* Arguments |
|
* ========= |
|
* |
|
* IDIST (input) 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 (input/output) 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 (input) INTEGER |
|
* The number of random numbers to be generated. |
|
* |
|
* X (output) COMPLEX*16 array, dimension (N) |
|
* The generated random numbers. |
|
* |
|
* 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. |
|
* |
|
* ===================================================================== |
* ===================================================================== |
* |
* |
* .. Parameters .. |
* .. Parameters .. |