Histogram のプロパティ

ヒストグラムの外観と動作

Histogram プロパティはヒストグラムの外観と動作を制御します。プロパティの値を変更することによって、ヒストグラムの要素を変更できます。ドット表記を使用して、特定のオブジェクトとプロパティを参照します。

h = histogram(randn(10,1));
c = h.BinWidth;
h.BinWidth = 2;

ビン

すべて展開する

`NumBins` — ビンの数
正の整数

ビンの数。正の整数として指定します。NumBins を指定しない場合、histogram は使用するビンの数を入力データに基づいて自動的に計算します。

NumBins を BinMethod、BinWidth、または BinEdges と一緒に指定した場合、histogram は最後のパラメーターのみに従います。
このオプションは、カテゴリカルデータには適用されません。

`BinWidth` — ビンの幅
正のスカラー

ビンの幅。正のスカラーとして指定します。BinWidth を指定する場合、Histogram は最大 65,536 (2¹⁶) 個のビンを使用できます。指定したビンの幅によってさらに多くのビンが必要となる場合、histogram は最大のビン数に対応する、より大きいビンの幅を使用します。

datetime データおよび duration データの場合、BinWidth をスカラー期間またはカレンダー期間にすることができます。
BinWidth を BinMethod、NumBins、または BinEdges と一緒に指定した場合、histogram は最後のパラメーターのみに従います。
このオプションは、カテゴリカルデータには適用されません。

例: histogram(X,'BinWidth',5) は幅が 5 のビンを使用します。

`BinEdges` — ビンのエッジ
数値ベクトル

ビンのエッジ。数値ベクトルとして指定します。最初の要素は最初のビンの先頭のエッジを指定します。最後の要素は最後のビンの後方のエッジを指定します。後方のエッジは最後のビンにのみ含まれます。

ビンのエッジを指定しない場合、histogram は自動的にビンのエッジを決定します。

BinEdges を BinMethod、BinWidth、NumBins、または BinLimits と一緒に指定した場合、histogram は BinEdges のみに従い、BinEdges は最後に指定する必要があります。
このオプションは、カテゴリカルデータには適用されません。

`BinLimits` — ビンの範囲
2 要素ベクトル

ビンの範囲。2 要素ベクトル [bmin,bmax] として指定します。最初の要素は最初のビンのエッジを示します。2 番目の要素は最後のビンのエッジを示します。

このオプションを使用すると、ビンの範囲 X>=bmin & X<=bmax に含まれるデータのみを使用して計算します。

このオプションは、カテゴリカルデータには適用されません。

例: histogram(X,'BinLimits',[1,10]) は 1 以上 10 以下の X の値のみをビンに入れます。

`BinLimitsMode` — ビンの範囲の選択モード
`'auto'` (既定値) | `'manual'`

ビンの範囲の選択モード。'auto' または 'manual' で指定します。既定値は 'auto' であり、ビンの範囲はデータに合わせて自動的に調整されます。

BinLimits または BinEdges を指定すると、BinLimitsMode は 'manual' に設定されます。BinLimitsMode を 'auto' に指定すると、ビンの範囲はデータに合わせて再びスケーリングされます。
このオプションは、カテゴリカルデータのヒストグラムには適用されません。

`BinMethod` — ビン化アルゴリズム
`'auto'` (既定値) | `'scott'` | `'fd'` | `'integers'` | `'sturges'` | `'sqrt'` | ...

ビン化アルゴリズム。次の表のいずれかの値を指定します。

値	説明
`'auto'`	既定値の `'auto'` アルゴリズムは、データの範囲をカバーするビンの幅を選択することで、基となる分布の形状を明らかにします。
`'scott'`	スコットの法則はデータが正規分布に近い場合に最適です。この規則は他の多くの分布にも適しています。ビンの幅として `3.5std(X(:))numel(X)^(-1/3)` を使用します。
`'fd'`	Freedman-Diaconis の法則は、データの外れ値の影響を受けにくく、裾が大きい分布をもつデータにより適しています。ビンの幅として `2iqr(X(:))numel(X)^(-1/3)` を使用します。
`'integers'`	整数ルールは整数ごとにビンを作成するため整数データで役立ちます。幅が 1 のビンを使用し、ビンのエッジを整数の中間に設定します。誤って多すぎるビンを作成しないように、このルールを使用して作成するビンを 65536 (2¹⁶) 個以下に制限できます。データの範囲が 65,536 よりも大きい場合、整数ルールは代わりに幅の広いビンを使用します。 `'integers'` は datetime データまたは duration データをサポートしません。
`'sturges'`	Sturges の法則は簡単なためよく用いられています。ビンの数として `ceil(1 + log2(numel(X)))` を選択します。
`'sqrt'`	平方根ルールは他のソフトウェアパッケージで広く使用されています。ビンの数として `ceil(sqrt(numel(X)))` を選択します。

histogram は、これらの式を厳密に使用するのではなく、ビンのエッジが "きりのよい" 数字になるように、ビンの数をわずかに調整します。

datetime または duration データの場合は、ビンの幅をこれらの時間単位のいずれかとして指定します。

値	説明	データ型
`"second"`	各ビンは 1 秒です。	`datetime` と `duration`
`"minute"`	各ビンは 1 分です。	`datetime` と `duration`
`"hour"`	各ビンは 1 時間です。	`datetime` と `duration`
`"day"`	各ビンは 1 カレンダー日です。この値には、夏時間のシフトが考慮されます。	`datetime` と `duration`
`"week"`	各ビンは 1 カレンダー週です。	`datetime` のみ
`"month"`	各ビンは 1 カレンダー月です。	`datetime` のみ
`"quarter"`	各ビンは 1 カレンダー四半期です。	`datetime` のみ
`"year"`	各ビンは 1 カレンダー年です。この値には、うるう日が考慮されます。	`datetime` と `duration`
`"decade"`	各ビンは 10 年 (10 カレンダー年) です。	`datetime` のみ
`"century"`	各ビンは 1 世紀 (100 カレンダー年) です。	`datetime` のみ

