Parallel Computing Toolbox™

eye - Create distributed identity matrix

Syntax

D = eye(n, dist)
D = eye(m, n, dist)
D = eye([m, n], dist)
D = eye(..., classname, dist)

Description

D = eye(n, dist) creates an n-by-n distributed array of underlying class double. D is distributed by dimension dim, where dim = distributionDimension(dist), and with partition scheme PAR, where PAR = distributionPartition(dist). If dim is unspecified, then D is distributed by its second dimension. If PAR is unspecified, then D uses defaultPartition(n) as its partition. The easiest way to do this is to use a default distributor where both dim and PAR are unspecified (dist = distributor()) as input to eye.

D = eye(m, n, dist) and D = eye([m, n], dist) create an m-by-n distributed array of underlying class double. The distribution dimension dim and partition PAR can be specified by dist as above, but if they are not specified, dim is taken to be the last nonsingleton dimension of D, and PAR is provided by defaultPartition over the size in that dimension.

D = eye(..., classname, dist) optionally specifies the class of the distributed array D. Valid choices are the same as for the regular eye function: 'double' (the default), 'single', 'int8', 'uint8', 'int16', 'uint16', 'int32', 'uint32', 'int64', and 'uint64'.

Examples

With four labs,

D = eye(1000, distributor())

creates a 1000-by-1000 distributed double array D, distributed by its second dimension (columns). Each lab contains a 1000-by-250 local piece of D.

D = eye(10, 10, 'uint16', distributor('1d', 2, 1:numlabs))

creates a 10-by-10 distributed uint16 array D, distributed by its columns. Each lab contains a 10-by-labindex local piece of D.

See Also

eye MATLAB^® function reference page

cell, false, Inf, NaN, ones, rand, randn, sparse, speye, sprand, sprandn, true, zeros

distributor

false