Main Content


Access elements of arrays distributed among workers in parallel pool



You can also create a codistributed array explicitly from spmd code or a communicating job task with any of several MATLAB functions.


Arrays partitioned among the workers in a pool, are accessible from the workers as codistributed array objects.

Codistributed arrays on workers that you create inside spmd statements or from within task functions of communicating jobs can be accessed as distributed arrays on the client.


InfCreate codistributed array of all Inf values
NaNCreate codistributed array of all NaN values
classUnderlying(Not recommended) Class of elements within gpuArray or distributed array
codistributed.cellCreate codistributed cell array
codistributed.colonDistributed colon operation
codistributed.spallocAllocate space for sparse codistributed matrix
codistributed.speyeCreate codistributed sparse identity matrix
codistributed.sprandCreate codistributed sparse array of uniformly distributed pseudo-random values
codistributed.sprandnCreate codistributed sparse array of normally distributed pseudo-random values
eyeCreate codistributed identity matrix
falseCreate codistributed array of logical 0 (false)
gatherTransfer distributed array or gpuArray to local workspace
getCodistributorCodistributor object for existing codistributed array
getLocalPartLocal portion of codistributed array
globalIndicesGlobal indices for local part of codistributed array
isaUnderlying(Not recommended) True if distributed array's underlying elements are of specified class
iscodistributedTrue for codistributed array
onesCreate codistributed array of all ones
randCreate codistributed array of uniformly distributed random numbers
randiCreate codistributed array of uniformly distributed random integers
randnCreate codistributed array of normally distributed random numbers
redistributeRedistribute codistributed array with another distribution scheme
sparseCreate codistributed sparse matrix
trueCreate codistributed array of logical 1 (true)
zerosCreate codistributed array of all zeros

The methods for codistributed arrays are too numerous to list here. Most resemble and behave the same as built-in MATLAB functions. See Run MATLAB Functions with Distributed Arrays.

Also among the methods there are several for examining the characteristics of the array itself. Most behave like the MATLAB functions of the same name:

iscodistributedDetermine if array is codistributed
isrealDetermine if array elements are real
isUnderlyingTypeDetermine if underlying data in the array is of specified type
lengthLength of vector or largest array dimension
ndimsNumber of dimensions in the array
sizeSize of array dimensions
underlyingTypeClass (data type) of the underlying data in the array

Version History

Introduced in R2008b