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

loadLearnerForCoder

保存されたコード生成用モデルからのモデル オブジェクトの再構築

構文

Mdl = loadLearnerForCoder(filename)

Mdl = loadLearnerForCoder(filename,'DataType',T)

説明

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

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

固定小数点の C/C++ コードを生成するには、予測に必要な変数の固定小数点データ型を定義する追加の手順が必要です。generateLearnerDataTypeFcn によって生成されるデータ型関数を使用して固定小数点データ型構造体を作成し、その構造体をエントリポイント関数で loadLearnerForCoder の入力引数として使用します。固定小数点の C/C++ コードを生成するには、MATLAB Coder および Fixed-Point Designer™ が必要です。

次のフロー チャートは、機械学習モデルの関数 predict の固定小数点のコード生成ワークフローを示します。強調表示されているステップで loadLearnerForCoder を使用します。

Mdl = loadLearnerForCoder(filename) は、filename という名前で MATLAB 形式のバイナリ ファイル (MAT ファイル) に格納されているモデルから、分類モデル、回帰モデルまたは最近傍探索モデル (Mdl) を再構築します。filename ファイルは、saveLearnerForCoder を使用して作成しなければなりません。

Mdl = loadLearnerForCoder(filename,'DataType',T) は、filename に格納されているモデルの固定小数点バージョンを返します。構造体 T には、モデルの関数 predict を使用するために必要な変数の固定小数点データ型を指定するフィールドが含まれます。generateLearnerDataTypeFcn によって生成された関数を使用して T を作成します。

この構文をエントリポイント関数で使用し、codegen を使用してエントリポイント関数の固定小数点コードを生成します。コードを生成する場合にのみ、この構文を使用できます。

filename 内のモデルは SVM 分類モデルまたは SVM 回帰モデルでなければなりません。

例

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

機械学習モデルに学習をさせた後で、saveLearnerForCoder を使用してモデルを保存します。loadLearnerForCoder を使用してモデルを読み込み学習済みモデルの関数 predict を呼び出す、エントリポイント関数を定義します。その後、codegen (MATLAB Coder) を使用して 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 モデルです。

モデルの保存

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

saveLearnerForCoder(Mdl,'SVMIris');

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

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

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

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

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

type classifyIris.m % Display contents of classifyIris.m file

function label = classifyIris(X) %#codegen
%CLASSIFYIRIS Classify iris species using SVM Model
%   CLASSIFYIRIS classifies the iris flower measurements in X using the SVM
%   model in the file SVMIris.mat, and then returns class labels in label.
Mdl = loadLearnerForCoder('SVMIris');
label = predict(Mdl,X);
end

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

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

コードの生成

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

codegen classifyIris -args {X}

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

生成されたコードの確認

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

label1 = predict(Mdl,X);
label2 = classifyIris(X);
label3 = classifyIris_mex(X);
verify_label = isequal(label1,label2,label3)

verify_label = logical
   1

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

予測用の固定小数点の C/C++ コードの生成

機械学習モデルに学習させた後で、saveLearnerForCoder を使用してモデルを保存します。固定小数点のコード生成の場合、generateLearnerDataTypeFcnによって生成されるデータ型関数を使用して、予測に必要な変数の固定小数点データ型を指定します。次に、loadLearnerForCoder および指定した固定小数点データ型の両方を使用してモデルを読み込んでからモデルの関数 predict を呼び出す、エントリポイント関数を定義します。codegen (MATLAB Coder)を使用してエントリポイント関数の固定小数点の C/C++ コードを生成し、生成されたコードを確認します。

codegen を使用してコードを生成する前に、buildInstrumentedMex (Fixed-Point Designer)とshowInstrumentationResults (Fixed-Point Designer)を使用して固定小数点データ型を最適化し、固定小数点コードのパフォーマンスを向上させることができます。buildInstrumentedMex を使用して、予測用の名前付きの内部変数の最小値と最大値を記録します。showInstrumentationResults を使用して計測結果を表示します。次に、その結果に基づいて、変数の固定小数点データ型のプロパティを調整します。このオプション手順の詳細については、SVM の予測用の固定小数点コード生成を参照してください。

モデルの学習

ionosphere データセットを読み込み、バイナリ SVM 分類モデルに学習をさせます。

load ionosphere
Mdl = fitcsvm(X,Y,'KernelFunction','gaussian');

Mdl は ClassificationSVM モデルです。

モデルの保存

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

