RNG: Extracting RNG Data from NMF Objects

In NMF: Algorithms and Framework for Nonnegative Matrix Factorization (NMF)

Extracting RNG Data from NMF Objects

Description

The nmf function returns objects that contain embedded RNG data, that can be used to exactly reproduce any computation. These data can be extracted using dedicated methods for the S4 generics getRNG and getRNG1.

Usage

  getRNG1(object, ...)

  .getRNG(object, ...)

Arguments

object	an R object from which RNG settings can be extracted, e.g. an integer vector containing a suitable value for .Random.seed or embedded RNG data, e.g., in S3/S4 slot rng or rng$noise.
...	extra arguments to allow extension and passed to a suitable S4 method .getRNG or .setRNG.

Methods

.getRNG

signature(object = "NMFfitXn"): Returns the RNG settings used for the best fit.

This method throws an error if the object is empty.

getRNG1

signature(object = "NMFfitX"): Returns the RNG settings used for the first NMF run of multiple NMF runs.

getRNG1

signature(object = "NMFfitX1"): Returns the RNG settings used to compute the first of all NMF runs, amongst which object was selected as the best fit.

getRNG1

signature(object = "NMFfitXn"): Returns the RNG settings used for the first run.

This method throws an error if the object is empty.

Examples

# For multiple NMF runs, the RNG settings used for the first run is also stored
V <- rmatrix(20,10)
res <- nmf(V, 3, nrun=3)
# RNG used for the best fit
getRNG(res)
# RNG used for the first of all fits
getRNG1(res)
# they may differ if the best fit is not the first one
rng.equal(res, getRNG1(res))

NMF documentation built on Sept. 11, 2024, 8:34 p.m.