收集

将分布式阵列或gpu阵列转移到本地工作区

在页面中全部折叠

语法

X =收集(A)

(X1, X2,…，Xn] = gather(A1,A2,...,,Xn)

X =收集(C,目的地)

(X1, X2,…，Xn] = gather(C1,C2,...,Cn,destination)

描述

例子

X =收集(一个）可以操作以下数组数据:

在一个gpuArray:转换元素一个从GPU到本地工作区，并分配给它们X．
在分布式阵列上，在spmd语句:集合元素一个从多个工作者到本地工作区，并将它们分配到X．
在一个共分布数组中spmd陈述或沟通工作:集合…的要素一个把它们复制成X在每一个工人。

你可以叫收集其他数据类型，例如高数组(参见收集(高))．如果数据类型不支持收集，则收集没有效果。

收集GPU阵列或分布式阵列的成本很高，通常没有必要，除非你需要使用不支持这些类型的阵列的函数。有关函数支持的更多信息，请参见在图形处理器上运行MATLAB函数或运行MATLAB函数与分布式数组．

X =收集(gpuArray (X))，X =收集(分布式(X)),或X =收集(codistributed (X))返回原始数组X．

(X1, X2,…，Xn] = gather(A1,A2,...,,Xn)收集多个数组A1, A2,…,,对应的输出X1, X2,…,Xn．输入参数和输出参数的数量必须匹配。

例子

X =收集(C,目的地)转换共分布数组C到一个变体数组X所指定的工作者上包含所有元素目的地,X是所有其他工位上的0 × 0空双工。

(X1, X2,…，Xn] = gather(C1,C2,...,Cn,destination)收集codistributed数组C1, C2,…,Cn到相应的输出X1, X2,…,Xn所指定的工作者上的所有元素目的地．输入参数和输出参数的数量必须匹配。

例子

全部折叠

收集gpuArrays

将GPU操作的结果收集到MATLAB中^®工作区。

G = gpuArray (rand (1024 1));F = sqrt (G);%输入和输出都是gpuArrayW =收集(G);返回数组到工作区谁

名称大小字节类属性F 1024x1 8192 gpuArray G 1024x1 8192 gpuArray W 1024x1 8192 double

收集分布式阵列

从分布式数组中收集所有元素D到客户端。

n = 10;parpool (“过程”4);D =分布式(魔法(n));将数组分配给工人M =聚(D)返回数组到客户端

收集Codistributed数组

在你的工人中分配一个魔方，然后将整个矩阵聚集到每个工人，然后到客户端。此代码的结果相当于M =魔法(n)所有员工和客户。

n = 10;parpool (“过程”4);spmdC = codistributed(魔法(n));M =收集(C)为所有工人收集所有元素结束S =收集(C)收集元素到客户端

收集所有的元素C到工作者1上，用于不能跨分布式数组执行的操作。

n = 10;spmdC = codistributed(魔法(n));=收集(C, 1);如果spmdIndex = = 1%此魔方的特征和:characteristicSum = (1: n ^ 2) / n;%确保对角线和等于%和特点:areDiagonalsEqual = isequal.．.(跟踪(出),跟踪(flipud ()), characteristicSum)结束结束

Worker 1: areDiagonalsEqual = logical 1

输入参数

全部折叠

`一个`- - - - - -数组来收集
gpuArray|分布式阵列|codistributed数组

要收集的数组，指定为gpuArray、分布式阵列或共分布式阵列。

提示

请注意,收集分别在其执行的所有worker的工作空间或MATLAB客户端上组装共分布或分布式数组，但不能两者都装配。如果你正在使用收集在一个spmd语句，则可以在客户机上通过其对应的复合对象;看到使用复合材料访问工作者变量．如果你在跑步收集在通信作业中，可以将收集的数组作为任务的输出参数返回给客户端。

随着收集函数需要所有worker之间的通信，您不能通过将函数放在一个条件语句中来将所有worker的数据收集到单个worker上if spmdIndex == 1．