datetime または duration データに対して BinMethod を指定する場合、histogram は最大 65,536 個 (2¹⁶) のビンを使用できます。指定したビンの期間にさらに多くのビンが必要となる場合、histogram は最大のビン数に対応する、より大きいビンの幅を使用します。
BinLimits、NumBins、BinEdges、または BinWidth を指定すると、BinMethod は 'manual' に設定されます。
BinMethod を BinWidth、NumBins、または BinEdges と一緒に指定した場合、histogram は最後のパラメーターのみに従います。
このオプションは、カテゴリカルデータには適用されません。

例: histogram(X,'BinMethod','integers') はビンの中心を整数とします。

カテゴリ

すべて展開する

`Categories` — ヒストグラムに含めるカテゴリ
文字ベクトルの cell 配列 | categorical 配列 | string 配列 | `pattern` スカラー

メモ

このオプションはカテゴリカルヒストグラムにのみ適用されます。

ヒストグラムに含めるカテゴリ。文字ベクトルの cell 配列、categorical 配列、string 配列、または pattern スカラーとして指定します。

入力 categorical 配列 C を指定すると、histogram は既定で C の各カテゴリのバーをプロットします。その場合にカテゴリの一意のサブセットを指定するには、Categories を使用します。
ビンのカウント数を指定する場合、Categories にはヒストグラムの関連するカテゴリ名を指定します。

例: h = histogram(C,{'Large','Small'}) は、カテゴリ 'Large' および 'Small' のカテゴリカルデータのみをプロットします。

例: histogram(C,"Y" + wildcardPattern) は、名前が文字 Y で始まるカテゴリにあるデータをプロットします。

例: histogram('Categories',{'Yes','No','Maybe'},'BinCounts',[22 18 3]) は 3 つのカテゴリと関連するビンのカウント数をもつヒストグラムをプロットします。

例: h.Categories は、histogram オブジェクト h 内にあるカテゴリをクエリします。

データ型: cell | categorical | string | pattern

`DisplayOrder` — カテゴリの表示順序
`'data'` (既定値) | `'ascend'` | `'descend'`

カテゴリの表示順序。'data'、'ascend'、または 'descend' として指定します。

'data' — 入力データ C のカテゴリの順序を使用します。
'ascend' — 増加するバーの高さとともにヒストグラムを表示します。
'descend' — 減少するバーの高さとともにヒストグラムを表示します。

このオプションは、カテゴリカルデータでのみ機能します。

`NumDisplayBins` — 表示するカテゴリ数
スカラー

表示するカテゴリ数。スカラーとして指定します。'DisplayOrder' オプションを使用して、ヒストグラムに表示されるカテゴリの順序を変更できます。

このオプションは、カテゴリカルデータでのみ機能します。

`ShowOthers` — 非表示カテゴリに属するデータの概要表示の切り替え
`'off'` (既定値) | on/off logical 値

非表示カテゴリに属するデータの概要表示の切り替え。'on' または 'off' として、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

このオプションを 'on' に設定すると、ヒストグラムに 'Others' という名前の追加のバーが表示されます。この追加のバーには、ヒストグラムに表示されるカテゴリに属さないすべての要素がカウントされます。
ヒストグラムに表示されるカテゴリ数とその順序は、'NumDisplayBins' および 'DisplayOrder' オプションを使用して変更できます。
このオプションは、カテゴリカルデータでのみ機能します。

データ

すべて展開する

`Data` — ビンに分散させるデータ
ベクトル | 行列 | 多次元配列 | categorical 配列

ビンに分散させるデータ。ベクトル、行列、多次元配列または categorical 配列として指定します。Data がベクトルでない場合、histogram はそれを 1 つの列ベクトル Data(:) として扱い、1 つのヒストグラムをプロットします。

histogram は、NaN、NaT および未定義のカテゴリカル値をすべて無視します。同様にビンのエッジとして明示的に Inf または -Inf を指定しない限り、histogram は Inf 値および -Inf 値を無視します。通常、NaN 値、NaT 値、Inf 値、-Inf 値、<undefined> 値はプロットされませんが、'probability' などのデータ要素の総数を含む正規化計算に引き続き含まれます。

当初、カテゴリカルを使用して histogram オブジェクトが作成された場合、Data にはカテゴリカル値のみを指定できます。

`Values` — ビンの値
数値ベクトル

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

ビンの値。数値ベクトルとして返されます。Normalization が 'count' (既定値) の場合、Values の k 番目の要素は Data の要素が k 番目のビンの区間に何個入るか (ビンのカウント数) を指定します。最後のビンはビンの "両端" の値を含みますが、そのほかのすべてのビンは先頭のエッジの値のみを含みます。

Normalization の値によっては、Values プロパティは代わりにビンのカウント数の正規化されたバリアントを含むことができます。

`Normalization` — 正規化のタイプ
`'count'` (既定値) | `'probability'` | `'percentage'` | `'countdensity'` | `'cumcount'` | `'pdf'` | `'cdf'`

正規化のタイプ。次の表のいずれかの値を指定します。各ビン i に対して次のようになります。

$v_{i}$ はビンの値です。
$c_{i}$ はビン内の要素数です。
$w_{i}$ はビンの幅です。
$N$ は入力データ内の要素数です。データに NaN などの欠損値が含まれる場合、または一部のデータがビンの範囲外にある場合、この値はビン化されたデータより大きくなることがあります。

