pbdDMAT (version 0.5-1)

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 {
spmd.code = "
  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()
"

pbdMPI::execmpi(spmd.code = spmd.code, nranks = 2L)

# }