Main Content

parallel.importProfile

ファイルからクラスター プロファイルをインポートする

ページ内をすべて折りたたむ

構文

profile = parallel.importProfile(filename)

説明

profile = parallel.importProfile(filename) は指定されたファイル filename に保存されているプロファイルをインポートし、そのインポートしたプロファイルの名前を返します。filename に拡張子がない場合、この関数は .mlsettings がファイル拡張子であると仮定します。構成ファイルのファイル拡張子には .mat 拡張子を指定する必要があります。

MAT 構成ファイルにはただ 1 つのプロファイルが含まれますが、MLSETTINGS プロファイル ファイルには 1 つ以上のプロファイルを含めることができます。このファイルに含まれているプロファイルが 1 つのみの場合、profile はそのプロファイルの名前に基づく文字ベクトルになります。このファイルに複数のプロファイルが含まれている場合、profile は文字ベクトルの cell 配列になります。インポートするプロファイルと同じ名前のプロファイルが既にある場合、この関数はインポートするプロファイルの名前に拡張子を追加します。

インポートしたプロファイルは、プロファイルをサポートする任意の関数で使用できます。parallel.importProfile では、インポートされたどのプロファイルも既定のプロファイルとしては設定しません。既定のプロファイルを設定するには、parallel.defaultProfile 関数を使用します。

前のリリースでエクスポートしたプロファイルは、インポート時に parallel.importProfile によってアップグレードされます。構成は自動的にクラスター プロファイルに変換されます。

インポートしたプロファイルは MATLAB® 設定の一部として保存されるため、再度インポートしなくても、以後の MATLAB セッションで使用可能になります。

例

例

すべて折りたたむ

ProfileMain.mlsettings ファイルからプロファイルをインポートし、既定のクラスター プロファイルとして設定します。

profile_main = parallel.importProfile('ProfileMain');
parallel.defaultProfile(profile_main)

ManyProfiles.mlsettings ファイルからすべてのプロファイルをインポートし、先頭のプロファイルを使用して並列プールを開きます。

profs = parallel.importProfile('ManyProfiles');
parpool(profs{1})

OldConfiguration.mat ファイルから構成をインポートし、既定の並列プロファイルとして設定します。

old_conf = parallel.importProfile('OldConfiguration.mat')
parallel.defaultProfile(old_conf)

入力引数

すべて折りたたむ

インポートするプロファイルのファイル名。string 配列または文字ベクトルとして指定します。

データ型: char | string

出力引数

すべて折りたたむ

インポートしたプロファイルの名前。文字ベクトルまたは文字ベクトルの cell 配列として返されます。

バージョン履歴

R2012a で導入

参考

| |