値	ビンの値	メモ
`'count'` (既定)	$v_{i} = c_{i}$	観測のカウント数または頻度。ビンの値の合計は最大で `numel(X)` で、categorical データの場合は `sum(ismember(X(:),Categories))` です。合計がこれより小さくなるのは、一部の入力データがビンに含まれていない場合のみです。
`'probability'`	$v_{i} = \frac{c_{i}}{N}$	相対的確率。入力データの要素の総数に対する各ビンの要素数は、最大で 1 です。
`'percentage'`	$v_{i} = 100 * \frac{c_{i}}{N}$	相対的割合。 `'percentage'` は categorical データをサポートしません。各ビンの要素の割合は最大で 100 です。
`'countdensity'`	$v_{i} = \frac{c_{i}}{w_{i}}$	ビンの幅でスケーリングされたカウント数または頻度。 categorical データの場合、これは、`'count'` と同じです。 `'countdensity'` は、`datetime` データも `duration` データもサポートしません。ビンの面積の合計は最大で `numel(X)` です。
`'cumcount'`	$v_{i} = \sum_{j = 1}^{i} c_{j}$	累積カウント数、つまり各ビンとそれ以前のすべてのビンの観測数です。 `N(end)` は最大で `numel(X)`、categorical データの場合は `sum(ismember(X(:),Categories))` です。
`'pdf'`	$v_{i} = \frac{c_{i}}{N \cdot w_{i}}$	確率密度関数の推定値です。カテゴリカルデータの場合、これは、`'probability'` と同じです。 `'pdf'` は、`datetime` データも `duration` データもサポートしません。ビンの面積の合計は最大で `1` です。
`'cdf'`	$v_{i} = \sum_{j = 1}^{i} \frac{c_{j}}{N}$	累積分布関数の推定値です。それぞれのビンのカウント数は、そのビンとそれ以前のすべてのビンの相対的な観測数の累積と等しくなります。 `N(end)` は最大で 1 です。

例: histogram(X,'Normalization','pdf') は、確率密度関数の推定値を使用してデータをビン化します。

`BinCounts` — ビンのカウント数
ベクトル

ビンのカウント数。ベクトルとして指定します。ビンのカウント数の計算が個別に実行され、histogram でデータのビン化を行わない場合、この入力を使用してビンのカウント数を histogram に渡します。

counts の長さはビン数と等しくなければなりません。

数値ヒストグラムの場合、ビン数は length(edges)-1 です。
カテゴリカルヒストグラムの場合、ビン数はカテゴリの数と同じです。

Values プロパティとは異なり、BinCounts は正規化されません。Normalization が 'count' の場合、Values と BinCounts は等価になります。

例: histogram('BinEdges',-2:2,'BinCounts',[5 8 15 9])

例: histogram('Categories',{'Yes','No','Maybe'},'BinCounts',[22 18 3])

`BinCountsMode` — ビンのカウント数の選択モード
`'auto'` (既定値) | `'manual'`

ビンのカウント数の選択モード。'auto' または 'manual' として指定します。既定値は 'auto' で、ビンのカウント数が Data および BinEdges から自動的に計算されます。

BinCounts を指定すると、BinCountsMode は自動的に 'manual' に設定されます。同様に、Data を指定すると、BinCountsMode は自動的に 'auto' に設定されます。

色とスタイル

すべて展開する

`DisplayStyle` — ヒストグラムの表示スタイル
`'bar'` (既定値) | `'stairs'`

ヒストグラムの表示スタイル。'bar' または 'stairs' で指定します。

'bar' — A の各ウィンドウのヒストグラムの棒グラフを表示します。このメソッドは、データの周期的なトレンドを低減するのに便利です。
'stairs' — 内部を塗りつぶさずにヒストグラムの外枠を表示する階段状プロットを表示します。

例: histogram(X,'DisplayStyle','stairs') はヒストグラムの外枠をプロットします。

`Orientation` — バーの向き
`'vertical'` (既定値) | `'horizontal'`

バーの向き。'vertical' または 'horizontal' で指定します。

例: histogram(X,'Orientation','horizontal') は水平なバーをもつヒストグラムプロットを作成します。

`BarWidth` — カテゴリカルバーの相対的な幅
`0.9` (既定値) | 範囲 `[0,1]` のスカラー

カテゴリカルバーの相対的な幅。範囲 [0,1] のスカラー値として指定します。このプロパティは、ヒストグラム内にあるカテゴリカルバーの間隔を制御するために使用します。既定値の 0.9 は、バーの幅が前のバーから次のバーまでの間隔の 90 % で、その間隔の 5 % ずつがバーの両側にあることを示します。

BarWidth が 1 の場合は、バー同士が隙間なく表示されます。

このオプションは、カテゴリカルデータでのみ機能します。

例: 0.5

`FaceColor` — ヒストグラムのバーの色
`'auto'` (既定値) | `'none'` | RGB 3 成分 | 16 進数カラーコード | 色名

ヒストグラムのバーの色。次の値の 1 つとして指定します。

'none' — バーは塗りつぶされません。
'auto' — ヒストグラムのバーの色が自動的に選択されます (既定値)。

RGB 3 成分、16 進数カラーコードまたは色名 — バーは指定した色で塗りつぶされます。

RGB 3 成分および 16 進数カラーコードは、カスタム色を指定するのに役立ちます。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数カラーコードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは 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"`

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"`

DisplayStyle を 'stairs' に指定した場合、histogram は FaceColor プロパティを使用しません。

例: histogram(X,'FaceColor','g') はバーが緑色のヒストグラムプロットを作成します。

`EdgeColor` — ヒストグラムのエッジの色
`[0 0 0]` または黒 (既定値) | `'none'` | `'auto'` | RGB 3 成分 | 16 進数カラーコード | 色名

ヒストグラムのエッジの色。次の値の 1 つとして指定します。

'none' — エッジは描画されません。
'auto' — 各エッジの色が自動的に選択されます。

RGB 3 成分、16 進数カラーコードまたは色名 — 指定した色がエッジで使用されます。

RGB 3 成分および 16 進数カラーコードは、カスタム色を指定するのに役立ちます。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数カラーコードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。この値は大文字と小文字を区別しません。したがって、カラーコード "#FF8800"、"#ff8800"、"#F80"、および "#f80" は等価です。

色名	省略名	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"`

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"`

例: histogram(X,'EdgeColor','r') はバーのエッジが赤いヒストグラムプロットを作成します。

`FaceAlpha` — ヒストグラムのバーの透明度
`0.6` (既定値) | `[0,1]` の範囲のスカラー値

ヒストグラムのバーの透明度。範囲 [0,1] のスカラー値として指定します。histogram は同じ透明度をヒストグラムのすべてのバーで使用します。1 の値は完全な不透明を、0 の値は完全な透明 (非表示) を意味します。

例: histogram(X,'FaceAlpha',1) は完全に不透明なバーをもつヒストグラムプロットを作成します。

