numpartitions

並列処理を目的とした妥当な区画数の推定の返却

構文

n = numpartitions(sds)

n = numpartitions(sds,pool)

説明

n = numpartitions(sds) は、信号データストア sds の既定の区画数を返します。

n = numpartitions(sds,pool) は、並列プールで sds を並列化するための妥当な区画数を返します。

• sds にファイル データが含まれている場合、区画の数は、プールのワーカー数およびファイルの総数によって異なります。

• sds にインメモリ データが含まれている場合、区画の数は、プールのワーカー数およびメンバーの総数によって異なります。

データストア アクセスを並列化するには、Parallel Computing Toolbox™ がインストール済みでなければなりません。

例

信号データストアの既定の数のパーツへの分割

MATLAB® に含まれる信号の例へのファイル パスを指定します。指定したフォルダーを示す信号データストアを作成します。

folder = fullfile(matlabroot,'toolbox','matlab','audiovideo');
sds = signalDatastore(folder,'SampleRateVariableName','Fs');

信号データストアの区画の既定の数を取得します。

n = numpartitions(sds)

n = 
7

データストアを既定の数の区画に分割し、4 番目の区画に対応するデータストアを返します。

subsds = partition(sds,n,4);

関数extractAfterを使用して、4 番目の区画に対応するデータストアに含まれるファイルの名前を表示します。

fName = extractAfter(subsds.Files,'audiovideo\')

fName = 1×1 cell array
    {0×0 char}

4 番目の区画に対応するデータストアの信号に関するデータと情報を読み取ります。info からサンプル レートを抽出し、信号を元のサンプル レートの半分にリサンプリングします。元の信号とリサンプリングした信号をプロットします。

while hasdata(subsds)
    [data,info] = read(subsds);
    fs = info.SampleRate;
    f_res = 0.5*fs;
    ts = (0:length(data)-1)/fs;
    data_res = resample(data,1,2);
    t_res = (0:length(data_res)-1)/f_res;
    plot(ts,data,t_res,data_res,':')
    xlabel('Time (s)')
    ylabel('Signal')
    legend('Original','Resampled','Location','NorthWest')
end

並列アクセスのための信号データストアの分割

MATLAB® に付属する信号の例が格納されているディレクトリへのパスを指定します。

folder = fullfile(matlabroot,'toolbox','matlab','audiovideo');

指定したフォルダーを示す信号データストアを作成します。

sds = signalDatastore(folder);

現在の並列プールについて、並列処理のための妥当な区画数に関する推定を返します。

pool = gcp;

Starting parallel pool (parpool) using the 'local' profile ...
Connected to the parallel pool (number of workers: 6).

n = numpartitions(sds,pool)

n = 7

信号データストアを分割し、各区画の信号データを読み取ります。

parfor ii = 1:n
    subds = partition(sds,n,ii);
    while hasdata(subds)
        data = read(subds);
    end
end

入力引数

sds — 信号データストア

signalDatastore オブジェクト

信号データストア。signalDatastore オブジェクトとして指定します。

pool — 並列プール

並列プール オブジェクト

並列プール。並列プール オブジェクトとして指定します。

出力引数

n — 分割数

正の整数

データストア アクセスが並列化される区画の数。既定では、区画の数は min(N_observations , 3N_workers) です。このとき、次のようになります。

• N_observations は、データストアのファイルの数(ファイル データの場合) またはデータストアのメンバーの数 (インメモリ データの場合) です。

• N_workers は、プールのワーカーの数です。

バージョン履歴

R2020a で導入

参考

signalDatastore | partition

トピック

• 深層学習を使用した波形セグメンテーション