codistributor1d

対話型分散配列の 1 次元分散スキーム

説明

codistributor1d オブジェクトを使用して対話型分散配列の 1 次元分散スキームを定義します。この 1 次元対話型分散では、配列を単一の特定次元 (分散次元) に沿って非巡回的に分割し、これを分散します。

作成

構文

codist = codistributor1d

codist = codistributor1d(Dimension)

codist = codistributor1d(Dimension,Partition)

codist = codistributor1d(Dimension,Partition,gsize)

説明

codist = codistributor1d は、既定の次元と分割を使用して codistributor1d オブジェクトを返します。既定の次元は、対話型分散配列の大きさが 1 でない最後の次元です。既定の分割では、既定の次元に沿ってできるだけ均等に配列を分散します。

codist = codistributor1d(Dimension) は、Dimension プロパティで指定された次元に沿って分散するための 1 次元の対話型分散オブジェクトを返します。たとえば、Dimension が 1 の場合、この関数は行に沿ってオブジェクトを分散させます。

codist = codistributor1d(Dimension,Partition) は、Partition プロパティで指定された分割ベクトルによる分散のための 1 次元の対話型分散オブジェクトも返します。たとえば、C1 = codistributor1d(1,[1,2,3,4]) は、10 行からなる配列を 4 つのワーカーに分散させます。1 行を最初のワーカーに、2 行を 2 番目のワーカーに、3 行を 3 番目のワーカーに、4 行を 4 番目のワーカーに分散させます。

上記の構文で形成される対話型分散は、いずれもグローバル サイズが指定されていないため、完全なものではありません。このような方法で作成された対話型分散は、対話型分散配列の作成時にテンプレート対話型分散として他の関数の引数の形で使用します。

codist = codistributor1d(Dimension,Partition,gsize) は、グローバル サイズ gsize の対話型分散オブジェクトを返します。

結果の対話型分散オブジェクトを使用して、codistributed.build によってそのローカル部分から対話型分散配列を作成できます。既定の次元を使用するには、Dimension プロパティに codistributor1d.unsetDimension を指定します。この関数では、分散次元が gsize から導出され、既定の次元として大きさが 1 ではない最後の次元が選択されます。同様に、既定の分割を使用するには、Partition プロパティに codistributor1d.unsetPartition を指定します。この関数では、グローバル サイズと分散次元から既定の分割が導出されます。

このような対話型分散を使用する対話型分散配列のワーカー workerIndex のローカル部分は、すべての次元でサイズが gsize になりますが、dimension だけはサイズが part(workerIndex) になります。ローカル部分のクラスおよび属性は対話型分散配列全体と同じです。次元 dimension に沿ってさまざまなローカル部分を連結することによりグローバル配列全体を復元することができます。

入力引数

gsize — 対話型分散配列のグローバル サイズ

整数

対話型分散配列のグローバル サイズ。整数として指定します。

プロパティ

Dimension — 分散次元

スカラー整数

分散次元。スカラー整数として指定します。分散次元は、codistributed 配列を分散する次元を指定します。

Partition — 分割ベクトル

整数の行ベクトル

分割ベクトル。整数の行ベクトルとして指定します。分割ベクトルは、ワーカーへの配列 codistributed の分散を指定します。

オブジェクト関数

codistributed.cell	対話型分散 cell 配列を作成する
codistributed.colon	コロン演算の分散
codistributed.spalloc	スパース対話型分散行列にスペースを割り当てる
codistributed.speye	対話型分散スパース単位行列を作成する
codistributed.sprand	一様分布する疑似乱数値からなるスパース対話型分散配列を作成する
codistributed.sprandn	正規分布した疑似乱数値からなる対話型分散スパース配列を作成する
eye	対話型分散単位行列の作成
false	logical 0 (false) からなる対話型分散配列を作成
globalIndices	対話型分散配列のローカル部分のグローバル インデックス
Inf	すべて Inf 値からなる対話型分散配列を作成
isComplete	対話型分散オブジェクトが完全な場合に true を返す
NaN	すべて NaN 値からなる対話型分散配列を作成
ones	すべて 1 からなる対話型分散配列を作成
rand	一様分布する乱数からなる対話型分散配列を作成
randn	正規分布する乱数からなる対話型分散配列を作成
sparse	対話型分散スパース行列の作成
true	logical 1 (true) からなる対話型分散配列を作成する
zeros	すべて 0 からなる対話型分散配列を作成する

例

分散スキームを使用した対話型分散配列の作成

codistributor1d オブジェクトを使用して、行によって分散される、1 の値からなる N 行 N 列の行列を作成します。

N = 1000;
spmd
    codistr = codistributor1d(1); % 1st dimension (rows)
    C = ones(N,codistr);
end

Codistributor1d オブジェクトの完全指定および対話型分散配列の作成

完全指定の codistributor1d オブジェクトを使用して、N 行 N 列の対話型分散行列をそのローカル部分から作成します。その上で、どの要素がワーカー 2 に格納されているかを可視化します。

ワーカーごとに完全なサイズの配列から開始し、myLocalSize を配列全体の既定の部分に設定します。

N = 1000;
spmd
    codistr = codistributor1d( ...
                    codistributor1d.unsetDimension, ...
                    codistributor1d.unsetPartition, ...
                    [N N]);
    myLocalSize = [N N]; % 
    myLocalSize(codistr.Dimension) = codistr.Partition(spmdIndex);
    myLocalPart = spmdIndex*ones(myLocalSize);
    D = codistributed.build(myLocalPart,codistr);
end
spy(D==2);

バージョン履歴

R2009b で導入

参考

codistributed | codistributor2dbc | redistribute