このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

cvshrink

R2026a

線形判別の正則化の交差検証

構文

err = cvshrink(Mdl)

[err,gamma] = cvshrink(Mdl)

[err,gamma,delta] = cvshrink(Mdl)

[err,gamma,delta,numpred] = cvshrink(Mdl)

[___] = cvshrink(Mdl,Name=Value)

説明

err = cvshrink(Mdl) は、正則化パラメーター gamma の異なる値で交差検証された分類誤差の値を含むベクトルを返します。

[err,gamma] = cvshrink(Mdl) は、gamma の値のベクトルも返します。

[err,gamma,delta] = cvshrink(Mdl) は、delta の値のベクトルも返します。

[err,gamma,delta,numpred] = cvshrink(Mdl) は、パラメーター gamma および delta の各設定に対する非ゼロの予測子の数を含むベクトルまたは行列を返します。

[___] = cvshrink(Mdl,Name=Value) では、1 つ以上の名前と値の引数を使用して追加オプションを指定します。たとえば、交差検証用の delta 区間および gamma 区間の数や進捗メッセージの詳細レベルを指定できます。

例

多くの予測子をもつデータの正則化

判別分析分類器を正則化し、モデル内の予測子の数と分類精度の間のトレードオフを表示します。

データ ovariancancer の線形判別分析分類器を作成します。結果のモデルを適度に小さく維持するためにオプション SaveMemory とオプション FillCoeffs を設定します。

load ovariancancer
obj = fitcdiscr(obs,grp,...
    'SaveMemory','on','FillCoeffs','off');

Gamma の 10 レベルと Delta の 10 レベルを使用して、適切なパラメーターを検索します。この検索には時間がかかります。進行状況を表示するために Verbose を 1 に設定します。

rng('default') % for reproducibility
[err,gamma,delta,numpred] = cvshrink(obj,...
    'NumGamma',9,'NumDelta',9,'Verbose',1);

Done building cross-validated model.
Processing Gamma step 1 out of 10.
Processing Gamma step 2 out of 10.
Processing Gamma step 3 out of 10.
Processing Gamma step 4 out of 10.
Processing Gamma step 5 out of 10.
Processing Gamma step 6 out of 10.
Processing Gamma step 7 out of 10.
Processing Gamma step 8 out of 10.
Processing Gamma step 9 out of 10.
Processing Gamma step 10 out of 10.

予測子の数に対して分類誤差率をプロットします。

plot(err,numpred,'k.')
xlabel('Error rate');
ylabel('Number of predictors');

入力引数

Mdl — 学習済みの判別分析分類器

ClassificationDiscriminant モデル オブジェクト

学習済みの判別分析分類器。fitcdiscr で学習させた ClassificationDiscriminant モデル オブジェクトとして指定します。

名前と値の引数

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

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

例: [err,gamma,delta,numpred] = cvshrink(Mdl,NumGamma=9,NumDelta=9,Verbose=1);

delta — 交差検証用の Delta 値

0 (既定値) | 数値行ベクトル | 数値行列

交差検証用の Delta 値。数値スカラー、行ベクトル、または行列として指定します。

• スカラー delta — cvshrink は、この delta の値と gamma のすべての値を正則化に使用します。

• 行ベクトル delta — 各 i および j に対して、cvshrink は delta(j) と gamma(i) を正則化に使用します。

• 行列 delta — delta の行数は gamma に含まれる要素の数と等しくなければなりません。各 i および jに対して、cvshrink は delta(i,j) と gamma(i) を正則化に使用します。

例: delta=[0 .01 .1]

データ型: double

gamma — 交差検証用の Gamma 値

0:0.1:1 (既定値) | 数値ベクトル

交差検証用の Gamma 値。数値ベクトルとして指定します。

例: gamma=[0 .01 .1]

データ型: double

NumDelta — 交差検証用の delta 区間の数

0 (既定値) | 非負の整数

交差検証用の delta 区間の数。非負の整数として指定します。cvshrink は、すべての gamma の値について、ゼロから delta の最大値までの NumDelta + 1 個の等間隔な delta の値を使用して判別式を交差検証します。最大値では、すべての予測子がこの値の gamma について排除されます。delta を設定した場合、cvshrink は NumDelta を無視します。

例: NumDelta=3

データ型: double

NumGamma — 交差検証用の gamma 区間の数

10 (既定値) | 非負の整数

交差検証用の gamma 区間の数。非負の整数として指定します。cvshrink は、MinGamma から 1 までの NumGamma + 1 個の等間隔な gamma の値を使用して判別式を交差検証します。gamma を設定した場合、cvshrink は NumGamma を無視します。

例: NumGamma=3

データ型: double

Verbose — 詳細レベル

0 (既定値) | 1 | 2

詳細レベル。0、1、または 2 を指定します。値が大きいほど進捗メッセージの数が増えます。

例: Verbose=2

データ型: double

出力引数

err — 誤分類誤差率

数値ベクトル | 数値行列

誤分類誤差率。誤差の数値のベクトルまたは行列として返されます。誤分類誤差率は、すべての分割で誤分類されたデータの平均の比率です。

