メインコンテンツ

predict

回帰ニューラル ネットワークの使用による応答の予測

R2021a 以降

    説明

    yfit = predict(Mdl,X) は、学習済みの回帰ニューラル ネットワーク モデル Mdl を使用して、table または行列 X 内の予測子データに対する予測応答値を返します。

    yfit = predict(Mdl,X,Name=Value) は、1 つ以上の名前と値の引数を使用して追加オプションを指定します。たとえば、予測子データの列が観測値に対応するように指定できます。

    すべて折りたたむ

    学習済みの回帰ニューラル ネットワーク モデルを使用してテスト セットの応答値を予測します。

    patients データ セットを読み込みます。データ セットから table を作成します。各行が 1 人の患者に対応し、各列が診断の変数に対応します。変数 Systolic を応答変数として使用し、残りの変数を予測子として使用します。

    load patients
    tbl = table(Diastolic,Height,Smoker,Weight,Systolic);

    非層化ホールドアウト分割を使用して、データを学習セット tblTrain とテスト セット tblTest に分割します。観測値の約 30% がテスト データ セット用に予約され、残りの観測値が学習データ セットに使用されます。

    rng("default") % For reproducibility of the partition
    c = cvpartition(size(tbl,1),"Holdout",0.30);
    trainingIndices = training(c);
    testIndices = test(c);
    tblTrain = tbl(trainingIndices,:);
    tblTest = tbl(testIndices,:);

    学習セットを使用して回帰ニューラル ネットワーク モデルに学習させます。tblTrain の列 Systolic を応答変数として指定します。数値予測子を標準化するための指定を行い、反復制限を 50 に設定します。既定では、ニューラル ネットワーク モデルには、最終全結合層を除き、出力数が 10 の全結合層が 1 つあります。

    Mdl = fitrnet(tblTrain,"Systolic", ...
        "Standardize",true,"IterationLimit",50);

    テスト セットの患者の収縮期血圧レベルを予測します。

    predictedY = predict(Mdl,tblTest);

    基準線を示した散布図を使用して結果を可視化します。予測値を縦軸に、実際の応答値を横軸に沿ってプロットします。基準線上にある点は予測が正しいことを示します。

    plot(tblTest.Systolic,predictedY,".")
    hold on
    plot(tblTest.Systolic,tblTest.Systolic)
    hold off
    xlabel("True Systolic Blood Pressure Levels")
    ylabel("Predicted Systolic Blood Pressure Levels")

    Figure contains an axes object. The axes object contains 2 objects of type line.

    多くの点が基準線から離れた位置にあるため、サイズ 10 の全結合層をもつ既定のニューラル ネットワーク モデルは、収縮期血圧レベルの最適な予測子ではないようです。

    テスト セットの損失と予測を比較することにより、特徴選択を実行します。すべての予測子を使用して学習させた回帰ニューラル ネットワーク モデルのテスト セット メトリクスを予測子のサブセットのみを使用して学習させたモデルのテスト セット メトリクスと比較します。

    標本ファイル fisheriris.csv を読み込みます。これには、アヤメについてのがく片の長さ、がく片の幅、花弁の長さ、花弁の幅、種の種類などのデータが格納されています。ファイルを table に読み込みます。

    fishertable = readtable('fisheriris.csv');

    非層化ホールドアウト分割を使用して、データを学習セット trainTbl とテスト セット testTbl に分割します。観測値の約 30% がテスト データ セット用に予約され、残りの観測値が学習データ セットに使用されます。

    rng("default")
    c = cvpartition(size(fishertable,1),"Holdout",0.3);
    trainTbl = fishertable(training(c),:);
    testTbl = fishertable(test(c),:);

    学習セット内のすべての予測子を使用して 1 つの回帰ニューラル ネットワーク モデルに学習させ、PetalWidth を除くすべての予測子を使用してもう 1 つのモデルに学習させます。両方のモデルについて、PetalLength を応答変数として指定し、予測子を標準化します。

    allMdl = fitrnet(trainTbl,"PetalLength","Standardize",true);
    subsetMdl = fitrnet(trainTbl,"PetalLength ~ SepalLength + SepalWidth + Species", ...
        "Standardize",true);

    2 つのモデルのテスト セットの平均二乗誤差 (MSE) を比較します。MSE の値が小さいほど、パフォーマンスが優れていることを示します。

    allMSE = loss(allMdl,testTbl)
    allMSE = 
    0.0834
    
    subsetMSE = loss(subsetMdl,testTbl)
    subsetMSE = 
    0.0884
    

    各モデルについて、テスト セットの予測される花弁の長さと実際の花弁の長さを比較します。予測される花弁の長さを縦軸に、実際の花弁の長さを横軸に沿ってプロットします。基準線上にある点は予測が正しいことを示します。

    tiledlayout(2,1)
    
    % Top axes
    ax1 = nexttile;
    allPredictedY = predict(allMdl,testTbl);
    plot(ax1,testTbl.PetalLength,allPredictedY,".")
    hold on
    plot(ax1,testTbl.PetalLength,testTbl.PetalLength)
    hold off
    xlabel(ax1,"True Petal Length")
    ylabel(ax1,"Predicted Petal Length")
    title(ax1,"All Predictors")
    
    % Bottom axes
    ax2 = nexttile;
    subsetPredictedY = predict(subsetMdl,testTbl);
    plot(ax2,testTbl.PetalLength,subsetPredictedY,".")
    hold on
    plot(ax2,testTbl.PetalLength,testTbl.PetalLength)
    hold off
    xlabel(ax2,"True Petal Length")
    ylabel(ax2,"Predicted Petal Length")
    title(ax2,"Subset of Predictors")

    Figure contains 2 axes objects. Axes object 1 with title All Predictors, xlabel True Petal Length, ylabel Predicted Petal Length contains 2 objects of type line. One or more of the lines displays its values using only markers Axes object 2 with title Subset of Predictors, xlabel True Petal Length, ylabel Predicted Petal Length contains 2 objects of type line. One or more of the lines displays its values using only markers

    予測が基準線の近くに分布しており、両方のモデルが適切に機能しているようなので、PetalWidth を除くすべての予測子を使用して学習させたモデルを使用することを検討します。

    単一の観測値の応答値を予測するために回帰ニューラル ネットワーク モデルの層がどのように連携するかを調べます。

    標本ファイル fisheriris.csv を読み込みます。これには、アヤメについてのがく片の長さ、がく片の幅、花弁の長さ、花弁の幅、種の種類などのデータが格納されています。ファイルを table に読み込み、table の最初の数行を表示します。

    fishertable = readtable('fisheriris.csv');
    head(fishertable)
        SepalLength    SepalWidth    PetalLength    PetalWidth     Species  
        ___________    __________    ___________    __________    __________
    
            5.1           3.5            1.4           0.2        {'setosa'}
            4.9             3            1.4           0.2        {'setosa'}
            4.7           3.2            1.3           0.2        {'setosa'}
            4.6           3.1            1.5           0.2        {'setosa'}
              5           3.6            1.4           0.2        {'setosa'}
            5.4           3.9            1.7           0.4        {'setosa'}
            4.6           3.4            1.4           0.3        {'setosa'}
              5           3.4            1.5           0.2        {'setosa'}
    

    データ セットを使用して回帰ニューラル ネットワーク モデルに学習させます。変数 PetalLength を応答として指定し、他の数値変数を予測子として使用します。

    Mdl = fitrnet(fishertable,"PetalLength ~ SepalLength + SepalWidth + PetalWidth");

    データ セットから 15 番目の観測値を選択します。ニューラル ネットワークの層が観測値をどのように扱い、予測応答値 newPointResponse をどのように返すかを調べます。

    newPoint = Mdl.X{15,:}
    newPoint = 1×3
    
        5.8000    4.0000    0.2000
    
    
    firstFCStep = (Mdl.LayerWeights{1})*newPoint' + Mdl.LayerBiases{1};
    reluStep = max(firstFCStep,0);
    
    finalFCStep = (Mdl.LayerWeights{end})*reluStep + Mdl.LayerBiases{end};
    
    newPointResponse = finalFCStep
    newPointResponse = 
    1.6716
    

    オブジェクト関数 predict で返される予測と一致することを確認します。

    predictedY = predict(Mdl,newPoint)
    predictedY = 
    1.6716
    
    isequal(newPointResponse,predictedY)
    ans = logical
       1
    
    

    2 つの結果は一致しています。

    R2024b 以降

    複数の応答変数をもつ回帰ニューラル ネットワークを作成します。

    carbig データ セットを読み込みます。このデータ セットには、1970 年代と 1980 年代初期に製造された自動車の測定値が格納されています。DisplacementHorsepower などの予測子変数と応答変数の Acceleration および MPG が格納された table を作成します。table の最初の 8 行を表示します。

    load carbig
    cars = table(Displacement,Horsepower,Model_Year, ...
        Origin,Weight,Acceleration,MPG);
    head(cars)
        Displacement    Horsepower    Model_Year    Origin     Weight    Acceleration    MPG
        ____________    __________    __________    _______    ______    ____________    ___
    
            307            130            70        USA         3504           12        18 
            350            165            70        USA         3693         11.5        15 
            318            150            70        USA         3436           11        18 
            304            150            70        USA         3433           12        16 
            302            140            70        USA         3449         10.5        17 
            429            198            70        USA         4341           10        15 
            454            220            70        USA         4354            9        14 
            440            215            70        USA         4312          8.5        14 
    

    cars から table に欠損値がある行を削除します。

    cars = rmmissing(cars);

    米国製かどうかに基づいて、自動車を分類します。

    cars.Origin = categorical(cellstr(cars.Origin));
    cars.Origin = mergecats(cars.Origin,["France","Japan",...
        "Germany","Sweden","Italy","England"],"NotUSA");

    データを学習セットとテスト セットに分割します。観測値の約 85% をニューラル ネットワーク モデルの学習に使用し、観測値の約 15% を学習済みモデルの新しいデータでの性能のテストに使用します。cvpartition を使用してデータを分割します。

    rng("default") % For reproducibility
    c = cvpartition(height(cars),"Holdout",0.15);
    carsTrain = cars(training(c),:);
    carsTest = cars(test(c),:);

    学習データ carsTrainfitrnet 関数に渡して、多重応答ニューラル ネットワーク回帰モデルに学習させます。より良い結果を得るために、予測子データを標準化するように指定します。

    Mdl = fitrnet(carsTrain,["Acceleration","MPG"], ...
        Standardize=true)
    Mdl = 
      RegressionNeuralNetwork
               PredictorNames: {'Displacement'  'Horsepower'  'Model_Year'  'Origin'  'Weight'}
                 ResponseName: {'Acceleration'  'MPG'}
        CategoricalPredictors: 4
            ResponseTransform: 'none'
              NumObservations: 334
                   LayerSizes: 10
                  Activations: 'relu'
        OutputLayerActivation: 'none'
                       Solver: 'LBFGS'
              ConvergenceInfo: [1×1 struct]
              TrainingHistory: [1000×7 table]
    
    
      Properties, Methods
    
    

    Mdl は学習させた RegressionNeuralNetwork モデルです。ドット表記を使用して Mdl のプロパティにアクセスできます。たとえば、Mdl.ConvergenceInfo と指定すると、モデルの収束についての詳細情報を取得できます。

    検定の平均二乗誤差 (MSE) を計算して、テスト セットで回帰モデルの性能を評価します。MSE の値が小さいほど、パフォーマンスが優れていることを示します。名前と値の引数 OutputType"per-response" に設定して、各応答変数の損失を個別に返します。

    testMSE = loss(Mdl,carsTest,["Acceleration","MPG"], ...
        OutputType="per-response")
    testMSE = 1×2
    
        1.5341    4.8245
    
    

    テスト セット内の観測値に対する応答値を予測します。予測された応答値を table として返します。

    predictedY = predict(Mdl,carsTest,OutputType="table")
    predictedY=58×2 table
        Acceleration     MPG  
        ____________    ______
    
           9.3612       13.567
           15.655       21.406
           17.921       17.851
           11.139       13.433
           12.696        10.32
           16.498       17.977
           16.227       22.016
           12.165       12.926
           12.691       12.072
           12.424       14.481
           16.974       22.152
           15.504       24.955
           11.068       13.874
           11.978       12.664
           14.926       10.134
           15.638       24.839
          ⋮
    
    

    入力引数

    すべて折りたたむ

    学習させた回帰ニューラル ネットワーク。fitrnet によって返される RegressionNeuralNetwork モデル オブジェクト、または compact によって返される CompactRegressionNeuralNetwork モデル オブジェクトとして指定します。

    応答の生成に使用する予測子データ。数値行列または table を指定します。

    既定では、X の各行は 1 つの観測値に対応し、各列は 1 つの変数に対応します。

    • 数値行列の場合

      • X の列に含まれている変数の順序は、Mdl に学習させた予測子変数の順序と同じでなければなりません。

      • table (たとえば Tbl) を使用して Mdl に学習をさせる場合、Tbl に含まれている予測子変数が数値のみであれば、X を数値行列にすることができます。学習時に Tbl 内の数値予測子をカテゴリカルとして扱うには、fitrnet の名前と値の引数 CategoricalPredictors を使用してカテゴリカル予測子を指定します。Tbl に種類の異なる予測子変数 (数値および categorical データ型など) が混在し、X が数値行列である場合、predict でエラーがスローされます。

    • table の場合

      • predict は、文字ベクトルの cell 配列ではない cell 配列や複数列の変数をサポートしません。

      • table (たとえば Tbl) を使用して Mdl に学習をさせた場合、X 内のすべての予測子変数は変数名およびデータ型が、Mdl に学習させた (Mdl.PredictorNames に格納されている) 変数と同じでなければなりません。ただし、X の列の順序が Tbl の列の順序に対応する必要はありません。また、TblX に追加の変数 (応答変数や観測値の重みなど) を含めることができますが、predict はこれらを無視します。

      • 数値行列を使用して Mdl に学習をさせる場合、Mdl.PredictorNames 内の予測子名と X 内の対応する予測子変数名が同じでなければなりません。学習時に予測子の名前を指定するには、fitrnet の名前と値の引数 PredictorNames を使用します。X 内の予測子変数はすべて数値ベクトルでなければなりません。X に追加の変数 (応答変数や観測値の重みなど) を含めることができますが、predict はこれらを無視します。

    Mdl に学習させるときに fitrnetStandardize=true を設定した場合、予測子データの数値列が対応する平均 (Mdl.Mu) および標準偏差 (Mdl.Sigma) を使用して標準化されます。

    メモ

    観測値が列に対応するように予測子行列を配置して ObservationsIn="columns" を指定すると、計算時間が大幅に短縮される可能性があります。table の予測子データや多重応答回帰に対して ObservationsIn="columns" を指定することはできません。

    データ型: single | double | table

    名前と値の引数

    すべて折りたたむ

    オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

    例: predict(Mdl,X,ObservationsIn="columns") は、予測子データの列が観測値に対応することを示します。

    予測子データにおける観測値の次元。"rows" または "columns" として指定します。

    メモ

    観測値が列に対応するように予測子行列を配置して ObservationsIn="columns" を指定すると、計算時間が大幅に短縮される可能性があります。table の予測子データや多重応答回帰に対して ObservationsIn="columns" を指定することはできません。

    データ型: char | string

    R2024b 以降

    予測応答 yfit の出力タイプ。"matrix" または "table" として指定します。この引数は、Mdl が複数の応答変数をもつモデルの場合のみ有効です。

    例: OutputType="table"

    データ型: char | string

    R2023b 以降

    予測子に欠損値がある観測値に使用する予測した応答値。"median""mean"、または数値スカラーとして指定します。

    説明
    "median"predict は、予測子に欠損値がある観測値について予測した応答値として、学習データ内の観測された応答値の中央値を使用します。
    "mean"predict は、予測子に欠損値がある観測値について予測した応答値として、学習データ内の観測された応答値の平均値を使用します。
    数値スカラーpredict は、予測子に欠損値がある観測値について予測した応答値として、この値を使用します。

    例: PredictionForMissingValue="mean"

    例: PredictionForMissingValue=NaN

    データ型: single | double | char | string

    出力引数

    すべて折りたたむ

    予測応答。数値のベクトル、行列、または table として返されます。

    • yfit が数値ベクトルの場合、yfit のエントリ iX の観測値 i に対応します。

    • yfit が数値ベクトルまたは数値 table の場合、yfit の行 iX の観測値 i に対応します。

    代替機能

    Simulink ブロック

    Simulink® にニューラル ネットワーク回帰モデルの予測を統合するには、Statistics and Machine Learning Toolbox™ ライブラリにある RegressionNeuralNetwork Predict ブロックを使用するか、MATLAB® Function ブロックを関数 predict と共に使用します。例については、RegressionNeuralNetwork Predict ブロックの使用による応答の予測MATLAB Function ブロックの使用によるクラス ラベルの予測を参照してください。

    使用するアプローチを判断する際は、以下を考慮してください。

    • Statistics and Machine Learning Toolbox ライブラリ ブロックを使用する場合、固定小数点ツール (Fixed-Point Designer)を使用して浮動小数点モデルを固定小数点に変換できます。

    • MATLAB Function ブロックを関数 predict と共に使用する場合は、可変サイズの配列に対するサポートを有効にしなければなりません。

    • MATLAB Function ブロックを使用する場合、予測の前処理や後処理のために、同じ MATLAB Function ブロック内で MATLAB 関数を使用することができます。

    拡張機能

    すべて展開する

    バージョン履歴

    R2021a で導入

    すべて展開する