Formatting RNG Information
These functions retrieve/prints formated information about RNGs.
RNGtype returns the same type of values as
RNGkind() (character strings), except that it can
extract the RNG settings from an object. If
is missing it returns the kinds of the current RNG
settings, i.e. it is identical to
showRNG displays human readable information about
RNG settings. If
object is missing it displays
information about the current RNG.
RNGinfo is equivalent to
returns a named list instead of an unnamed character
RNGdigest computes a hash from the RNG settings
associated with an object.
1 2 3 4 5 6 7 8 9
RNG seed (i.e. an integer vector), or an
object that contains embedded RNG data. For
maximum length for a seed to be showed in full.
If the seed has length greater than
logical that indicates if the library that provides the RNG should also be returned as a third element.
character string to use as indentation
prefix in the output from
extra arguments passed to
All functions can retrieve 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
RNGstr returns a description of an RNG seed as a
single character string.
RNGstr 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.
a single character string
RNGtype returns a 2 or 3-long character vector.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
# 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)
Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker.