Main Content

ConfusionMatrixChart のプロパティ

混同行列チャートの外観と動作

ConfusionMatrixChart のプロパティは、ConfusionMatrixChart オブジェクトの外観と動作を制御します。プロパティの値を変更することで、混同行列チャートの一定の部分を変更できます。たとえば、タイトルを追加できます。

cm = confusionchart([1 3 5; 2 4 6; 11 7 3]);
cm.Title = 'My Confusion Matrix Title';

ラベル

すべて展開する

混同行列チャートのタイトル。文字ベクトルまたは string スカラーを指定します。

例: cm = confusionchart(__,'Title','My Title Text')

例: cm.Title = 'My Title Text'

x 軸のラベル。string スカラーまたは文字ベクトルを指定します。

例: cm = confusionchart(__,'XLabel','My Label')

例: cm.XLabel = 'My Label'

x 軸のラベル。string スカラーまたは文字ベクトルを指定します。

例: cm = confusionchart(__,'YLabel','My Label')

例: cm.YLabel = 'My Label'

このプロパティは読み取り専用です。

混同行列チャートのクラス ラベル。categorical ベクトル、数値ベクトル、string ベクトル、文字配列、文字ベクトルの cell 配列、または logical ベクトルとして格納されます。

行と列の要約

すべて展開する

混同行列チャートの列の要約。以下のいずれかを指定します。

オプション説明
'off'列の要約を表示しません。
'absolute'各予測クラスについて、正しく分類された観測値と誤って分類された観測値の総数を表示します。
'column-normalized'各予測クラスについて、正しく分類された観測値と誤って分類された観測値の個数を、対応する予測クラスの観測値数に対する割合で表示します。正しく分類された観測値の割合は、クラス単位の精度 (または陽性の予測値) であると考えることができます。
'total-normalized'各予測クラスについて、正しく分類された観測値と誤って分類された観測値の個数を、観測値の総数に対する割合で表示します。

例: cm = confusionchart(__,'ColumnSummary','column-normalized')

例: cm.ColumnSummary = 'column-normalized'

混同行列チャートの行の要約。次のいずれかを指定します。

オプション説明
'off'行の要約を表示しません。
'absolute'真のクラスのそれぞれについて、正しく分類された観測値と誤って分類された観測値の総数を表示します。
'row-normalized'真のクラスのそれぞれについて、正しく分類された観測値と誤って分類された観測値の個数を、対応する予測クラスの観測値数に対する割合で表示します。正しく分類された観測値の割合は、クラス単位の再現率 (つまり真陽性率) であると考えることができます。
'total-normalized'真のクラスのそれぞれについて、正しく分類された観測値と誤って分類された観測値の個数を、観測値の総数に対する割合で表示します。

例: cm = confusionchart(__,'RowSummary','row-normalized')

例: cm.RowSummary = 'row-normalized'

データ

すべて展開する

このプロパティは読み取り専用です。

混同行列の値。数値行列として格納されます。このプロパティは、Normalization プロパティの方式を使用して正規化された混同行列の値に等しくなります。混同行列の正規化値は Normalization プロパティを変更するたびに再計算されます。

セルの値の正規化。次のいずれかを指定します。

オプション説明
'absolute'観測値の総数を各セルに表示します。
'column-normalized'予測クラスが同じである観測値の個数によって各セルの値を正規化します。
'row-normalized'真のクラスが同じである観測値の個数によって各セルの値を正規化します。
'total-normalized'観測値の総数によって各セルの値を正規化します。

セルの値の正規化を変更すると、セルの色も変更されます。

例: cm = confusionchart(__,'Normalization','total-normalized')

例: cm.Normalization = 'total-normalized'

色とスタイル

すべて展開する

グリッドの可視性の状態。'on'/'off' として指定するか、数値または logical の 1 (true) または 0 (false) として指定します。'on' の値は true と等価で、'off' の値は false と等価です。そのため、このプロパティの値を logical 値として使用できます。この値は、matlab.lang.OnOffSwitchState 型の on/off logical 値として保存されます。

  • 'on' — チャートの各セルの間にグリッド ラインを表示します。

  • 'off' — チャートの各セルの間にグリッド ラインを表示しません。

例: cm = confusionchart(__,'GridVisible','off')

例: cm.GridVisible = 'off'

対角線上のセルの色。RGB 3 成分、16 進数のカラー コード、色の名前または省略名を指定します。対角線上の各セルの色は、セルの値と DiagonalColor プロパティに比例し、混同行列チャートのセルの最大値に対して正規化されます。正の値のセルには、色の最小値を使用した、DiagonalColor プロパティに比例する色が付けられます。

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"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

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

RGB 3 成分16 進数のカラー コード外観
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

