最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

saveCompactModel

モデル オブジェクトをコード生成用のファイルに保存

機械学習モデルのオブジェクト関数 (predict、random、knnsearch または rangesearch) に対する C/C++ コードを生成するには、saveCompactModel、loadCompactModel および codegen を使用します。機械学習モデルに学習をさせた後で、saveCompactModel を使用してモデルを保存します。loadCompactModel を使用してモデルを読み込みオブジェクト関数を呼び出す、エントリポイント関数を定義します。その後、codegen または MATLAB^® Coder™ アプリを使用して C/C++ コードを生成します。C/C++ コードの生成には MATLAB Coder が必要です。

次のフロー チャートは、機械学習モデルのオブジェクト関数に対するコード生成ワークフローを示します。強調表示されているステップで saveCompactModel を使用します。

構文

saveCompactModel(Mdl,filename)

説明

saveCompactModel(Mdl,filename) は、メモリ フットプリントを縮小することにより分類モデル、回帰モデルまたは最近傍探索モデル (Mdl) をコード生成用に準備してから、filename という名前の MATLAB 形式のバイナリ ファイル (MAT ファイル) に保存します。filename を loadCompactModel に渡すと、filename ファイルからモデル オブジェクトを再構築できます。

例

予測用の C/C++ コードの生成

機械学習モデルに学習をさせた後で、saveCompactModel を使用してモデルを保存します。loadCompactModel を使用してモデルを読み込み学習済みモデルの関数 predict を呼び出す、エントリポイント関数を定義します。その後、codegen を使用して C/C++ コードを生成します。

この例では、コマンド ラインで機械学習モデルの予測を行うためのコード生成ワークフローについて簡単に説明します。詳細は、機械学習モデルの予測をコマンド ラインで行うコードの生成を参照してください。MATLAB Coder アプリを使用してコードを生成することもできます。詳細については、機械学習モデルの予測を MATLAB Coder アプリを使用して行うコードの生成を参照してください。再近傍探索モデルを使用した最近傍探索用のコード生成の詳細については、最近傍探索モデルのコード生成を参照してください。

モデルの学習

フィッシャーのアヤメのデータセットを読み込みます。観測された setosa 種のアヤメをすべて削除して、2 つのクラスのデータのみが X と Y に含まれるようにします。

load fisheriris
inds = ~strcmp(species,'setosa');
X = meas(inds,:);
Y = species(inds);

処理済みのデータセットを使用して、サポート ベクター マシン (SVM) 分類モデルに学習をさせます。

Mdl = fitcsvm(X,Y);

Mdl は ClassificationSVM モデルです。

モデルの保存

saveCompactModel を使用して、SVM 分類モデルを SVMIris.mat というファイルに保存します。

saveCompactModel(Mdl,'SVMIris');

エントリポイント関数の定義

以下を行う classifyIrises という名前のエントリポイント関数を定義します。

• meas に対応する列をもつアヤメの花の測定値を受け入れ、予測したラベルを返す。

• 学習済みの SVM 分類モデルを読み込む。

• 読み込んだアヤメの花の測定値の分類モデルを使用して、ラベルを予測する。

type classifyIrises.m

function label = classifyIrises(X) %#codegen
%CLASSIFYIRISES Classify iris species using SVM Model
%   CLASSIFYIRISES classifies the iris flower measurements in X using the
%   compact SVM model in the file SVMIris.mat, and then returns class
%   labels in label.
CompactMdl = loadCompactModel('SVMIris');
label = predict(CompactMdl,X);
end

MATLAB のアルゴリズムについてのコードを生成しようとしていることを指示するため、コンパイラ命令 %#codegen (またはプラグマ) をエントリポイント関数のシグネチャの後に追加します。この命令を追加すると、MATLAB Code Analyzer はコード生成時にエラーになる違反の診断と修正を支援します。

メモ: この例の右上にあるボタンをクリックしてこの例を MATLAB® で開くと、例のフォルダーが開きます。このフォルダーには、エントリポイント関数のファイルが含まれています。

コードの生成

codegen を使用して、エントリポイント関数のコードを生成します。C および C++ は静的な型の言語なので、エントリポイント関数内のすべての変数のプロパティをコンパイル時に決定しなければなりません。-args オプションの値として X を渡し、生成コードが学習データ X と同じデータ型および配列サイズをもつ入力を受け入れなければならないことを指定します。コンパイル時に観測値の個数が不明である場合、coder.typeof を使用して可変サイズの入力を指定することもできます。詳細は、コード生成用の可変サイズ引数の指定 と エントリポイント関数の入力のプロパティの指定 (MATLAB Coder) を参照してください。

codegen classifyIrises -args {X}

codegen は、プラットフォームに依存する拡張子をもつ MEX 関数 classifyIrises_mex を生成します。

生成されたコードの確認

predict、classifyIrises および classifyIrises_mex を使用して分類されたラベルを比較します。

label1 = predict(Mdl,X);
label2 = classifyIrises(X);
label3 = classifyIrises_mex(X);
verify_label = isequal(label1,label2,label3)

verify_label = logical
   1

isequal は、すべての入力が等しいことを意味する logical 1 (true) を返します。3 つの方法で分類したラベルは、すべて同じです。

