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 を使用します)。