saveLearnerForCoder(Mdl,'myMdl');

固定小数点データ型の定義

generateLearnerDataTypeFcn を使用して、SVM モデルの予測に必要な変数の固定小数点データ型を定義する関数を生成します。

generateLearnerDataTypeFcn('myMdl',X)

generateLearnerDataTypeFcn は関数 myMdl_datatype を生成します。

myMdl_datatype を使用して、固定小数点データ型を定義する構造体 T を作成します。

T = myMdl_datatype('Fixed')

T = struct with fields:
               XDataType: [0x0 embedded.fi]
           ScoreDataType: [0x0 embedded.fi]
    InnerProductDataType: [0x0 embedded.fi]

構造体 T には、関数 predict の実行に必要な名前付きの内部変数に対するフィールドが含まれています。各フィールドには、fi (Fixed-Point Designer)で返される固定小数点オブジェクトが含まれています。固定小数点オブジェクトは、語長や小数部の長さなどの固定小数点データ型のプロパティを指定します。たとえば、予測子データの固定小数点データ型プロパティを表示します。

T.XDataType

ans = 

[]

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 14

        RoundingMethod: Floor
        OverflowAction: Wrap
           ProductMode: FullPrecision
  MaxProductWordLength: 128
               SumMode: FullPrecision
      MaxSumWordLength: 128

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

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

• 予測子データ X および固定小数点データ型構造体 T を受け入れる。

• loadLearnerForCoder および構造体 T の両方を使用して、学習済み SVM 分類モデルの固定小数点バージョンを読み込みます。

• 読み込まれたモデルを使用してラベルとスコアを予測する。

type myFixedPointPredict.m % Display contents of myFixedPointPredict.m file

function [label,score] = myFixedPointPredict(X,T) %#codegen
Mdl = loadLearnerForCoder('myMdl','DataType',T);
[label,score] = predict(Mdl,X);
end

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

コードの生成

構造体 T の XDataType フィールドは予測子データの固定小数点データ型を指定します。関数cast (Fixed-Point Designer)を使用して X を T.XDataType で指定された型に変換します。

X_fx = cast(X,'like',T.XDataType);

codegen を使用して、エントリポイント関数のコードを生成します。X_fx と定数畳み込みされた T をエントリポイント関数の入力引数として指定します。

codegen myFixedPointPredict -args {X_fx,coder.Constant(T)}

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

生成されたコードの確認

予測子データを predict と myFixedPointPredict_mex に渡し、出力を比較します。

[labels,scores] = predict(Mdl,X);
[labels_fx,scores_fx] = myFixedPointPredict_mex(X_fx,T);

predict と myFixedPointPredict_mex からの出力を比較します。

verify_labels = isequal(labels,labels_fx)

verify_labels = logical
   1

isequalは、logical 1 (true) を返します。これは labels と labels_fx が等しいことを意味します。ラベルが等しくない場合、不正に分類されたラベルの割合を次のように計算できます。

sum(strcmp(labels_fx,labels)==0)/numel(labels_fx)*100

ans = 0

スコア出力間の相対的な差分の最大値を求めます。

relDiff_scores = max(abs((scores_fx.double(:,1)-scores(:,1))./scores(:,1)))

relDiff_scores = 0.0055

比較結果に満足せず、生成されたコードの精度を向上させる場合、固定小数点データ型を調整し、コードを再生成できます。詳細については、generateLearnerDataTypeFcn のヒント、データ型関数およびSVM の予測用の固定小数点コード生成を参照してください。

入力引数

filename — モデル オブジェクトを表す構造体配列が格納されている MAT ファイルの名前

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

モデル オブジェクトを表す構造体配列が格納されている MAT ファイルの名前。文字ベクトルまたは string スカラーを指定します。filename ファイルは、saveLearnerForCoder を使用して作成しなければなりません。

loadLearnerForCoder は、filename ファイルに格納されているモデルをコンパイル時に再構築します。サポートされるモデルについては、saveLearnerForCoder の入力引数 Mdl を参照してください。

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

filename に絶対パスが含まれていない場合、loadLearnerForCoder は現在のフォルダーからファイルを読み込みます。

例: 'Mdl'

データ型: char | string

T — 固定小数点データ型

構造体

固定小数点データ型。構造体を指定します。この引数は、固定小数点 C/C++ コード生成に使用されます。

generateLearnerDataTypeFcn によって生成された関数を使用して T を作成します。生成された関数と構造体 T の詳細については、generateLearnerDataTypeFcn とデータ型関数を参照してください。