`EdgeAlpha` — ヒストグラムのバーのエッジの透明度
`1` (既定値) | 範囲 `[0,1]` のスカラー

ヒストグラムのバーのエッジの透明度。範囲 [0,1] のスカラー値として指定します。1 の値は完全な不透明を、0 の値は完全な透明 (非表示) を意味します。

例: histogram(X,'EdgeAlpha',0.5) はバーのエッジが半透明のヒストグラムプロットを作成します。

`LineStyle` — ラインスタイル
`"-"` (既定値) | `"--"` | `":"` | `"-."` | `"none"`

ラインスタイル。次の表にリストされたオプションのいずれかとして指定します。

ラインスタイル	説明	結果として得られる線
`"-"`	実線
`"--"`	破線
`":"`	点線
`"-."`	一点鎖線
`"none"`	ラインなし	ラインなし

`LineWidth` — バーの外枠の幅
`0.5` (既定値) | 正の値

バーの外枠の幅。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。

例: 1.5

`SeriesIndex` — シリーズインデックス
正の整数 | `"none"`

シリーズインデックス。正の整数または "none" として指定します。このプロパティは、Histogram オブジェクトの面の色を、他のオブジェクトの色と一致するよう再割り当てするのに役立ちます。

既定では、Histogram オブジェクトの SeriesIndex プロパティは、1 から始まる、作成順に対応する数値です。MATLAB は、この数値を使用して、プロット関数を呼び出すときに色を割り当てるインデックスを計算します。インデックスは座標軸の ColorOrder プロパティに格納されている配列の行を参照します。同じ SeriesIndex 数値をもつ座標軸内のオブジェクトは同じ色をもちます。

SeriesIndex の値が "none" の場合は、インデックス方式に参加しない中間色に対応します。

手動の色割り当てにより `SeriesIndex` の動作をオーバーライドする方法

面の色を手動で制御するには、Histogram オブジェクトの FaceColor プロパティを色名や RGB 3 成分などのカラー値に設定します。

Histogram オブジェクトの面の色を手動で設定すると、MATLAB はそのオブジェクトの色の自動選択を無効にし、SeriesIndex プロパティの値に関係なく色を保持できるようにします。

自動選択を再度有効にするには、SeriesIndex プロパティを正の整数に設定し、FaceColor プロパティを "auto" に設定します。

場合によっては、MATLAB は SeriesIndex 値を 0 に設定し、色の自動選択も無効にします。

凡例

すべて展開する

`DisplayName` — 凡例によって使用されるテキスト
`Data` の変数名または `''` (既定値) | 文字ベクトル

凡例によって使用されるテキスト。文字ベクトルとして指定します。このテキストは histogram のアイコンの隣に表示されます。

例: 'Text Description'

テキストを複数行にする場合、sprintf を使用して改行文字 \n を含む文字ベクトルを作成します。

例: sprintf('line one\nline two')

あるいは、関数 legend を使用して凡例テキストを指定することもできます。

関数 legend の入力引数としてテキストを指定した場合、凡例には指定されたテキストが使用され、DisplayName プロパティが同じ値に設定されます。
関数 legend の入力引数としてテキストを指定しない場合、凡例には DisplayName プロパティのテキストが使用されます。DisplayName の既定値は次のいずれかの値です。
- 数値入力の場合、DisplayName は文字ベクトルであり、ヒストグラムの作成に使用される入力データの変数名を表します。入力データに変数名が含まれていない場合、DisplayName は空 ('') です。
- categorical 配列の入力の場合、DisplayName は空 ('') です。

DisplayName プロパティにテキストが含まれていない場合は、凡例で文字ベクトルが生成されます。この文字ベクトルは 'dataN' の形式になります。ここで、N は、凡例エントリのリスト内の位置を基に histogram オブジェクトに割り当てられる数字です。

既存の凡例内でこの文字ベクトルを対話的に編集した場合、MATLAB は DisplayName プロパティを編集後の文字ベクトルに更新します。

`Annotation` — 凡例にオブジェクトを含める
`Annotation` オブジェクト

凡例にオブジェクトを含めるかどうか。Annotation オブジェクトとして指定します。Annotation オブジェクトの基となる IconDisplayStyle プロパティを次のいずれかの値に設定します。

"on" — 凡例にオブジェクトを含めます (既定)。
"off" — 凡例にオブジェクトを含めません。

たとえば、obj という Histogram オブジェクトを凡例から除外するには、IconDisplayStyle プロパティを "off" に設定します。

obj.Annotation.LegendInformation.IconDisplayStyle = "off";

あるいは、関数 legend を使用して、凡例内の項目を制御することもできます。最初の入力引数を、含めるグラフィックスオブジェクトのベクトルとして指定します。最初の入力引数に既存のグラフィックスオブジェクトを指定しない場合、それは凡例に表示されません。ただし、凡例が作成された後に座標軸に追加されたグラフィックスオブジェクトは凡例には表示されません。追加の項目を避けるには、すべてのプロットを作成した後に凡例を作成することを考慮してください。

対話機能

すべて展開する

`Visible` — 可視性の状態
`"on"` (既定値) | on/off logical 値

可視性の状態。"on" または "off"、もしくは数値または logical 1 (true) または 0 (false) として指定します。"on" の値は true と等価であり、"off" は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

"on" — オブジェクトを表示します。
"off" — オブジェクトを削除せずに非表示にします。非表示のオブジェクトのプロパティには引き続きアクセスできます。

`DataTipTemplate` — データヒントの内容
`DataTipTemplate` オブジェクト

データヒントの内容。DataTipTemplate オブジェクトとして指定します。基となる DataTipTemplate オブジェクトのプロパティを変更することにより、データヒントに表示される内容を制御できます。プロパティの一覧については、DataTipTemplate のプロパティを参照してください。

データヒントの変更の例については、カスタムデータヒントの作成を参照してください。

メモ

DataTipTemplate オブジェクトは findobj または findall によって返されず、copyobj によってコピーされません。

`ContextMenu` — コンテキストメニュー
空の `GraphicsPlaceholder` 配列 (既定値) | `ContextMenu` オブジェクト

コンテキストメニュー。ContextMenu オブジェクトとして指定します。このプロパティは、オブジェクトを右クリックしたときにコンテキストメニューを表示するために使用します。関数 uicontextmenu を使用して、コンテキストメニューを作成します。

メモ

PickableParts プロパティが 'none' に設定されている場合または HitTest プロパティが 'off' に設定されている場合には、このコンテキストメニューは表示されません。

`Selected` — 選択状態
`'off'` (既定値) | on/off logical 値

選択状態。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

'on' — 選択されています。プロット編集モードでオブジェクトをクリックした場合、MATLAB は Selected プロパティを 'on' に設定します。SelectionHighlight プロパティも 'on' に設定されている場合、MATLAB はオブジェクトの周囲に選択ハンドルを表示します。
'off' — 選択されていません。

`SelectionHighlight` — 選択ハンドルの表示
`'on'` (既定値) | on/off logical 値

選択時の選択ハンドルの表示。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

'on' — Selected プロパティが 'on' に設定されているときに選択ハンドルを表示します。
'off' — Selected プロパティが 'on' に設定されている場合でも選択ハンドルを表示しません。

コールバック

すべて展開する

`ButtonDownFcn` — マウスクリックコールバック
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

マウスクリックコールバック。次の値のいずれかとして指定します。

関数ハンドル
関数ハンドルと追加の引数を含む cell 配列
ベースワークスペース内で評価される有効な MATLAB コマンドまたは MATLAB 関数の文字ベクトル (非推奨)

このプロパティは、オブジェクトをクリックしたときにコードを実行するために使用します。関数ハンドルを使用してこのプロパティを指定した場合、MATLAB はコールバックを実行するときに次の 2 つの引数をコールバック関数に渡します。

クリックしたオブジェクト — コールバック関数内から、クリックしたオブジェクトのプロパティにアクセスします。
イベントデータ — 空の引数です。この引数が使用されないことを示すために、関数定義の中でこの引数をチルダ文字 (~) に置換します。

関数ハンドルを使用してコールバック関数を定義する方法についての詳細は、グラフィックスオブジェクトのコールバックの作成を参照してください。

メモ

PickableParts プロパティが 'none' に設定されている場合または HitTest プロパティが 'off' に設定されている場合には、このコールバックは実行されません。

`CreateFcn` — 作成関数
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

オブジェクト作成関数。次の値のいずれかとして指定します。

関数ハンドル。
最初の要素が関数ハンドルである cell 配列。cell 配列内のその後の要素はコールバック関数に渡される引数です。
有効な MATLAB 式を含む文字ベクトル (非推奨)。MATLAB は、この式をベースワークスペースで評価します。

コールバックを関数ハンドル、cell 配列、または文字ベクトルとして指定する方法の詳細については、グラフィックスオブジェクトのコールバックの作成を参照してください。

このプロパティは、MATLAB がオブジェクトを作成するときに実行されるコールバック関数を指定します。MATLAB は CreateFcn コールバックを実行する前に、すべてのプロパティ値を初期化します。CreateFcn プロパティを指定しない場合、MATLAB は既定の作成関数を実行します。

既存のコンポーネントに CreateFcn プロパティを設定しても効果はありません。

このプロパティを関数ハンドルまたは cell 配列として指定した場合、コールバック関数の最初の引数を使用して、作成中のオブジェクトにアクセスできます。それ以外の場合は、関数 gcbo を使用してオブジェクトにアクセスします。

`DeleteFcn` — 削除関数
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

オブジェクト削除関数。次の値のいずれかとして指定します。

関数ハンドル。
最初の要素が関数ハンドルである cell 配列。cell 配列内のその後の要素はコールバック関数に渡される引数です。
有効な MATLAB 式を含む文字ベクトル (非推奨)。MATLAB は、この式をベースワークスペースで評価します。

このプロパティは、MATLAB がオブジェクトを削除するときに実行されるコールバック関数を指定します。MATLAB は、オブジェクトのプロパティを破棄する前に DeleteFcn コールバックを実行します。DeleteFcn プロパティを指定しない場合、MATLAB は既定の削除関数を実行します。

このプロパティを関数ハンドルまたは cell 配列として指定した場合、コールバック関数の最初の引数を使用して、削除されるオブジェクトにアクセスできます。それ以外の場合は、関数 gcbo を使用してオブジェクトにアクセスします。

コールバック実行制御

すべて展開する

`Interruptible` — コールバックの割り込み
`'on'` (既定値) | on/off logical 値

コールバックの割り込み。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

このプロパティは実行中のコールバックが割り込み可能かどうかを決定します。次の 2 つのコールバックの状態について考慮する必要があります。

"実行中" コールバックは、現在実行しているコールバックです。
"割り込み" コールバックは、実行中のコールバックに割り込もうとするコールバックです。

MATLAB は、コールバックキューを処理するコマンドを実行するたびにコールバックの割り込み動作を判別します。これらのコマンドには、drawnow、figure、uifigure、getframe、waitfor、pause があります。

実行中コールバックにこれらのコマンドが含まれていない場合、割り込みは発生しません。MATLAB は、実行中コールバックの実行を先に終了させ、その後に割り込みコールバックを実行します。

実行中コールバックにこれらのいずれかのコマンドが含まれている場合、実行中コールバックを所有するオブジェクトの Interruptible プロパティに応じて割り込みが発生するかどうかが決まります。

Interruptible の値が 'off' の場合、割り込みは発生しません。代わりに、割り込みコールバックを所有するオブジェクトの BusyAction プロパティに応じて、割り込みコールバックが破棄されるかコールバックキューに追加されるかが決まります。
Interruptible の値が 'on' の場合、割り込みが発生します。MATLAB は、コールバックキューの次回処理時に、実行中コールバックの実行を停止し、割り込みコールバックを実行します。割り込みコールバックが完了した後、MATLAB は実行中だったコールバックの実行を再開します。

メモ

コールバックの割り込みと実行は、以下の状況では動作が異なります。

