收集

将分布式数组或gpuArray转移到本地工作区

折叠所有页面

语法

X =收集(A)

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

X =收集(C、实验室)

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

描述

例子

X =收集(一个）可以对以下阵列数据进行操作:

在gpuArray上:传输的元素一个从GPU到本地工作区，并将它们分配给X．
在分布式数组上，在spmd语句:集合元素一个从多个工作人员到本地工作区，并将它们分配给X．
在一个协分布数组中spmd陈述或沟通工作:将下列要素集合在一起一个并将它们复制成X在每一个工人。

你可以叫收集其他数据类型，如高数组(参见收集(高)）.如果数据类型不支持收集，则万博1manbetx收集没有效果。

收集GPU阵列或分布式阵列成本很高，通常没有必要，除非您需要将结果与不支持这些类型阵列的函数一起使用。万博1manbetx有关函数支持的更多信息，请参见万博1manbetx在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，这样所有的元素都包含在worker上实验室,X是所有其他工人的一个0乘0的空替身。

(X1, X2,…，Xn] = gather(C1,C2,...,Cn,lab)收集codistributed数组C1, C2,…,Cn到相应的输出X1, X2,…,Xn，所有元素都在worker上实验室．输入参数和输出参数的数量必须匹配。

例子

全部折叠

收集gpuArrays

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

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

Name Size Bytes Class Attributes 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在worker 1上，用于不能跨分布式数组执行的操作。

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

Worker 1: areDiagonalsEqual = logical 1

输入参数

全部折叠

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

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

提示

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

随着收集函数需要所有工作人员之间的通信，您不能通过将函数放在一个条件语句中(例如)来将所有工作人员的数据收集到单个工作人员上如果labindex == 1．