メインコンテンツ

resubPredict

R2026b

再代入によるアンサンブル回帰の応答の予測

説明

Yfit = resubPredict(ens) は、データ ens.X について ens で予測された応答を含む ens.X 要素のベクトルを返します。Yfit には、関数 fitrensemble で ens の作成に使用されたデータに関する ens の予測が格納されます。

例

Yfit = resubPredict(ens,Name=Value) では、1 つ以上の名前と値の引数を使用して追加オプションを指定します。たとえば、応答を予測するための弱学習器のインデックスや計算を並列に実行するかどうかを指定できます。

例

すべて折りたたむ

carsmall データによる燃費の再代入予測を求め、学習データに対する平均二乗平均差分を調べます。

carsmall データ セットを読み込み、馬力と車両重量を予測子として選択します。

load carsmall
X = [Horsepower Weight];

回帰木のアンサンブルに学習をさせます。

ens = fitrensemble(X,MPG,Method="LSBoost",Learners="Tree");

MPG の再代入予測を求めます。

Yfit = resubPredict(ens);

学習データに対する再代入予測の平均二乗差分を計算します。

MSE = mean((Yfit - ens.Y).^2)
MSE = 
0.5836

resubLoss の場合と同じ結果であることを確認します。

resubLoss(ens)
ans = 
0.5836

入力引数

すべて折りたたむ

アンサンブル回帰モデル。fitrensemble で学習させた RegressionEnsemble または RegressionBaggedEnsemble モデル オブジェクトとして指定します。

名前と値の引数

すべて折りたたむ

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

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、、Name を引用符で囲みます。

例: resubPredict(ens,Learners=[1 2 3 5],UseParallel="auto") は、アンサンブル内の 1 番目、2 番目、3 番目、および 5 番目の学習器を使用し、計算を並列に実行するように指定します。

resubPredict で使用するアンサンブル内の弱学習器のインデックス。範囲 [1:ens.NumTrained] の正の整数のベクトルとして指定します。既定では、この関数はすべての学習器を使用します。

例: Learners=[1 2 4]

データ型: single | double

ワーカーの並列プールを使用して計算を並列実行するためのオプション。次のいずれかの値を指定します。

  • "off" — MATLAB® クライアントで逐次実行します。

  • "auto" — 並列プールが開いている場合、または MATLAB が並列プールを自動的に作成できる場合は、その並列プールを使用します。並列プールが利用できない場合は、MATLAB クライアントでシリアル実行します。

  • "on" — 並列プールが開いている場合、または MATLAB が並列プールを自動的に作成できる場合は、その並列プールを使用します。並列プールが利用できない場合は、エラーをスローします。

並列プールが開いておらず、自動プール作成が有効になっている場合、MATLAB は既定のクラスター プロファイルを使用して並列プールを開きます。MATLAB で並列プールを使用して計算を実行するには、Parallel Computing Toolbox™ が必要です。詳細については、自動並列サポートを使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

R2026b より前: 並列実行するには、UseParallel を true に設定します。

例: UseParallel="auto"

データ型: char | string

出力引数

すべて折りたたむ

予測応答値。X と同じ行数の数値列ベクトルとして返されます。Yfit の各行は、X の対応する行に対して回帰モデル ens に基づいて予測した応答を与えます。

拡張機能

すべて展開する

バージョン履歴

R2011a で導入

すべて展開する