RNGstr {rngtools} | R Documentation |
Formatting RNG Information
Description
These functions retrieve/prints formated information about RNGs.
Usage
RNGstr(object, n = 7L, ...)
RNGtype(object, ..., provider = FALSE)
showRNG(object = getRNG(), indent = "#", ...)
RNGinfo(object = getRNG(), ...)
RNGdigest(object = getRNG())
Arguments
object |
RNG seed (i.e. an integer vector), or an object that contains
embedded RNG data.
For |
n |
maximum length for a seed to be showed in full.
If the seed has length greater than |
... |
extra arguments passed to |
provider |
logical that indicates if the library that provides the RNG should also be returned as an extra element. |
indent |
character string to use as indentation prefix in the output
from |
Details
All functions can be called with objects that are – valid –
RNG seeds or contain embedded RNG data, but none of them change the current
RNG setting.
To effectively change the current settings on should use setRNG
.
Value
a single character string
RNGtype
returns a named character vector containing the types of the random number generator, which correspond
to the arguments accepted by base::RNGkind.
Note that starting with R 3.6, the vector has length 3, while in previous R versions it has length 2 (no sample.kind element).
Functions
-
RNGstr
: returns a description of an RNG seed as a single character string.It formats seeds by collapsing them in a comma separated string. By default, seeds that contain more than 7L integers, have their 3 first values collapsed plus a digest hash of the complete seed.
-
RNGtype
: extract the kinds of RNG and Normal RNG.It returns the same type of values as
RNGkind()
(character strings), except that it can extract the RNG settings from an object. Ifobject
is missing it returns the kinds of the current RNG settings, i.e. it is identical toRNGkind()
. -
showRNG
: displays human readable information about RNG settings. Ifobject
is missing it displays information about the current RNG. -
RNGinfo
: is equivalent toRNGtype
but returns a named list instead of an unnamed character vector.
Examples
# default is a 626-long integer
RNGstr()
# what would be the seed after seeding with set.seed(1234)
RNGstr(1234)
# another RNG (short seed)
RNGstr(c(401L, 1L, 1L))
# no validity check is performed
RNGstr(2:3)
# get RNG type
RNGtype()
RNGtype(provider=TRUE)
RNGtype(1:3)
# type from encoded RNG kind
RNGtype(107L)
# this is different from the following which treats 107 as a seed for set.seed
RNGtype(107)
showRNG()
# as after set.seed(1234)
showRNG(1234)
showRNG()
set.seed(1234)
showRNG()
# direct seeding
showRNG(1:3)
# this does not change the current RNG
showRNG()
showRNG(provider=TRUE)
# get info as a list
RNGinfo()
RNGinfo(provider=TRUE)
# from encoded RNG kind
RNGinfo(107)
# compute digest hash from RNG settings
RNGdigest()
RNGdigest(1234)
# no validity check is performed
RNGdigest(2:3)