割り込みコールバックが DeleteFcn、CloseRequestFcn または SizeChangedFcn コールバックの場合、Interruptible プロパティの値にかかわらず割り込みが発生します。
実行中のコールバックが関数 waitfor を現在実行している場合、Interruptible プロパティの値にかかわらず割り込みが発生します。
割り込みコールバックが Timer オブジェクトで所有されている場合、Interruptible プロパティの値にかかわらずスケジュールに従ってコールバックが実行されます。

メモ

MATLAB は、割り込みが発生したときにプロパティの状態や表示を保存しません。たとえば、gca コマンドや gcf コマンドから返されたオブジェクトは、別のコールバックを実行するときに変更されている可能性があります。

`BusyAction` — コールバックキューイング
`'queue'` (既定値) | `'cancel'`

コールバックキューイング。'queue' または 'cancel' として指定します。BusyAction プロパティは MATLAB による割り込みコールバックの実行の処理方法を決定します。次の 2 つのコールバックの状態について考慮する必要があります。

"実行中" コールバックは、現在実行しているコールバックです。
"割り込み" コールバックは、実行中のコールバックに割り込もうとするコールバックです。

BusyAction プロパティによってコールバックキューイングの動作が決まるのは、次の両方の条件を満たす場合のみです。

実行中コールバックに drawnow、figure、uifigure、getframe、waitfor、pause などのコールバックキューを処理するコマンドが含まれている。
実行中コールバックを所有するオブジェクトの Interruptible プロパティの値が 'off' である。

これらの条件に当てはまる場合、割り込みコールバックを所有するオブジェクトの BusyAction プロパティに応じて MATLAB による割り込みコールバックの処理方法が決まります。BusyAction プロパティは次の値を取ることができます。

'queue' — 割り込みコールバックをキューに入れ、実行中のコールバックが終了した後に処理されるようにします。
'cancel' — 割り込みコールバックを実行しません。

`PickableParts` — マウスクリックキャプチャ機能
`'visible'` (既定値) | `'none'`

マウスクリックキャプチャ機能。次の値の 1 つとして指定します。

'visible' — 表示されている場合にのみマウスクリックをキャプチャします。Visible プロパティは、'on' に設定しなければなりません。Histogram オブジェクトがクリックに応答するか、先祖がクリックに応答するかは、HitTest プロパティが決定します。
'none' — マウスクリックをキャプチャしません。Histogram オブジェクトをクリックすると、Figure ウィンドウの現在のビュー内でその後ろにあるオブジェクトにクリックが渡されます。Histogram オブジェクトの HitTest プロパティの効果はありません。

`HitTest` — キャプチャしたマウスクリックへの応答
`'on'` (既定値) | on/off logical 値

キャプチャしたマウスクリックへの応答。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

'on' — Histogram オブジェクトの ButtonDownFcn コールバックをトリガーします。ContextMenu プロパティが定義されている場合は、コンテキストメニューを呼び出します。
'off' — Histogram オブジェクトの先祖のうち、次のいずれかの条件を満たす最も近い先祖のコールバックをトリガーします。
- HitTest プロパティが 'on' に設定されている
- PickableParts プロパティが、先祖によるマウスクリックのキャプチャを有効にする値に設定されている

メモ

PickableParts プロパティは、Histogram オブジェクトがマウスクリックをキャプチャできるかどうかを決定します。キャプチャできない場合、HitTest プロパティは無効です。

`BeingDeleted` — 削除状態
on/off logical 値

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

削除状態。matlab.lang.OnOffSwitchState 型の on/off logical 値として返されます。

MATLAB は、DeleteFcn コールバックが実行を開始すると、BeingDeleted プロパティを 'on' に設定します。コンポーネントオブジェクトが存在しなくなるまで BeingDeleted プロパティは 'on' に設定されたままです。

クエリや変更の前にオブジェクトが削除されようとしていないか確認するために BeingDeleted プロパティの値をチェックします。

親/子

すべて展開する

`Parent` — 親
`Axes` オブジェクト | `PolarAxes` オブジェクト | `Group` オブジェクト | `Transform` オブジェクト

親。Axes、PolarAxes、Group または Transform オブジェクトとして指定します。

`Children` — 子
空の `GraphicsPlaceholder` 配列 | `DataTip` オブジェクト配列

子。空の GraphicsPlaceholder 配列、または DataTip オブジェクト配列として返されます。このプロパティを使用して、チャートにプロットされるデータヒントのリストを表示します。

Children プロパティを使用して子の追加や削除を行うことはできません。このリストに子を追加するには、DataTip オブジェクトの Parent プロパティをチャートオブジェクトに設定します。

`HandleVisibility` — オブジェクトハンドルの可視性
`"on"` (既定値) | `"off"` | `"callback"`

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

"on" — オブジェクトハンドルは常に表示されます。
"off" — オブジェクトハンドルは常に非表示です。このオプションは、他の関数による意図しない変更を防止するために役立ちます。HandleVisibility を "off" に設定すると、その関数の実行中にハンドルが一時的に非表示になります。
"callback" — オブジェクトハンドルはコールバック内から、あるいはコールバックにより呼び出される関数から参照できます。しかし、コマンドラインから呼び出される関数からは参照できません。このオプションを使用すると、コマンドラインからのオブジェクトへのアクセスがブロックされますが、コールバック関数からのアクセスは許可されます。

オブジェクトが親の Children プロパティ内にリストされない場合、オブジェクト階層の検索またはハンドルプロパティのクエリによってオブジェクトハンドルを取得する関数は、そのオブジェクトハンドルを返しません。こうした関数の例としては、関数 get、findobj、gca、gcf、gco、newplot、cla、clf、および close などが挙げられます。

非表示のオブジェクトハンドルは有効なままです。ルートの ShowHiddenHandles プロパティを "on" に設定すると、HandleVisibility プロパティの設定にかかわらず、すべてのオブジェクトハンドルがリストされます。

識別子

すべて展開する

`Type` — グラフィックスオブジェクトのタイプ
`'histogram'` | `'categoricalhistogram'`

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

グラフィックスオブジェクトのタイプ。'histogram' または 'categoricalhistogram' として返されます。プロット階層内にある特定のタイプのすべてのオブジェクトを検出するためにこのプロパティを使用できます。たとえば findobj を使用してタイプを検索します。