セル ラベルのテキストは、チャートのセルの色に応じた適切な色が自動的に選択されます。

例: cm = confusionchart(__,'DiagonalColor','blue')

例: cm.DiagonalColor = 'blue'

対角線外のセルの色。RGB 3 成分、16 進数のカラー コード、色の名前または省略名を指定します。対角線上の各セルの色は、セルの値と OffDiagonalColor プロパティに比例し、混同行列チャートのセルの最大値に対して正規化されます。正の値のセルには、色の最小値を使用した、OffDiagonalColor プロパティに比例する色が付けられます。

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"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

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

RGB 3 成分16 進数のカラー コード外観
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

セル ラベルのテキストは、チャートのセルの色に応じた適切な色が自動的に選択されます。

例: cm = confusionchart(__,'OffDiagonalColor','blue')

例: cm.OffDiagonalColor = 'blue'

タイトル、軸ラベルおよびクラス ラベルのテキストの色。RGB 3 成分、16 進数のカラー コード、色の名前または省略名として指定します。

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"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

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

RGB 3 成分16 進数のカラー コード外観
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

セル ラベルのテキストは、チャートのセルの色に応じた適切な色が自動的に選択されます。

例: cm = confusionchart(__,'FontColor','blue')

例: cm.FontColor = 'blue'

フォント

すべて展開する

フォント名。システムがサポートするフォント名を指定します。既定のフォントは、オペレーティング システムおよびロケールによって異なります。

例: cm = confusionchart(__,'FontName','Cambria')

例: cm.FontName = 'Cambria'

タイトル、軸ラベル、クラス ラベルおよびセル ラベルのフォント サイズ。正のスカラーを指定します。既定のフォントは、オペレーティング システムおよびロケールによって異なります。

タイトルと軸ラベルには、わずかに大きい (10% 拡大された) フォントが使用されます。セル内にセル ラベルを表示する十分な余地がない場合は、より小さいフォント サイズがセル ラベルに使用されます。セル ラベルが小さくなりすぎた場合は、非表示になります。

例: cm = confusionchart(__,'FontSize',12)

例: cm.FontSize = 12

位置

すべて展開する

装飾を追加、削除、変更する際に維持する位置プロパティ。以下のいずれかの値として指定します。

  • 'outerposition' — タイトルや軸ラベルなどの装飾を追加、削除、変更する際に OuterPosition プロパティを維持します。位置を調整する必要がある場合、MATLAB は InnerPosition プロパティの方を調整します。

  • 'innerposition' — タイトルや軸ラベルなどの装飾を追加、削除、変更する際に InnerPosition プロパティを維持します。位置を調整する必要がある場合、MATLAB は OuterPosition プロパティの方を調整します。

メモ

親コンテナーが TiledChartLayout である場合、このプロパティを設定しても効果はありません。

親コンテナー (Figure、パネルまたはタブ) 内の外側のサイズおよび位置。[left bottom width height] という形式の 4 要素のベクトルを指定します。外側の位置には、タイトル、軸ラベルおよびクラス ラベルが含まれます。

  • left および bottom 要素は、コンテナーの左下隅からチャートの左下隅までの距離を定義します。

  • width および height 要素はチャートのサイズであり、チャートのセルと、周囲のテキストのための余白が含まれます。

既定値 [0 0 1 1] は、コンテナーの内側全体です。

既定では、値はコンテナーに対して正規化されます。単位を変更するには、Units プロパティを設定します。

例: cm = confusionchart(__,'OuterPosition',[0.1 0.1 0.8 0.8])

例: cm.OuterPosition = [0.1 0.1 0.8 0.8]

親コンテナー (Figure、パネルまたはタブ) 内のチャートの内側のサイズおよび位置。[left bottom width height] という形式の 4 要素のベクトルとして返されます。内側の位置には、タイトル、軸ラベルまたはクラス ラベルは含まれません。

  • left および bottom 要素は、コンテナーの左下隅からチャートの左下隅までの距離を定義します。

  • width および height 要素はチャートのサイズであり、チャートのセルのみが含まれます。

例: cm = confusionchart(__,'InnerPosition',[0.1 0.1 0.8 0.8])

例: cm.InnerPosition = [0.1 0.1 0.8 0.8]

親コンテナー (Figure、パネルまたはタブ) 内のチャートの内側のサイズおよび位置。[left bottom width height] という形式の 4 要素のベクトルとして返されます。このプロパティは、InnerPosition プロパティと等価です。

位置の単位。次のいずれかの値を指定します。

Units説明
'normalized'コンテナー (通常は Figure またはパネル) に対して正規化します。コンテナーの左下隅は (0,0)、右下隅は (1,1) に対応します。
'inches'インチ。
'centimeters'センチメートル。
'characters'

