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

plotResiduals

非線形回帰モデルの残差プロット

構文

plotResiduals(mdl)

plotResiduals(mdl,plottype)

plotResiduals(mdl,plottype,Name,Value)

h = plotResiduals(___)

説明

plotResiduals(mdl) は、非線形回帰モデル (mdl) の残差のヒストグラム プロットを作成します。

plotResiduals(mdl,plottype) は、残差のプロット タイプ plottype を指定します。

plotResiduals(mdl,plottype,Name,Value) では、1 つ以上の名前と値の引数を使用して追加オプションを指定します。たとえば、残差のタイプや、残差のデータ点のグラフィック プロパティを指定できます。

h = plotResiduals(___) は、前の構文におけるいずれかの入力引数の組み合わせを使用して、プロット内のラインまたはパッチのグラフィックス オブジェクトを返します。プロットの作成後に特定のラインまたはパッチのプロパティを修正するには、h を使用します。プロパティの一覧については、Line のプロパティ および Patch のプロパティ を参照してください。

例

残差プロット

近似非線形モデルの残差をプロットします。

reaction データを読み込み、反応物の関数として反応速度のモデルを当てはめます。

load reaction
mdl = fitnlm(reactants,rate,@hougen,[1 .05 .02 .1 2]);

近似モデルの残差をプロットします。

plotResiduals(mdl)

残差の確率プロット

近似非線形モデルの残差の正規確率プロットを作成します。

reaction データを読み込み、反応物の関数として反応速度のモデルを当てはめます。

load reaction
mdl = fitnlm(reactants,rate,@hougen,[1 .05 .02 .1 2]);

当てはめたモデルの残差の正規確率プロットを作成します。

plotResiduals(mdl,'probability')

入力引数

mdl — 非線形回帰モデル オブジェクト

NonLinearModel オブジェクト

非線形回帰モデル オブジェクト。fitnlm を使用して作成される NonLinearModel オブジェクトとして指定します。

plottype — プロット タイプ

'histogram' (既定値) | 'caseorder' | 'fitted' | 'lagged' | 'probability' | 'symmetry'

プロット タイプ。次の表のいずれかの値として指定します。

値	説明
'caseorder'	残差とケース順 (行番号) の比較
'fitted'	残差と近似値の比較
'histogram'	確率密度関数のスケールを使用した、残差のヒストグラム。各バーの面積は、観測値の相対的な個数です。バーの面積の合計は 1 に等しくなります。
'lagged'	残差とラグ付き残差の比較 (r(t) と r(t – 1))
'probability'	残差の正規確率プロット。詳細については、probplotを参照してください。
'symmetry'	メディアン周辺の残差の対称性プロット (上裾の残差から中央値を減算した値と中央値から下裾の残差を減算した値の比較)。このプロットには、残差の対称性を確認するための、y = x に対応する点線の基準線が含まれています。

名前と値の引数

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

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

例: 'Color','blue','Marker','o'

メモ

ここでは、グラフィック プロパティの一部だけを紹介しています。完全な一覧は、ラインについては Line のプロパティ、ヒストグラムについては Patch のプロパティ を参照してください。指定したプロパティは、残差のデータ点の外観またはヒストグラムの外観に適用されます。

Color — ラインの色

RGB 3 成分 | 16 進数のカラー コード | 色の名前 | 省略名

ラインの色。'Color' と RGB 3 成分、16 進数のカラー コード、または、以下の表に記載されているいずれかの色オプションに対応する色の名前または省略名から構成されるコンマ区切りのペアとして指定します。

'MarkerEdgeColor' が 'auto' (既定) であり 'MarkerFaceColor' が 'auto' である場合、名前と値のペアの引数 'Color' はマーカーの輪郭の色とマーカーの塗りつぶし色も決定します。

カスタム色の場合は、RGB 3 成分または 16 進数のカラー コードを指定します。

• RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 要素の行ベクトルです。強度は範囲 [0,1] に含まれていなければなりません。たとえば [0.4 0.6 0.7] のようになります。

