pbdBASE (version 0.1-1)

as.matrix: Distributed-to-non-distributed Matrix Converters

Description

Converts objects of class ddmatrix to the requested non-distributed type.

Usage

## S3 method for class 'ddmatrix':
as.vector(x, mode = 'any', proc.dest = 'all')
  ## S3 method for class 'ddmatrix':
as.matrix(x, proc.dest = 'all')

Arguments

x

numeric distributed matrix

proc.dest

destination process for storing the matrix

mode

A character string giving an atomic mode or "list", or (except for 'vector') "any".

Value

• Returns an ordinary R matrix.

Details

Converts a distributed matrix into a non-distributed vector or matrix. 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

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

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

# don't do this in production code
x <- matrix(1:16, ncol=4)
dx <- as.ddmatrix(x) 

y <- as.matrix(dx, proc.dest=0)

finalize()