labBroadcast

(非推奨) spmd ブロックのすべてのワーカーにデータを送信する

ページ内をすべて折りたたむ

    labBroadcast は推奨されません。代わりに spmdBroadcast を使用してください。詳細については、バージョン履歴を参照してください。

    構文

    B = labBroadcast(source,A)
    B = labBroadcast(source)

    説明

    B = labBroadcast(source,A) は、現在の spmd ブロックまたは通信ジョブ内のすべてのワーカーにデータ A を送信します。

    ヒント

    parfor と parfeval を使用して計算をオフロードする場合、各計算は一度に 1 つのワーカーによってのみ実行されます。これらのワーカーは独立しており、相互の通信は行われません。これらのワーカー上で labBroadcast を使用する場合、この関数による影響はありません。

    データは、labindex が source と等しいワーカーからブロードキャストされます。

    source が labindex と等しい場合、B は A と等しくなります。numlabs は、spmd ブロックまたは通信ジョブの外部では 1 と等しくなります。

    例

    B = labBroadcast(source) は、現在の spmd ブロックまたは通信ジョブを実行している各ワーカー上でデータ B を受信します。データ B は、labindex が source と等しいワーカーから送信されるデータ A と等しくなります。

    例

    例

    すべて折りたたむ

    この例では、spmd ブロックにおいて、あるワーカーから他のワーカーへ配列をブロードキャストする方法を説明します。

    4 つのワーカーをもつ並列プールを作成します。既定では、labBroadcast はプロセスベースのすべてのプールでサポートされています。

    parpool(4);

    並列プールの作成後に spmd ブロックを実行すると、既定ではそのプール内のすべての使用可能なワーカーで、spmd ブロック内のコードが実行されます。

    spmd ブロックを作成します。labindex が 1 と等しいワーカー上で、配列を作成します。labBroadcast を使用して配列をすべてのワーカーに送信します。他の各ワーカーでは、labBroadcast を使用して配列を受信します。

    spmd
    source = 1;
    if labindex == source
        A = magic(3);
        B = labBroadcast(source, A);
    else
        B = labBroadcast(source);
    end
    B
end
    Worker 1: 
  
  B =
  
       8     1     6
       3     5     7
       4     9     2
  
Worker 2: 
  
  B =
  
       8     1     6
       3     5     7
       4     9     2
  
Worker 3: 
  
  B =
  
       8     1     6
       3     5     7
       4     9     2
  
Worker 4: 
  
  B =
  
       8     1     6
       3     5     7
       4     9     2

    クライアント上で、Composite A を調べます。配列 A は、labindex が 1 と等しいワーカー上でのみ定義されています。

    A
     
A =
 
   Worker 1: class = double, size = [3  3]
   Worker 2: No data
   Worker 3: No data
   Worker 4: No data

    入力引数

    すべて折りたたむ

    データを送信しているワーカーのインデックス。正の整数スカラーとして指定します。この値は 1 以上かつ numlabs 以下でなければなりません。

    例: 1

    labindex が source と等しいワーカーから送信されるデータ。保存および読み込みが可能な任意の MATLAB 変数として指定します。

    例: magic(3)

    出力引数

    すべて折りたたむ

    ワーカーで受信されるデータ。スカラー、ベクトル、行列、多次元配列、table、または timetable として指定します。

    ヒント

    labBroadcast を呼び出すワーカーは、他のワーカーより先に戻る場合があります。共有リソースを閉じる場合など、spmd ブロックまたは通信ジョブのワーカーを同期する必要があるときは、labBroadcast を呼び出した後に labBarrier を使用します。

    拡張機能

    すべて展開する

    バージョン履歴

    R2006a より前に導入

    すべて折りたたむ

    参考