配布アプリケーションでの Parallel Computing Toolbox の使用 - MATLAB & Simulink - MathWorks 日本

配布アプリケーションでのParallel Computing Toolboxの使用

Parallel Computing Toolbox™ を使用するアプリケーションは、MATLAB^®基本設定フォルダーにあるクラスタープロファイルを使用できます。このフォルダーを検索するには、prefdirを使用します。

たとえば、スタンドアロンアプリケーションを作成する場合、既定では、クラスタープロファイルマネージャーで使用可能なすべてのプロファイルがこのアプリケーションで使用可能になります。

アプリケーションは外部ファイルで提供されるクラスタープロファイルも使用できます。アプリケーションがこのファイルを使用できるようにするには、次のいずれかを行います。

コード内でこのファイルにリンクする。
実行時にこのファイルの場所を渡す。

クラスタープロファイルのエクスポート

クラスタープロファイルを外部ファイルにエクスポートするには、以下の手順に従います。

[ホーム] タブの[環境]セクションで、[並列]、[クラスタープロファイルの管理]を選択します。
[クラスタープロファイルマネージャー]ダイアログでプロファイルを選択し、[管理]セクションで[エクスポート]をクリックします。

コード内でParallel Computing Toolboxプロファイルにリンク

アプリケーションが外部ファイルで提供されたクラスタープロファイルを使用できるようにするには、コードからファイルにリンクします。この例では、絶対パス、相対パス、MATLAB 検索パスを使用して、クラスタープロファイルにリンクします。各リンクはコンパイルの前に指定されているため、各リンクが変わっていないことを確認しなければなりません。

アプリケーションのクラスタープロファイルを設定するには、関数setmcruserdataを使用します。

MATLAB 基本設定フォルダーはアプリケーションにまとめられているため、このフォルダー内のファイルへの相対リンクはつねに機能します。アプリケーションコードでは、MATLAB 基本設定フォルダー内のmyClusterProfile.mlsettingsファイルを次のように使用できます。

mpSettingsPath = fullfile(prefdir,'myClusterProfile.mlsettings'); setmcruserdata('ParallelProfile', mpSettingsPath);

関数fullfileを使用すると、外部ファイルの絶対パスが得られます。mpSettingsPathで指定する引数は、絶対パスでなければなりません。アプリケーションのユーザーが、ファイルシステム上の変わることのない絶対パスにクラスタープロファイルを配置した場合は、次のように直接リンクします。

mpSettingsPath ='/path/to/myClusterProfile.mlsettings'; setmcruserdata('ParallelProfile', mpSettingsPath);

この方法は、クラスタープロファイルがアプリケーションのために一元管理されている場合に適しています。アプリケーションのユーザーが、クラスタープロファイルをローカルに保存している場合、現在の作業ディレクトリからの相対パスを次のように拡張できます。

mpSettingsPath = fullfile(pwd,'../rel/path/to/myClusterProfile.mlsettings'); setmcruserdata('ParallelProfile', mpSettingsPath);

この方法は、スタンドアロンアプリケーションのユーザーが自分でクラスタープロファイルを用意する必要がある場合に適しています。mccによるコンパイル時に-aフラグを使用して追加したファイルは、MATLAB 検索パスに追加されます。そのため、外部に保存されているクラスタープロファイルをアプリケーションにまとめることもできます。まず、whichを使用してクラスタープロファイルへの絶対パスを取得します。次に、これにリンクします。

mpSettingsPath = which('myClusterProfile.mlsettings'); setmcruserdata('ParallelProfile', mpSettingsPath);

最後に、コマンドラインでコンパイルして、クラスタープロファイルを追加します。

mcc-a/path/to/myClusterProfile.mlSettings-mmyApp.m;

コンパイル前にアプリケーションを実行するには、MATLAB 検索パスに手動で/path/to/を追加する必要があります。

実行時にParallel Computing Toolboxプロファイルを渡す

アプリケーションmyAppのユーザーが、実行時に選択するクラスタープロファイルを使用している場合は、コマンドラインでこれを指定することができます。

myApp -mcruserdata ParallelProfile:/path/to/myClusterProfile.mlsettings

コードで関数setmcruserdataを使用すると、-mcruserdataフラグの使用がオーバーライドされます。

配布されたアプリケーションでのクラスタープロファイルの切り替え

関数setmcruserdataを使用する場合、クラスタープロファイルマネージャーで使用可能なプロファイルはどれも使用できなくなります。クラスタープロファイルマネージャーのプロファイルを再度有効にするには、parallel.mlSettingsファイルを使用します。

mpSettingsPath ='/path/to/myClusterProfile.mlsettings'; setmcruserdata('ParallelProfile', mpSettingsPath);% SOME APPLICATION CODEorigSettingsPath = fullfile(prefdir,'parallel.mlsettings'); setmcruserdata('ParallelProfile', origSettingsPath);% MORE APPLICATION CODE

クラスタープロファイルを読み込むためのサンプル C コード

mxArray *key = mxCreateString("ParallelProfile"); mxArray *value = mxCreateString("/path/to/myClusterProfile.mlsettings"); if (!setmcruserdata(key, value)) { fprintf(stderr, "Could not set MCR user data: \n %s ", mclGetLastErrorMessage()); return -1; }