R: Utility functions for working with Random Number Generators

rngtools {rngtools} | R Documentation

## Utility functions for working with Random Number Generators

### Description

This package contains a set of functions for working with Random Number Generators (RNGs). In particular, it defines a generic S4 framework for getting/setting the current RNG, or RNG data that are embedded into objects for reproducibility.

### Details

Notably, convenient default methods greatly facilitate the way current RNG settings can be changed.

### Examples

    showRNG()
    s <- getRNG()
    RNGstr(s)
    RNGtype(s)

    # get what would be the RNG seed after set.seed
    s <- nextRNG(1234)
    showRNG(s)
    showRNG( nextRNG(1234, ndraw=10) )

    # change of RNG kind
    showRNG()
    k <- RNGkind()
    k[2L] <- 'Ahrens'
    try( RNGkind(k) )
    setRNG(k)
    showRNG()
    # set encoded kind
    setRNG(501L)
    showRNG()

    # use as set seed
    setRNG(1234)
    showRNG()
    r <- getRNG()

    # extract embedded RNG specifications
    runif(10)
    setRNG(list(1, rng=1234))
    rng.equal(r)

    # restore default RNG (e.g., after errors)
    RNGrecovery()
    showRNG()

[Package rngtools version 1.2.4 Index]