`Tag` — オブジェクト識別子
`''` (既定値) | 文字ベクトル | string スカラー

オブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。オブジェクトの識別子として機能する一意の Tag 値を指定できます。コードの他の部分からオブジェクトにアクセスする必要がある場合、関数 findobj を使用して Tag 値に基づいてオブジェクトを検索できます。

`UserData` — ユーザーデータ
`[]` (既定値) | 配列

ユーザーデータ。任意の MATLAB 配列として指定します。たとえば、スカラー、ベクトル、行列、cell 配列、文字配列、table、または構造体を指定できます。このプロパティを使用して、任意のデータをオブジェクトに保存します。

App Designer を使用している場合は、UserData プロパティを使用する代わりに、アプリでパブリックプロパティまたはプライベートプロパティを作成してデータを共有します。詳細については、App Designer アプリ内でのデータの共有を参照してください。

バージョン履歴

R2014b で導入

すべて展開する

R2023b: パーセンテージを使用した正規化

Normalization プロパティを 'percentage' に設定することにより、縦軸にパーセンテージをもつヒストグラムを作成できます。

R2023b: `SeriesIndex="none"` を使用した色の自動選択のオプトアウト

SeriesIndex プロパティを "none" に設定して、Histogram オブジェクトの色の自動選択をオプトアウトします。"none" を指定すると、Histogram オブジェクトは中間色をもちます。

色の自動選択を再度有効にするには、SeriesIndex プロパティを正の整数に設定します。

R2020a: `SeriesIndex` プロパティを使用した色の自動選択の制御

SeriesIndex プロパティを設定することにより、Histogram オブジェクトの色がどのように変化するかを制御します。このプロパティは、座標軸内の異なるオブジェクトの色を一致させる場合に便利です。

R2020a: `UIContextMenu` プロパティは非推奨

R2020a 以降、コンテキストメニューをグラフィックスオブジェクトまたは UI コンポーネントに割り当てる UIContextMenu プロパティの使用は推奨されなくなりました。代わりに、ContextMenu プロパティを使用してください。プロパティ値は同じです。

現在のところ、UIContextMenu プロパティのサポートを削除する予定はありません。ただし、UIContextMenu プロパティは、グラフィカルオブジェクトまたは UI コンポーネントで関数 get を呼び出して返されるリストに表示されなくなります。

参考

histogram

トピック

プロパティ値へのアクセス

Histogram のプロパティ

ビン

NumBins — ビンの数 正の整数

BinWidth — ビンの幅 正のスカラー

BinEdges — ビンのエッジ 数値ベクトル

BinLimits — ビンの範囲 2 要素ベクトル

BinLimitsMode — ビンの範囲の選択モード 'auto' (既定値) | 'manual'

BinMethod — ビン化アルゴリズム 'auto' (既定値) | 'scott' | 'fd' | 'integers' | 'sturges' | 'sqrt' | ...

カテゴリ

Categories — ヒストグラムに含めるカテゴリ 文字ベクトルの cell 配列 | categorical 配列 | string 配列 | pattern スカラー

DisplayOrder — カテゴリの表示順序 'data' (既定値) | 'ascend' | 'descend'

NumDisplayBins — 表示するカテゴリ数 スカラー

ShowOthers — 非表示カテゴリに属するデータの概要表示の切り替え 'off' (既定値) | on/off logical 値

データ

Data — ビンに分散させるデータ ベクトル | 行列 | 多次元配列 | categorical 配列

Values — ビンの値 数値ベクトル

Normalization — 正規化のタイプ 'count' (既定値) | 'probability' | 'percentage' | 'countdensity' | 'cumcount' | 'pdf' | 'cdf'

BinCounts — ビンのカウント数 ベクトル

BinCountsMode — ビンのカウント数の選択モード 'auto' (既定値) | 'manual'

色とスタイル

DisplayStyle — ヒストグラムの表示スタイル 'bar' (既定値) | 'stairs'

Orientation — バーの向き 'vertical' (既定値) | 'horizontal'

BarWidth — カテゴリカル バーの相対的な幅 0.9 (既定値) | 範囲 [0,1] のスカラー

FaceColor — ヒストグラムのバーの色 'auto' (既定値) | 'none' | RGB 3 成分 | 16 進数カラー コード | 色名

EdgeColor — ヒストグラムのエッジの色 [0 0 0] または黒 (既定値) | 'none' | 'auto' | RGB 3 成分 | 16 進数カラー コード | 色名

FaceAlpha — ヒストグラムのバーの透明度 0.6 (既定値) | [0,1] の範囲のスカラー値

EdgeAlpha — ヒストグラムのバーのエッジの透明度 1 (既定値) | 範囲 [0,1] のスカラー

LineStyle — ライン スタイル "-" (既定値) | "--" | ":" | "-." | "none"

LineWidth — バーの外枠の幅 0.5 (既定値) | 正の値

SeriesIndex — シリーズ インデックス 正の整数 | "none"

手動の色割り当てにより SeriesIndex の動作をオーバーライドする方法

凡例

DisplayName — 凡例によって使用されるテキスト Data の変数名または '' (既定値) | 文字ベクトル

Annotation — 凡例にオブジェクトを含める Annotation オブジェクト

対話機能

Visible — 可視性の状態 "on" (既定値) | on/off logical 値

DataTipTemplate — データ ヒントの内容 DataTipTemplate オブジェクト

ContextMenu — コンテキスト メニュー 空の GraphicsPlaceholder 配列 (既定値) | ContextMenu オブジェクト

Selected — 選択状態 'off' (既定値) | on/off logical 値

SelectionHighlight — 選択ハンドルの表示 'on' (既定値) | on/off logical 値

コールバック

