pbdBASE (version 0.5-3)

base.ownany: Determining Local Ownership of a Distributed Matrix

Description

For advanced users only. See pbdDMAT for high-level functions.

Usage

base.ownany(dim, bldim, ICTXT = 0)

Arguments

dim

global dimension

bldim

blocking dimension

ICTXT

BLACS context

Value

TRUE or FALSE

Details

A simple wrapper of numroc. The return is the answer to the question 'do I own any of the global matrix?'. Passing a distributed matrix is allowed, but often it is convenient to determine that information without even having a distributed matrix on hand. In this case, explicitly passing the appropriate information to the arguments dim=, bldim= (and CTXT= as necessary, since it defaults to 0) while leaving x missing will produce the desired result. See the examples below for more clarity.

The return for each function is local.

Examples

# NOT RUN {
spmd.code <- "
  suppressMessages(library(pbdMPI))
  suppressMessages(library(pbdBASE))
  init.grid()

  iown <- base.ownany(dim=c(4, 4), bldim=c(4, 4), ICTXT=0)
  comm.print(iown, all.rank = TRUE)

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

# }