デプロイアプリケーションでの 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);

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

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

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

mcc -a /path/to/myClusterProfile.mlsettings -m myApp.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 CODE

origSettingsPath = fullfile(prefdir, 'parallel.mlsettings'); 
setmcruserdata('ParallelProfile', origSettingsPath);

% MORE APPLICATION CODE

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

MATLAB Compiler SDK™ でビルドされた C および C++ アプリケーション内でネイティブに関数 mcruserdata を呼び出すことができます。

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;
}

参考

setmcruserdata | getmcruserdata