pbdDMAT (version 0.4-2)

as.matrix: Distributed object to Matrix Converters

Description

Converts a distributed matrix into a non-distributed matrix.

Usage

# S4 method for ddmatrix
as.matrix(x, proc.dest = "all", attributes = TRUE)

Arguments

x

numeric distributed matrix

proc.dest

destination process for storing the matrix

attributes

logical, specifies whether or not the current attributes should be preserved.

...

Additional arguments.

Value

Returns an ordinary R matrix.

Details

The proc.dest= argument accepts either the BLACS grid position or the MPI rank if the user desires a single process to own the matrix. Alternatively, passing the default value of 'all' will result in all processes owning the matrix. If only a single process owns the undistributed matrix, then all other processes store NULL for that object.

Examples

# NOT RUN {
# Save code in a file "demo.r" and run with 2 processors by
# > mpiexec -np 2 Rscript demo.r

library(pbdDMAT, quiet = TRUE)
init.grid()

dx <- ddmatrix(1:16, ncol=4, bldim=2)
y <- as.matrix(dx, proc.dest=0)

comm.print(y)

finalize()
# }
# NOT RUN {
# }