このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

numpartitions

データストアの区画数

構文

n = numpartitions(ds)

n = numpartitions(ds,pool)

説明

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

n = numpartitions(ds,pool) は、pool に指定された並列プール経由でデータストアへのアクセスを並列化するための区画数を返します。データストアへのアクセスを並列化するには、Parallel Computing Toolbox™ をインストールしていなければなりません。

例

分割数

関数 mapreduce の出力ファイルであるサンプル ファイル mapredout.mat からデータストアを作成します。

ds = datastore('mapredout.mat');

既定の分割数を取得します。

n = numpartitions(ds)

n = 
1

ds には小さいファイルが 1 つしか含まれていないため、既定でその分割は 1 つのみとなります。

データストアを分割し、最初の部分に対応するデータストアを返します。

subds = partition(ds,n,1);

subds 内のデータを読み取ります。

while hasdata(subds)
    data = read(subds);
end

データストアに並列アクセスするための分割数

現在の並列プール経由でデータストアへのアクセスを並列化するための分割数を取得します。Parallel Computing Toolbox がインストールされていなければなりません。

関数 mapreduce の出力ファイルであるサンプル ファイル mapredout.mat からデータストアを作成します。

ds = datastore('mapredout.mat');

現在の並列プール経由でデータストアへのアクセスを並列化するための分割数を取得します。

n = numpartitions(ds, gcp);

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

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

入力引数

ds — 入力データストア

データストア

入力データストア。関数 datastore を使用して、データから datastore オブジェクトを作成できます。

pool — 並列プール

並列プール オブジェクト

並列プール オブジェクト。

例: gcp

拡張機能

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

使用上の注意および制限:

• スレッドベースの環境では、次のデータストアでのみ numpartitions を使用できます。

  • ImageDatastore オブジェクト

  • combine または transform を使用して ImageDatastore オブジェクトから作成する CombinedDatastore、SequentialDatastore、または TransformedDatastore オブジェクト

  Parallel Computing Toolbox がある場合は、他のデータストアで numpartitions を使用できます。これを行うには、backgroundPool または ThreadPool を使用する代わりに、プロセスベースの並列プールを使用して関数を実行します (ProcessPool または ClusterPool を使用します)。

詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

バージョン履歴

R2015a で導入

参考

datastore | partition

トピック

• データ ストアの並列分割 (Parallel Computing Toolbox)