• delta がスカラー (既定) の場合、err(i) は gamma(i) で正則化された Mdl に対する誤分類誤差率です。

• delta がベクトルの場合、err(i,j) は gamma(i) と delta(j) で正則化された Mdl に対する誤分類誤差率です。

• delta が行列の場合、err(i,j) は gamma(i) と delta(i,j) で正則化された Mdl に対する誤分類誤差率です。

gamma — 正則化に使用された Gamma 値

数値ベクトル

正則化に使用された Gamma 値。数値ベクトルとして返されます。ガンマとデルタを参照してください。

delta — 正則化に使用された Delta 値

数値ベクトル | 数値行列

正則化に使用された Delta 値。数値ベクトルまたは行列として返されます。ガンマとデルタを参照してください。

• 名前と値の引数 delta にスカラーを指定した場合、出力 delta は gamma と同じサイズで、入力スカラーと等しいエントリをもつ行ベクトルになります。

• 名前と値の引数 delta に行ベクトルを指定した場合、出力 delta はこの行ベクトルと同じ列数で gamma の要素の数と等しい行数の行列になります。出力 delta(i,j) は入力 delta(j) と等しくなります。

• 名前と値の引数 delta に行列を指定した場合、出力 delta はこの入力行列と同じになります。delta の行数は、gamma 内の要素の数と等しくなければなりません。

numpred — さまざまな正則化を実行したときのモデル内の予測子の数

数値ベクトル | 数値行列

さまざまな正則化を実行したときのモデル内の予測子の数。数値ベクトルまたは行列として返されます。numpred は err と同じサイズです。

• delta がスカラー (既定) の場合、numpred(i) は gamma(i) と delta で正則化された Mdl の予測子の数です。

• delta がベクトルの場合、numpred(i,j) は gamma(i) と delta(j) で正則化された Mdl の予測子の数です。

• delta が行列の場合、numpred(i,j) は gamma(i) と delta(i,j) で正則化された Mdl の予測子の数です。

詳細

ガンマとデルタ

正則化とは、効果的な予測モデルを生み出す予測子の小さな集合を見つけ出す過程です。線形判別分析には、γ および δ の 2 つのパラメーターがあり、これらは次のように正則化を制御します。cvshrink は適切なパラメーター値の選択を支援します。

Σ がデータ X の共分散行列を表し、$$\widehat{X}$$ が中心データ (データ X からクラス別の平均を減算したデータ) であるとします。次のように定義します。

$$D=\text{diag}\left({\widehat{X}}^T*\widehat{X}\right).$$

正則化した共分散行列 $$\tilde{\Sigma }$$ は次のようになります。

$$\tilde{\Sigma }=\left(1-\gamma \right)\Sigma +\gamma D.$$

γ ≥ MinGamma である場合、$$\tilde{\Sigma }$$ は常に正則です。

μ_k を k クラスの X の要素の平均ベクトルとし、μ₀ をグローバル平均ベクトル (X の行の平均) とします。C がデータ X の相関行列、$$\tilde{C}$$ が正則化された相関行列であるとします。

$$\tilde{C}=\left(1-\gamma \right)C+\gamma I,$$

ここで、I が単位行列です。

データ点 x の正則化された判別分析分類器にある線形項は

$${\left(x-{\mu }_0\right)}^T{\tilde{\Sigma }}^{-1}\left({\mu }_k-{\mu }_0\right)=\left[{\left(x-{\mu }_0\right)}^T{D}^{-1/2}\right]\left[{\tilde{C}}^{-1}{D}^{-1/2}\left({\mu }_k-{\mu }_0\right)\right].$$

パラメーター δ は、大かっこ内の最後の項にしきい値としてこの式を入力します。ベクトル $$\left[{\tilde{C}}^{-1}{D}^{-1/2}\left({\mu }_k-{\mu }_0\right)\right]$$ の各成分は、大きさがしきい値 δ より小さい場合、ゼロが設定されます。そのため、クラス k に対して、コンポーネント j のしきい値を 0 に設定した場合、x のコンポーネント j は事後確率の評価には入りません。

DeltaPredictor プロパティは、このしきい値に関係するベクトルです。δ ≥ DeltaPredictor(i) の場合、すべてのクラス k には次の値があります。

$$\left|{\tilde{C}}^{-1}{D}^{-1/2}\left({\mu }_k-{\mu }_0\right)\right|\le \delta .$$

したがって、δ ≥ DeltaPredictor(i) の場合、正則化された分類器は予測子 i を使用しません。

ヒント

• err および numpred 出力を調べて、交差検証誤差と予測子の数の間のトレードオフを確認します。満足のいく点が見つかったら、ドット表記を使用して対応する gamma および delta プロパティをモデルに設定します。たとえば、(i,j) が満足のいく点の位置である場合は、次のように設定します。

  Mdl.Gamma = gamma(i);
  Mdl.Delta = delta(i,j);

バージョン履歴

R2012b で導入

参考

オブジェクト

• ClassificationDiscriminant

関数

• fitcdiscr

トピック

• 判別分析分類器の正則化
• 判別分析による分類