filename ファイル内のモデルが SVM 分類モデル (CompactClassificationSVM) または SVM 回帰モデル (CompactRegressionSVM) である場合、この引数を使用できます。

データ型: struct

出力引数

Mdl — 機械学習モデル

モデル オブジェクト

機械学習モデル。次のいずれかのモデル オブジェクトとして返されます。

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

  • ClassificationKNN

  • ClassificationLinear

  • CompactClassificationDiscriminant

  • CompactClassificationECOC

  • CompactClassificationEnsemble

  • CompactClassificationNaiveBayes

  • CompactClassificationSVM — 事後確率を予測する SVM モデルを保存するために saveLearnerForCoder を使用し、モデルを読み込むために loadLearnerForCoder を使用した場合、loadLearnerForCoder は ScoreTransform プロパティを MATLAB ワークスペースに復元できません。しかし loadLearnerForCoder は、コード生成用のコンパイル時に、エントリポイント関数内で ScoreTransform プロパティを含めてモデルを読み込むことができます。

  • CompactClassificationTree

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

  • CompactGeneralizedLinearModel

  • CompactLinearModel — fitlm を使用し、RobustWgtFun フィールドに無名関数ハンドルを設定した構造体を 'RobustOpts' に対して指定することにより線形モデルに学習をさせた場合に、saveLearnerForCoder を使用してモデルを保存してから、loadLearnerForCoder を使用してモデルを読み込んだとします。この場合、loadLearnerForCoder は Robust プロパティを MATLAB ワークスペースに復元できません。しかし loadLearnerForCoder は、コード生成用のエントリポイント関数内でコンパイル時にモデルを読み込むことができます。

  • CompactRegressionEnsemble

  • CompactRegressionGP

  • CompactRegressionSVM

  • CompactRegressionTree

  • RegressionLinear

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

  • ExhaustiveSearcher

  • KDTreeSearcher

アルゴリズム

saveLearnerForCoder は機械学習モデル (Mdl) をコード生成用に準備します。この関数は、予測には必要ないプロパティを削除します。

• 対応するコンパクトなモデルがあるモデルの場合、関数 saveLearnerForCoder は該当する関数 compact をモデルに適用してからモデルを保存します。

• 対応するコンパクトなモデルがないモデル (ClassificationKNN、ClassificationLinear、RegressionLinear、ExhaustiveSearcher、KDTreeSearcher など) の場合、関数 saveLearnerForCoder はプロパティ (ハイパーパラメーター最適化プロパティなど)、ソルバーの学習に関する情報などを削除します。

loadLearnerForCoder は、saveLearnerForCoder によって保存されたモデルを読み込みます。

代替機能

• 次の表に記載されているモデルに対して、learnerCoderConfigurer が作成したコーダー コンフィギュアラーを使用します。

  モデル	コーダー コンフィギュアラー オブジェクト
  マルチクラス分類用の二分決定木	ClassificationTreeCoderConfigurer
  1 クラスおよびバイナリ分類用の SVM	ClassificationSVMCoderConfigurer
  バイナリ分類用の線形モデル	ClassificationLinearCoderConfigurer
  SVM モデルおよび線形モデル用のマルチクラス モデル	ClassificationECOCCoderConfigurer
  回帰用の二分決定木	RegressionTreeCoderConfigurer
  サポート ベクター マシン (SVM) 回帰	RegressionSVMCoderConfigurer
  線形回帰	RegressionLinearCoderConfigurer

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

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意事項および制限事項:

• 固定小数点の C/C++ コード生成の場合、入力引数 T はコンパイル時の定数でなければなりません。たとえば、予測用の固定小数点の C/C++ コードの生成を参照してください。

詳細は、コード生成の紹介を参照してください。

参考

generateLearnerDataTypeFcn | saveLearnerForCoder | codegen (MATLAB Coder)

トピック

• コード生成の紹介
• 機械学習モデルの予測をコマンド ラインで行うコードの生成
• 機械学習モデルの予測を MATLAB Coder アプリを使用して行うコードの生成
• 最近傍探索モデルのコード生成
• SVM の予測用の固定小数点コード生成
• コード生成用の可変サイズ引数の指定

R2019b で導入

×

例を開く

この例の変更されたバージョンがシステム上にあります。代わりにこのバージョンを開きますか?

いいえ、変更されたバージョンを上書きします。 はい