ButtonDownFcn — マウスクリック コールバック '' (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

CreateFcn — 作成関数 '' (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

DeleteFcn — 削除関数 '' (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

コールバック実行制御

Interruptible — コールバックの割り込み 'on' (既定値) | on/off logical 値

BusyAction — コールバック キューイング 'queue' (既定値) | 'cancel'

PickableParts — マウス クリック キャプチャ機能 'visible' (既定値) | 'none'

HitTest — キャプチャしたマウス クリックへの応答 'on' (既定値) | on/off logical 値

BeingDeleted — 削除状態 on/off logical 値

親/子

Parent — 親 Axes オブジェクト | PolarAxes オブジェクト | Group オブジェクト | Transform オブジェクト

Children — 子 空の GraphicsPlaceholder 配列 | DataTip オブジェクト配列

HandleVisibility — オブジェクト ハンドルの可視性 "on" (既定値) | "off" | "callback"

識別子

Type — グラフィックス オブジェクトのタイプ 'histogram' | 'categoricalhistogram'

Tag — オブジェクト識別子 '' (既定値) | 文字ベクトル | string スカラー

UserData — ユーザー データ [] (既定値) | 配列

バージョン履歴

R2023b: パーセンテージを使用した正規化

R2023b: SeriesIndex="none" を使用した色の自動選択のオプトアウト

R2020a: SeriesIndex プロパティを使用した色の自動選択の制御

R2020a: UIContextMenu プロパティは非推奨

参考

トピック

`NumBins` — ビンの数
正の整数

`BinWidth` — ビンの幅
正のスカラー

`BinEdges` — ビンのエッジ
数値ベクトル

`BinLimits` — ビンの範囲
2 要素ベクトル

`BinLimitsMode` — ビンの範囲の選択モード
`'auto'` (既定値) | `'manual'`

`BinMethod` — ビン化アルゴリズム
`'auto'` (既定値) | `'scott'` | `'fd'` | `'integers'` | `'sturges'` | `'sqrt'` | ...

`Categories` — ヒストグラムに含めるカテゴリ
文字ベクトルの cell 配列 | categorical 配列 | string 配列 | `pattern` スカラー

`DisplayOrder` — カテゴリの表示順序
`'data'` (既定値) | `'ascend'` | `'descend'`

`NumDisplayBins` — 表示するカテゴリ数
スカラー

`ShowOthers` — 非表示カテゴリに属するデータの概要表示の切り替え
`'off'` (既定値) | on/off logical 値

`Data` — ビンに分散させるデータ
ベクトル | 行列 | 多次元配列 | categorical 配列

`Values` — ビンの値
数値ベクトル

`Normalization` — 正規化のタイプ
`'count'` (既定値) | `'probability'` | `'percentage'` | `'countdensity'` | `'cumcount'` | `'pdf'` | `'cdf'`

`BinCounts` — ビンのカウント数
ベクトル

`BinCountsMode` — ビンのカウント数の選択モード
`'auto'` (既定値) | `'manual'`

`DisplayStyle` — ヒストグラムの表示スタイル
`'bar'` (既定値) | `'stairs'`

`Orientation` — バーの向き
`'vertical'` (既定値) | `'horizontal'`

`BarWidth` — カテゴリカルバーの相対的な幅
`0.9` (既定値) | 範囲 `[0,1]` のスカラー

`FaceColor` — ヒストグラムのバーの色
`'auto'` (既定値) | `'none'` | RGB 3 成分 | 16 進数カラーコード | 色名

`EdgeColor` — ヒストグラムのエッジの色
`[0 0 0]` または黒 (既定値) | `'none'` | `'auto'` | RGB 3 成分 | 16 進数カラーコード | 色名

`FaceAlpha` — ヒストグラムのバーの透明度
`0.6` (既定値) | `[0,1]` の範囲のスカラー値

`EdgeAlpha` — ヒストグラムのバーのエッジの透明度
`1` (既定値) | 範囲 `[0,1]` のスカラー

`LineStyle` — ラインスタイル
`"-"` (既定値) | `"--"` | `":"` | `"-."` | `"none"`

`LineWidth` — バーの外枠の幅
`0.5` (既定値) | 正の値

`SeriesIndex` — シリーズインデックス
正の整数 | `"none"`

手動の色割り当てにより `SeriesIndex` の動作をオーバーライドする方法

`DisplayName` — 凡例によって使用されるテキスト
`Data` の変数名または `''` (既定値) | 文字ベクトル

`Annotation` — 凡例にオブジェクトを含める
`Annotation` オブジェクト

`Visible` — 可視性の状態
`"on"` (既定値) | on/off logical 値

`DataTipTemplate` — データヒントの内容
`DataTipTemplate` オブジェクト

`ContextMenu` — コンテキストメニュー
空の `GraphicsPlaceholder` 配列 (既定値) | `ContextMenu` オブジェクト

`Selected` — 選択状態
`'off'` (既定値) | on/off logical 値

`SelectionHighlight` — 選択ハンドルの表示
`'on'` (既定値) | on/off logical 値

`ButtonDownFcn` — マウスクリックコールバック
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

`CreateFcn` — 作成関数
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

`DeleteFcn` — 削除関数
`''` (既定値) | 関数ハンドル | cell 配列 | 文字ベクトル

`Interruptible` — コールバックの割り込み
`'on'` (既定値) | on/off logical 値

`BusyAction` — コールバックキューイング
`'queue'` (既定値) | `'cancel'`

`PickableParts` — マウスクリックキャプチャ機能
`'visible'` (既定値) | `'none'`

`HitTest` — キャプチャしたマウスクリックへの応答
`'on'` (既定値) | on/off logical 値

`BeingDeleted` — 削除状態
on/off logical 値

`Parent` — 親
`Axes` オブジェクト | `PolarAxes` オブジェクト | `Group` オブジェクト | `Transform` オブジェクト

`Children` — 子
空の `GraphicsPlaceholder` 配列 | `DataTip` オブジェクト配列

`HandleVisibility` — オブジェクトハンドルの可視性
`"on"` (既定値) | `"off"` | `"callback"`

`Type` — グラフィックスオブジェクトのタイプ
`'histogram'` | `'categoricalhistogram'`

`Tag` — オブジェクト識別子
`''` (既定値) | 文字ベクトル | string スカラー

`UserData` — ユーザーデータ
`[]` (既定値) | 配列

R2023b: `SeriesIndex="none"` を使用した色の自動選択のオプトアウト

R2020a: `SeriesIndex` プロパティを使用した色の自動選択の制御

R2020a: `UIContextMenu` プロパティは非推奨