Main Content

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

numpartitions

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

説明

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
    {'laughter.mat'}

4 番目の区画に対応するデータストアの信号に関するデータと情報を読み取ります。struct 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

入力引数

すべて折りたたむ

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

並列プール。並列として指定します。

出力引数

すべて折りたたむ

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

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

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

R2020a で導入