• 16 進数のカラー コードは、ハッシュ記号 (#) で始まり、0 から F の範囲にある 16 進数が 3 つまたは 6 つ続く、string スカラーまたは文字ベクトルです。この値では、大文字と小文字は区別されません。したがって、カラー コード "#FF8800"、"#ff8800"、"#F80"、"#f80" は等価です。

あるいは、一部の一般的な色を名前で指定できます。次の表は、名前が付いた色のオプション、等価な RGB 3 成分、および 16 進数のカラー コードの一覧です。

色の名前	省略名	RGB 3 成分	16 進数のカラー コード	外観
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	該当なし	該当なし	該当なし	色なし

以下は、MATLAB^® が多くのタイプのプロットで使用する既定の色に対する RGB 3 成分および 16 進数のカラー コードです。

RGB 3 成分	16 進数のカラー コード	外観
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

例: 'Color','blue'

LineWidth — ラインの幅

正の値

ラインの幅。'LineWidth' と正の値 (ポイント単位) から構成されるコンマ区切りのペアとして指定します。ラインにマーカーがある場合、ライン幅はマーカー エッジにも影響を与えます。

例: 'LineWidth',0.75

Marker — マーカー記号

'o' | '+' | '*' | '.' | 'x' | ...

マーカー記号。'Marker' と次の表のいずれかの値から構成されるコンマ区切りのペアとして指定します。

マーカー	説明	結果として得られるマーカー
"o"	円
"+"	プラス記号
"*"	アスタリスク
"."	点
"x"	十字
"_"	水平線
"|"	垂直線
"square"	正方形
"diamond"	菱形
"^"	上向き三角形
"v"	下向き三角形
">"	右向き三角形
"<"	左向き三角形
"pentagram"	星形五角形
"hexagram"	星形六角形
"none"	マーカーなし	該当なし

例: 'Marker','+'

MarkerEdgeColor — マーカーの輪郭の色

'auto' (既定値) | 'none' | RGB 3 成分 | 16 進数のカラー コード | 色の名前 | 省略名

マーカーの輪郭の色。'MarkerEdgeColor' と RGB 3 成分、16 進数のカラー コード、または、名前と値のペアの引数 Color に記載されているいずれかの色オプションに対応する色の名前または省略名から構成されるコンマ区切りのペアとして指定します。

既定値 'auto' では、'Color' を使用して指定されるものと同じ色が使用されます。

例: 'MarkerEdgeColor','blue'

MarkerFaceColor — マーカーの塗りつぶし色

'none' (既定値) | 'auto' | RGB 3 成分 | 16 進数のカラー コード | 色の名前 | 省略名

マーカーの塗りつぶし色。'MarkerFaceColor' と RGB 3 成分、16 進数のカラー コード、または、名前と値のペアの引数 Color に記載されているいずれかの色オプションに対応する色の名前または省略名から構成されるコンマ区切りのペアとして指定します。

値 'auto' では、'Color' を使用して指定されるものと同じ色が使用されます。

例: 'MarkerFaceColor','blue'

MarkerSize — マーカー サイズ

6 (既定値) | 正の値

マーカー サイズ。'MarkerSize' と正の値 (ポイント単位) から構成されるコンマ区切りのペアとして指定します。

例: 'MarkerSize',2

ResidualType — 残差のタイプ

'raw' (既定値) | 'pearson' | 'standardized' | 'studentized'

プロットで使用する残差のタイプ。'ResidualType' と次のいずれかの値から構成されるコンマ区切りのペアとして指定します。

値	説明
'raw'	観測した値から当てはめた値を減算した値
'pearson'	生の残差を平方根平均二乗誤差 (RMSE) で除算した値
'standardized'	推定標準偏差で除算した生の残差
'studentized'	標準偏差の独立した (delete-1) 推定値で除算した生の残差

mdl の Residuals プロパティには、plotResiduals がプロットの作成に使用した残差の値が格納されます。

詳細については、残差を参照してください。

例: 'ResidualType','Pearson'

出力引数

h — グラフィックス オブジェクト

グラフィックス配列

プロット内のラインまたはパッチに対応するグラフィックス オブジェクト。グラフィックス配列として返されます。グラフィックス オブジェクトのプロパティのクエリと設定を行うには、ドット表記を使用します。詳細については、Line のプロパティ および Patch のプロパティ を参照してください。

名前と値のペアの引数を使用して、1 番目のグラフィックス オブジェクト h(1) に対応する、残差のデータ点の外観またはヒストグラムの外観を指定できます。

ヒント

• データ カーソルを使用すると、選択したプロットの点の値がデータ ヒント (データ点の横にある小さいテキスト ボックス) に表示されます。データ ヒントには、選択した点の x 軸および y 軸の値と、観測値の名前または番号が含まれます。

バージョン履歴

R2012a で導入

参考

NonLinearModel | plotDiagnostics

トピック

• 品質の調査と近似非線形モデルの調整
• 非線形回帰ワークフロー
• 非線形回帰