グラフィックス ルート オブジェクトの既定 uicontrol フォントに基づきます。

  • 文字の幅 = 文字 x の幅。

  • 文字の高さ = 2 行のテキストのベースライン間の距離。

'points'タイポグラフィーのポイント数。1 ポイントは 1/72 インチです。
'pixels'

ピクセル数。

R2015b 以降、Windows® システムと Macintosh システムではピクセル単位の距離がシステムの解像度に依存しなくなりました。

  • Windows システムでは、1 ピクセルは 1/96 インチです。

  • Macintosh システムでは、1 ピクセルは 1/72 インチです。

Linux® システムでは、ピクセルのサイズはシステムの解像度によって決定されます。

オブジェクト作成時に単位を名前と値のペアとして指定する場合、これらの単位を使用するプロパティ (OuterPosition など) を指定する前に、Units プロパティを設定しなければなりません。

レイアウト オプション。TiledChartLayoutOptions オブジェクトまたは GridLayoutOptions オブジェクトとして指定します。このプロパティは、チャートが、タイル表示チャート レイアウトまたはグリッド レイアウトの場合に便利です。

グリッド レイアウトやタイル表示チャート レイアウトの中でチャートの位置を決めるには、TiledChartLayoutOptions オブジェクトの Tile プロパティおよび TileSpan プロパティを設定します。たとえば、3 行 3 列のタイル表示チャート レイアウトを考えます。このレイアウトでは、中央にタイルのグリッドがあり、外側のエッジに沿って 4 つのタイルがあります。実際には、グリッドは非表示であり、外側のタイルは、軸またはチャートを挿入するまでスペースを占有しません。

Diagram of a 3-by-3 tiled chart layout.

次のコードにより、グリッドの 3 番目のタイルにチャート c が配置されます。

c.Layout.Tile = 3;

チャートが複数のタイルにまたがるようにするには、TileSpan プロパティを 2 要素ベクトルとして指定します。たとえば、次のチャートは 23 列のタイルにまたがります。

c.Layout.TileSpan = [2 3];

チャートを周囲のいずれかのタイル内に配置するには、Tile プロパティを 'north''south''east''west' のいずれかとして指定します。たとえば、値を 'east' に設定すると、チャートがグリッドの右にあるタイル内に配置されます。

c.Layout.Tile = 'east';

チャートをアプリ内のレイアウトに配置するには、このプロパティを GridLayoutOptions オブジェクトとして指定します。アプリ内のグリッド レイアウトの処理に関する詳細については、uigridlayout を参照してください。

チャートが、タイル表示チャート レイアウトとグリッド レイアウトのいずれの子でもない場合 (たとえば、Figure またはパネルの子である場合)、このプロパティは空であり、効果がありません。

可視性の状態。'on'/'off' として指定するか、数値または logical の 1 (true) または 0 (false) として指定します。'on' の値は true と等価で、'off' の値は false と等価です。そのため、このプロパティの値を logical 値として使用できます。この値は、matlab.lang.OnOffSwitchState 型の on/off logical 値として保存されます。

  • 'on' — チャートを表示します。

  • 'off' — チャートを削除せずに非表示にします。チャートが非表示であっても、そのプロパティにはアクセスできます。

親/子

すべて展開する

親コンテナー。FigurePanelTabTiledChartLayoutGridLayout のいずれかのオブジェクトとして指定します。

親の Children プロパティのチャート オブジェクト ハンドルの可視性。次のいずれかの値を指定します。

  • 'on' — オブジェクト ハンドルは常に表示されます。

  • 'off' — オブジェクト ハンドルは常に非表示になります。このオプションは、別の関数による意図しない UI への変更の防止に役立ちます。このような関数の実行時に一時的にハンドルを非表示にするには、HandleVisibility'off' に設定します。

  • 'callback' — コールバックによって起動されたコールバックまたは関数内ではオブジェクト ハンドルが表示されますが、コマンド ラインから起動された関数内では表示されません。このオプションは、コマンド ラインにおけるオブジェクトへのアクセスを阻止しますが、コールバック関数によるアクセスは許可します。

親の Children プロパティにオブジェクトがリストされていない場合、オブジェクト階層を探索するかハンドルのプロパティを問い合わせることによってオブジェクト ハンドルを取得する関数は、オブジェクト ハンドルを返すことができません。これには、getfindobjgcagcfgconewplotclaclfclose が含まれます。

非表示のオブジェクト ハンドルは、依然として有効です。ルートの ShowHiddenHandles プロパティを 'on' に設定すると、HandleVisibility プロパティの設定に関係なく、すべてのオブジェクト ハンドルがリストされます。

バージョン履歴

R2018b で導入