Computational Setup Functions


Functions used internally to setup the computational environment.

setupBackend sets up a foreach backend given some specifications.

setupSharedMemory checks if one can use the packages bigmemory and sychronicity to speed-up parallel computations when not keeping all the fits. When both these packages are available, only one result per host is written on disk, with its achieved deviance stored in shared memory, that is accessible to all cores on a same host. It returns TRUE if both packages are available and NMF option 'shared' is toggled on.

setupTempDirectory creates a temporary directory to store the best fits computed on each host. It ensures each worker process has access to it.

setupLibPaths add the path to the NMF package to each workers' libPaths.

setupRNG sets the RNG for use by the function nmf. It returns the old RNG as an rstream object or the result of set.seed if the RNG is not changed due to one of the following reason: - the settings are not compatible with rstream


setupBackend(spec, backend, optional = FALSE, verbose = FALSE)



setupLibPaths(pkg = "NMF", verbose = FALSE)

setupRNG(seed, n, verbose = FALSE)


target parallel specification: either TRUE or FALSE, or a single numeric value that specifies the number of cores to setup.
value from argument .pbackend of nmf.
a logical that indicates if the specification must be fully satisfied, throwing an error if it is not, or if one can switch back to sequential, only outputting a verbose message.
logical or integer level of verbosity for message outputs.
package name whose path should be exported the workers.
initial RNG seed specification
number of RNG seeds to generate


Returns FALSE if no foreach backend is to be used, NA if the currently registered backend is to be used, or, if this function call registered a new backend, the previously registered backend as a foreach object, so that it can be restored after the computation is over.