codistributed.cell
Create codistributed cell array
Syntax
C = codistributed.cell(n)
C = codistributed.cell(m,n,p,...)
C
= codistributed.cell([m,n,p,...])
C = cell(n,codist)
C = cell(m,n,p,...,codist)
C
= cell([m,n,p,...],codist)
Description
C = codistributed.cell(n)
creates an
n
-by-n
codistributed array of underlying
class cell, distributing along columns.
C = codistributed.cell(m,n,p,...)
or
C
= codistributed.cell([m,n,p,...])
creates an
m
-by-n
-by-p
-by-...
codistributed array of underlying class cell, using a default scheme of distributing
along the last nonsingleton dimension.
Optional arguments to codistributed.cell
must be specified
after the required arguments, and in the following order:
codist
— A codistributor object specifying the distribution scheme of the resulting array. If omitted, the array is distributed using the default distribution scheme. For information on constructing codistributor objects, see the reference pages forcodistributor1d
andcodistributor2dbc
.'noCommunication'
— Specifies that no communication is to be performed when constructing the array, skipping some error checking steps.
C = cell(n,codist)
is the same as C =
codistributed.cell(n, codist)
. You can also use the
'noCommunication'
object with this syntax. To use the default
distribution scheme, specify a codistributor constructor without arguments. For
example:
spmd C = cell(8,codistributor1d()); end
C = cell(m,n,p,...,codist)
and
C
= cell([m,n,p,...],codist)
are the same as C =
codistributed.cell(m,n,p,...)
and C =
codistributed.cell([m,n,p,...])
, respectively. You can also use the
optional 'noCommunication'
argument with this syntax.
Examples
With four workers,
spmd(4) C = codistributed.cell(1000); end
creates a 1000-by-1000 distributed cell array C
, distributed by
its second dimension (columns). Each worker contains a 1000-by-250 local piece of
C
.
spmd(4) codist = codistributor1d(2, 1:spmdSize); C = cell(10, 10, codist); end
creates a 10-by-10 codistributed cell array C
, distributed by
its columns. Each worker contains a 10-by-spmdIndex
local piece
of C
.
Version History
Introduced in R2009b