Syntax

Description

X = gather(A)can operate inside anspmdstatement, pmode, or communicating job to gather together the elements of a codistributed array, or outside anspmdstatement to gather the elements of a distributed array. If you execute this inside anspmdstatement, pmode, or communicating job,Xis a replicated array with all the elements of the array on every worker. If you execute this outside anspmdstatement,Xis an array in the local workspace, with the elements transferred from the multiple workers.

X = gather(distributed(X))orX = gather(codistributed(X))returns the original arrayX.

X = gather(C,lab)converts a codistributed arrayCto a variant arrayX, such that all of the elements are contained on workerlab, andXis a 0-by-0 empty double on all other workers.

For a gpuArray input,X = gather(A)transfers the array elements from the GPU to the local workspace.

If the input argument togatheris not a distributed, a codistributed, or a gpuArray, the output is the same as the input.

Tips

Note thatgatherassembles the codistributed or distributed array in the workspaces of all the workers on which it executes, or on the MATLAB^®client, respectively, but not both. If you are usinggatherwithin anspmd声明中聚集数组的访问client via its correspondingCompositeobject; seeAccess Worker Variables with Composites. If you are runninggatherin a communicating job, you can return the gathered array to the client as an output argument from the task.

As thegatherfunction requires communication between all the workers, you cannot gather data from all the workers onto a single worker by placing the function inside a conditional statement such asif labindex == 1.

See Also

arrayfun|bsxfun|codistributed|distributed|gpuArray|pagefun|pmode