mpi.init.sprng {Rmpi}R Documentation

Interface to rsprng for initializing SPRNG

Description

mpi.init.sprng is used to initialize the parallel random number generator (PRNG) states in MPI environment. It is a collective call so all members in a comm must call it together.

Usage

mpi.init.sprng(seed = runif(1, 1, 2^31-1), 
                   kindprng = "default",
                   para = 0,
                   rank = 0,
                   comm = 1)

Arguments

seed an integer of random number seed.
kindprng a character string of the desired kind of parallel random number generator.
para additional parameters for the parallel random number generators. If para is 0, default parameters for each PRNG are used. When invalid parameter is given, a warning is issued and the default parameter is used.
rank the sender who distributes seed, kindprng, para to other members in a comm, i.e., other members' seed, kindprng, and para are ignored.
comm a comm number.

Value

Return the a two-element character vector of the RNG and normal kinds in use before the call.

Warning

When sprng is not used any more, please run free.sprng on all slaves and master to set back to R default RNG. If not doing so, an error message will come out like ".Random.seed[1] = 5 but no user-supplied generator" in the next session. One quick remedy is rm(.Random.seed).

Author(s)

Hao Yu

References

SPRNG: Scalable Parallel Random Number Generator Library Web Page. http://sprng.cs.fsu.edu/

See Also

init.sprng


[Package Rmpi version 0.5-5 Index]