Main Content

mapreducer

mapreduce または tall 配列の実行環境の定義

説明

引数を指定せずにmapreducerを使用すると、グローバル実行環境が既定 (Parallel Computing Toolbox™ が利用可能な場合は並列プール、それ以外の場合は MATLAB®セッション) に設定されます。mapreducerはコンフィギュレーション関数で、MATLAB がmapreduceアルゴリズムと tall 配列計算を実行する方式を変更します。この関数を使用して、Parallel Computing Toolbox、MATLAB Parallel Server™またはMATLAB Compiler™を使用するための実行環境の設定、変更または保存を行います。Parallel Computing Toolbox がインストールされている場合、関数tallまたは関数mapreduceを使用すると、既定の基本設定を変更していない限り、ワーカーの並列プールが MATLAB により自動的に開始されます。

メモ

利用可能なツールボックスがない場合、mapreduceアルゴリズムと tall 配列計算はローカル MATLAB セッションを使用して自動的に実行されるため、これらの機能を使用するためにmapreducerを使用してコンフィギュレーション設定を指定する必要はありません。ただし、Parallel Computing Toolbox、MATLAB Parallel ServerまたはMATLAB Compilerがある場合、並列環境または配布された環境向けに追加のmapreducerコンフィギュレーション オプションを使用できます。

詳細については、Parallel Computing Toolbox ドキュメンテーションのmapreducer(Parallel Computing Toolbox)またはMATLAB Compilerドキュメンテーションのmapreducer(MATLAB Compiler)を参照してください。

mapreducer(0)は、グローバル実行環境をローカルの MATLAB セッションに設定します。

mapreducer(mr)は、以前に作成した MapReducer オブジェクトmrを使用して、グローバル実行環境を設定します。

mr= mapreducer(___)はさらに、前述の構文のいずれかを使用して MapReducer オブジェクトを返します。実行環境を明示的に指定する場合は、mapreduceの 4 番目の入力引数としてmrを使用できます。

mr= mapreducer(___,'ObjectVisibility','Off')は MapReducer オブジェクトmrの可視性を切り替えます。グローバル実行環境に影響を与えないように、この構文を使って新しい MapReducer オブジェクトを作成してください。

すべて折りたたむ

コマンド

mapreducer

は、Parallel Computing Toolbox が使用可能な場合、並列プールを自動的に開始します。それ以外の場合は、実行環境はローカル MATLAB セッションに設定されます。

MATLAB にローカル セッションを使用させるには次のコマンドを使用します。

mapreducer(0)

現在のグローバル実行環境をクエリするには、次のコマンドを使用します。

gcmr

出力引数

すべて折りたたむ

実行環境。MapReducer オブジェクトとして返されます。

mrObjectVisibilityプロパティが'On'(既定値) に設定されている場合、mrはすべてのmapreduceアルゴリズムと tall 配列計算の実行環境を定義します。任意でmrを関数mapreduceに渡すことで、ObjectVisibilityプロパティが'Off'に設定されていても実行環境を明示的に指定できます。

ヒント

  • 高配列を扱うときには,mapreducerを使用して実行環境を設定してから tall 配列をtall(ds)で作成します。tall 配列は、作成された時点の現在のグローバル実行環境にバインドされます。グローバル実行環境が後で変更された場合、tall 配列は無効になり再構成しなければなりません。

拡張機能

バージョン履歴

R2014b で導入