Shared Arrays

SharedArray は、単一のマシン上で複数のプロセス間で共有される配列を表します。

SharedArrays.SharedArray — Type
SharedArray{T}(dims::NTuple; init=false, pids=Int[])
SharedArray{T,N}(...)

pidsで指定したプロセス間(すべて同一ホスト上にある必要があります)に、サイズがdimsで、要素型がTのビット型であるSharedArrayを構築します。SharedArray{T,N}(dims)の呼び出しでNを指定する場合、Nの長さはdimsと一致している必要があります。

pidsを指定しない場合、共有配列はマスターを含む、現在のホスト上のすべてのプロセスにマッピングされます。ただし、localindicesとindexpidsが参照するのはワーカープロセスのみです。これにより、マスタープロセスをドライバーとして動作させながら、実際の計算にはワーカーを使う作業分配コードを記述できます。

initfn(S::SharedArray)型のinit関数を指定すると、参加するすべてのワーカーでその関数が呼び出されます。

共有配列は、マッピングを作成したノード上にSharedArrayオブジェクトへの参照が存在する限り有効です。

SharedArray{T}(filename::AbstractString, dims::NTuple, [offset=0]; mode=nothing, init=false, pids=Int[])
SharedArray{T,N}(...)

pidsで指定したプロセス間(すべて同一ホスト上にある必要があります)に、要素型がT(ビット型である必要があります)、サイズがdimsの、ファイルfilenameをバックエンドとするSharedArrayを構築します。このファイルはホストメモリにメモリマップされるため、次の点に注意してください。

  • 配列データはバイナリ形式で表現する必要があります(CSVのようなASCII形式はサポートできません)。
  • 配列の値を変更すると(たとえばA[3] = 0)、ディスク上の値も変更されます。

pidsを指定しない場合、共有配列はマスターを含む、現在のホスト上のすべてのプロセスにマッピングされます。ただし、localindicesとindexpidsが参照するのはワーカープロセスのみです。これにより、マスタープロセスをドライバーとして動作させながら、実際の計算にはワーカーを使う作業分配コードを記述できます。

modeには、"r"、"r+"、"w+"、"a+"のいずれかを指定する必要があります。filenameで指定したファイルがすでに存在する場合、デフォルトは"r+"です。存在しない場合は"w+"がデフォルトになります。initfn(S::SharedArray)型のinit関数を指定すると、参加するすべてのワーカーでその関数が呼び出されます。ファイルに書き込み権限がない場合、init関数は指定できません。

offsetを使うと、ファイルの先頭から指定したバイト数を読み飛ばせます。

source
Distributed.procs — Method
procs(S::SharedArray)

共有配列に対応するプロセスのベクトルを取得します。

source
SharedArrays.sdata — Function
sdata(S::SharedArray)

Array を裏付ける実際の S オブジェクトを返してください。

source
SharedArrays.indexpids — Function
indexpids(S::SharedArray)

SharedArray(つまり、procs(S)が返すものと同じリスト)における現在のワーカーのインデックスを返します。SharedArrayがローカルにマッピングされていない場合は、0を返します。

source
SharedArrays.localindices — Function
localindices(S::SharedArray)

現在のプロセスが処理する「デフォルト」のインデックスを表す範囲を返します。この範囲は線形インデックスの意味で解釈され、1:length(S) の部分範囲となります。複数プロセスのコンテキストでは、親プロセス(または indexpids が 0 を返すプロセス)では空の範囲を返します。

localindices はあくまで便宜上用意されているものであり、配列の処理をワーカー間でどのように分割するかは自由です。SharedArray の場合、どのインデックスも各ワーカープロセスで同じ速さで処理できる必要があります。

source