matlab composite,Create Composite object

Composite

Create Composite object

Syntax

C = Composite()

C = Composite(nlabs)

Description

C = Composite() creates a Composite object on the client

using workers from the parallel pool. The actual number of workers referenced by

this Composite object depends on the size of the pool and any existing Composite

objects. Generally, you should construct Composite objects outside any

spmd statement.

C = Composite(nlabs) creates a Composite object on the

parallel pool set that matches the specified constraint. nlabs

must be a vector of length 1 or 2, containing integers or Inf. If

nlabs is of length 1, it specifies the exact number of

workers to use. If nlabs is of size 2, it specifies the minimum

and maximum number of workers to use. The actual number of workers used is the

maximum number of workers compatible with the size of the parallel pool, and with

other existing Composite objects. An error is thrown if the constraints on the

number of workers cannot be met.

A Composite object has one entry for each lab; initially each entry contains no

data. Use either indexing or an spmd block to define values for

the entries.

Examples

The following examples all use a local parallel pool of four workers, opened with

the statement:

p = parpool('local',4);

This example shows how to create a Composite object with no defined elements, then

assign values using a for-loop in the client.

c = Composite(); % One element per worker in the pool

for w = 1:length(c)

c{w} = 0; % Value stored on each worker

end

This example shows how to assign Composite elements in an spmd

block.

c = Composite();

spmd

c = 0; % Value stored on each worker

end

This example shows how to assign the elements of a Composite with a value from

each worker.

c = Composite();

spmd

c = labindex;

end

c{:}

1

2

3

4

This example shows how to use a distributed array vector to set the values of a

Composite.

d = distributed([3 1 4 2]); % One integer per worker

spmd

c = getLocalPart(d); % Unique value on each worker

end

c{:}

3

1

4

2

Tips

A Composite is created on the workers of the existing parallel pool. If no

pool exists, Composite starts a new parallel pool, unless

the automatic starting of pools is disabled in your parallel preferences. If

there is no parallel pool and Composite cannot start one,

the result is a 1-by-1 Composite in the client workspace.