入力引数

Mdl — 機械学習モデル

完全なモデル オブジェクト | コンパクトなモデル オブジェクト

機械学習モデル。完全またはコンパクトなモデル オブジェクトを指定します。サポートされるモデルは次の表に記載されています。

• 分類モデル オブジェクト

  モデル	完全なモデル オブジェクト	コンパクトなモデル オブジェクト	学習関数
  分類に使用される二分決定木	ClassificationTree	CompactClassificationTree	fitctree
  判別分析による分類	ClassificationDiscriminant	CompactClassificationDiscriminant	fitcdiscr
  アンサンブル分類器	ClassificationEnsemble、ClassificationBaggedEnsemble	CompactClassificationEnsemble	fitcensemble
  k 最近傍分類	ClassificationKNN	該当なし	fitcknn
  高次元データのバイナリ分類用の線形モデル	ClassificationLinear	該当なし	fitclinear
  サポート ベクター マシン (SVM) またはその他の分類器向けのマルチクラス モデル	ClassificationECOC	CompactClassificationECOC	fitcecoc
  1 クラスおよびバイナリ分類用の SVM	ClassificationSVM	CompactClassificationSVM	fitcsvm

  • Mdl が完全な分類モデル オブジェクトである場合、saveCompactModel は対応するコンパクトなモデル オブジェクトを保存します。

  • ClassificationKNN モデル オブジェクトは、対応するコンパクトなオブジェクトがない完全なオブジェクトです。saveCompactModel は、交差検証パラメーターとハイパーパラメーターが含まれていないコンパクトなバージョンを保存します。

  • ClassificationLinear モデル オブジェクトは、対応するコンパクトなオブジェクトがない完全なオブジェクトです。saveCompactModel はモデルをそのまま保存します。

• 回帰モデル オブジェクト

  モデル	完全なモデル オブジェクト	コンパクトなモデル オブジェクト	学習関数
  アンサンブル回帰	RegressionEnsemble、RegressionBaggedEnsemble	CompactRegressionEnsemble	fitrensemble
  ガウス過程回帰	RegressionGP	CompactRegressionGP	fitrgp
  一般化線形モデル	GeneralizedLinearModel	CompactGeneralizedLinearModel	fitglm、stepwiseglm
  線形回帰モデル	LinearModel	CompactLinearModel	fitlm、stepwiselm
  高次元データの線形回帰	RegressionLinear	該当なし	fitrlinear
  回帰木	RegressionTree	CompactRegressionTree	fitrtree
  SVM 回帰	RegressionSVM	CompactRegressionSVM	fitrsvm

  • Mdl が完全な回帰モデル オブジェクトである場合、saveCompactModel は対応するコンパクトなモデル オブジェクトを保存します。

  • RegressionLinear モデル オブジェクトは、対応するコンパクトなオブジェクトがない完全なオブジェクトです。saveCompactModel はモデルをそのまま保存します。

• 最近傍探索モデル オブジェクト

  モデル	モデル オブジェクト	学習関数
  網羅的最近傍探索モデル	ExhaustiveSearcher	ExhaustiveSearcher、createns
  Kd 木を使用する最近傍探索モデル	KDTreeSearcher	KDTreeSearcher、createns

  • 最近傍探索モデル オブジェクトは、対応するコンパクトなオブジェクトがない完全なオブジェクトです。saveCompactModel はモデルをそのまま保存します。

filename — ファイル名

文字ベクトル | string スカラー

ファイル名。文字ベクトルまたは string スカラーを指定します。

filename ファイルが存在する場合、saveCompactModel はファイルを上書きします。

filename ファイルの拡張子は .mat でなければなりません。filename に拡張子がない場合、saveCompactModel は .mat を追加します。

filename に絶対パスが含まれていない場合、saveCompactModel は現在のフォルダーにファイルを保存します。

例: 'SVMMdl'

データ型: char | string

アルゴリズム

saveCompactModel は、予測には必要ないプロパティを削除することにより、完全な分類モデルまたは回帰モデル (Mdl) のメモリ フットプリントを縮小します。つまり、モデルを保存する前に、saveCompactModel は適切な compact メソッドを Mdl に適用します。

代替機能

• SVM モデルに対して learnerCoderConfigurer が作成したコーダー コンフィギュアラーを使用して、C/C++ コードを生成します。SVM モデルに学習をさせた後で、モデルのコーダー コンフィギュアラーを作成します。コンフィギュアラーのプロパティとオブジェクト関数を使用することにより、コード生成オプションを設定し、モデルの関数 predict および update に対するコードを生成します。コーダー コンフィギュアラーを使用してコードを生成した場合、コードを再生成せずに、生成されたコードのモデル パラメーターを更新できます。詳細については、予測用のコード生成とコーダー コンフィギュアラーの使用による更新を参照してください。

参考

codegen | loadCompactModel

トピック

• コード生成の紹介
• 機械学習モデルの予測をコマンド ラインで行うコードの生成
• 機械学習モデルの予測を MATLAB Coder アプリを使用して行うコードの生成
• 最近傍探索モデルのコード生成
• コード生成用の可変サイズ引数の指定
• コード生成のサポート、使用上の注意事項および制限事項

R2016b で導入