User`s guide

R2009b
12-2
New Distributed Arrays
A new form of distributed arrays provides direct access from the client to data stored on
the workers in a MATLAB pool. Distributed arrays have the same appearance and rules
of indexing as regular arrays.
You can distribute an existing array from the client workspace with the command
D = distributed(X)
where X is an array in the client, and D is a distributed array with its data on the
workers in the MATLAB pool. Distributing an array is performed outside an spmd
statement, but a MATLAB pool must be open.
Codistributed arrays that you create on the workers within spmd statements are
accessible on the client as distributed arrays.
The following new functions and methods support distributed arrays.
Function Name Description
distributed Distribute existing array from client workspace
to workers
distributed.rand, distributed.ones, etc. Create distributed array consistent with
indicated method, constructing on workers only
gather Transfer data from MATLAB pool workers to
client
isdistributed True for distributed array
C(x,y) Indexing into distributed array C on client to
access data stored as codistributed arrays on
workers
Renamed codistributor Functions
As part of the general enhancements for distributed arrays, several changes to the
codistributed interface appear in this release.
Compatibility Considerations
The following table summarizes the changes in function names relating to codistributed
arrays.