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を使うと、ファイルの先頭から指定したバイト数を読み飛ばせます。
SharedArrays.SharedVector — Type
SharedVector1次元のSharedArray。
SharedArrays.SharedMatrix — Type
SharedMatrix2次元のSharedArray。
Distributed.procs — Method
procs(S::SharedArray)共有配列に対応するプロセスのベクトルを取得します。
SharedArrays.sdata — Function
sdata(S::SharedArray)Array を裏付ける実際の S オブジェクトを返してください。
SharedArrays.indexpids — Function
indexpids(S::SharedArray)SharedArray(つまり、procs(S)が返すものと同じリスト)における現在のワーカーのインデックスを返します。SharedArrayがローカルにマッピングされていない場合は、0を返します。
SharedArrays.localindices — Function
localindices(S::SharedArray)現在のプロセスが処理する「デフォルト」のインデックスを表す範囲を返します。この範囲は線形インデックスの意味で解釈され、1:length(S) の部分範囲となります。複数プロセスのコンテキストでは、親プロセス(または indexpids が 0 を返すプロセス)では空の範囲を返します。
localindices はあくまで便宜上用意されているものであり、配列の処理をワーカー間でどのように分割するかは自由です。SharedArray の場合、どのインデックスも各ワーカープロセスで同じ速さで処理できる必要があります。