User`s guide

11 Functions — Alphabetical List
11-40
codistributor
Create codistributor object for codistributed arrays
Syntax
codist = codistributor()
codist = codistributor('1d')
codist = codistributor('1d', dim)
codist = codistributor('1d', dim, part)
codist = codistributor('2dbc')
codist = codistributor('2dbc', lbgrid)
codist = codistributor('2dbc', lbgrid, blksize)
Description
There are two schemes for distributing arrays. The scheme denoted by the string '1d'
distributes an array along a single specified subscript, the distribution dimension, in a
noncyclic, partitioned manner. The scheme denoted by '2dbc', employed by the parallel
matrix computation software ScaLAPACK, applies only to two-dimensional arrays,
and varies both subscripts over a rectangular computational grid of labs (workers) in a
blocked, cyclic manner.
codist = codistributor(), with no arguments, returns a default codistributor object
with zero-valued or empty parameters, which can then be used as an argument to other
functions to indicate that the function is to create a codistributed array if possible with
default distribution. For example,
Z = zeros(..., codistributor())
R = randn(..., codistributor())
codist = codistributor('1d') is the same as codist = codistributor().
codist = codistributor('1d', dim) also forms a codistributor object with
codist.Dimension = dim and default partition.
codist = codistributor('1d', dim, part) also forms a codistributor object with
codist.Dimension = dim and codist.Partition = part.