Creates and initializes an abstract random stream for single precision floating-point arrays.
Syntax
Fortran:
status = vslsnewabstractstream( stream, n, sbuf, a, b, scallback )
C:
status = vslsNewAbstractStream( &stream, n, sbuf, a, b, scallback );
Include Files
The FORTRAN 77 interfaces are specified in the mkl_vsl.f77 include file, the Fortran 90 interfaces are specified in the mkl_vsl.f90 include file, and the C interfaces are specified in the mkl_vsl_functions.h include file.
Input Parameters
Name |
Type |
Description |
|---|---|---|
n |
FORTRAN 77: INTEGER Fortran 90: INTEGER, INTENT(IN) C: const int |
Size of the array sbuf |
sbuf |
FORTRAN 77: REAL Fortran 90: REAL, INTENT(IN) C: const float |
Array of n single precision floating-point random numbers with uniform distribution over interval (a,b) |
a |
FORTRAN 77: REAL Fortran 90: REAL, INTENT(IN) C: const float |
Left boundary a |
b |
FORTRAN 77: REAL Fortran 90: REAL, INTENT(IN) C: const float |
Right boundary b |
scallback |
See Note below |
Fortran: Address of the callback function used for update of the array sbuf C: Pointer to the callback function used for update of the array sbuf |
Output Parameters
Name |
Type |
Description |
|---|---|---|
stream |
FORTRAN 77: INTEGER*4 stream(2) Fortran 90: TYPE(VSL_STREAM_STATE), INTENT(OUT) C: VSLStreamStatePtr* |
Descriptor of the stream state structure |
Note
Format of the callback function in FORTRAN 77: INTEGER FUNCTION SUPDATEFUNC( stream, n, ibuf, nmin, nmax, idx )INTEGER*4 stream(2)INTEGER nREAL sbuf(n)INTEGER nminINTEGER nmaxINTEGER idx
Format of the callback function in Fortran 90: INTEGER FUNCTION SUPDATEFUNC[C]( stream, n, sbuf, nmin, nmax, idx )TYPE(VSL_STREAM_STATE),POINTER :: stream[reference]INTEGER(KIND=4),INTENT(IN) :: n[reference]REAL(KIND=4), INTENT(OUT) :: sbuf[reference](0:n-1)INTEGER(KIND=4),INTENT(IN) :: nmin[reference]INTEGER(KIND=4),INTENT(IN) :: nmax[reference]INTEGER(KIND=4),INTENT(IN) :: idx[reference]
Format of the callback function in C: int sUpdateFunc( VSLStreamStatePtr stream, int* n, float sbuf[], int* nmin, int* nmax, int* idx );
The callback function returns the number of elements in the array actually updated by the function. Table scallback Callback Function Parameters gives the description of the callback function parameters.
Parameters |
Short Description |
|---|---|
stream |
Abstract random stream descriptor |
n |
Size of sbuf |
sbuf |
Array of random numbers associated with the stream stream |
nmin |
Minimal quantity of numbers to update |
nmax |
Maximal quantity of numbers that can be updated |
idx |
Position in cyclic buffer sbuf to start update 0≤idx<n. |
Description
The sNewAbstractStream function creates a new abstract stream for single precision floating-point arrays with random numbers of the uniform distribution over interval (a,b). The function associates the stream with a single precision array sbuf and your callback function scallback that is intended for updating of sbuf content.