Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 7/13/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

?larnd

Returns a random real number from a uniform or normal distribution.

Syntax

res = slarnd( idist, iseed )

res = dlarnd( idist, iseed )

res = clarnd( idist, iseed )

res = zlarnd( idist, iseed )

Include Files

  • mkl.fi

Description

The routine ?larnd returns a random number from a uniform or normal distribution.

Input Parameters

idist

INTEGER. Specifies the distribution of the random numbers. For slarnd and dlanrd:

= 1: uniform (0,1)

= 2: uniform (-1,1)

= 3: normal (0,1).

For clarnd and zlanrd:

= 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

INTEGER. Array, size 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.

Output Parameters

iseed

INTEGER.

On exit, the seed is updated.

res

REAL for slarnd,

DOUBLE PRECISION for dlarnd,

COMPLEX for clarnd,

DOUBLE COMPLEX for zlarnd,

Random number.