pull {bigGP}

Copy Object from Slave Processes to Master

Description

Copies all objects with a given name from the slave processes to the master process, returning a list with one element per slave process. Objects can be copied from lists, environments, and ReferenceClass objects as well as the global environment on the slave processes.

Usage

pull(objName, objPos = ".GlobalEnv", tag = 1)

Arguments

objName

a variable name, given as a character string, giving the name of the object on the slave processes.

objPos

where to look for the object, given as a character string (unlike get). This can indicate an environment, a list, or a ReferenceClass object.

tag

non-negative integer, as in mpi.send and mpi.recv. Use mpi.any.tag for any tag flag.

Value

pull returns a list, with one element per slave process.

Warning

Vectors and matrices that are part of the distributed linear algebra computations are broken up in very specific ways on the slave processes and often include padded elements. In general one should not use pull for retrieving such objects from the slave processes. Rather, use collectVector, CollectTriangularMatrix, etc.

See Also

push collectVector collectTriangularMatrix collectRectangularMatrix collectDiagonal

Examples

## Not run: 
bigGP.init(3)
a <- 3
push(a)
remoteLs()
pull('a')

## End(Not run)