histogram2

График двумерной гистограммы

Описание

Двумерные гистограммы являются типом столбиковой диаграммы для числовых данных, которые группируют данные в 2D интервалы. После того, как вы создаете Histogram2 объект, можно изменить аспекты гистограммы путем изменения ее значений свойств. Это особенно полезно для того, чтобы быстро изменить свойства интервалов или изменить отображение.

Создание

Синтаксис

histogram2(X,Y)

histogram2(X,Y,nbins)

histogram2(X,Y,Xedges,Yedges)

histogram2('XBinEdges',Xedges,'YBinEdges',Yedges,'BinCounts',counts)

histogram2(___,Name,Value)

histogram2(ax,___)

h = histogram2(___)

Описание

пример

histogram2(X,Y) создает график двумерной гистограммы X и Y. histogram2 функционируйте использует автоматический алгоритм раскладывания, который возвращает интервалы с универсальной областью, выбранной, чтобы покрыть область значений элементов в X и Y и покажите базовую форму распределения. histogram2 отображает интервалы как 3-D прямоугольные панели, таким образом, что высота каждой панели указывает на число элементов в интервале.

пример

histogram2(X,Y,nbins) задает количество интервалов, чтобы использовать в каждой размерности гистограммы.

пример

histogram2(X,Y,Xedges,Yedges) задает ребра интервалов в каждой размерности с помощью векторов Xedges и Yedges.

histogram2('XBinEdges',Xedges,'YBinEdges',Yedges,'BinCounts',counts) вручную задает количество интервалов. histogram2 строит заданное количество интервалов и не делает никакого раскладывания данных.

пример

histogram2(___,Name,Value) задает дополнительные опции с одним или несколькими Name,Value парные аргументы с помощью любого из предыдущих синтаксисов. Например, можно задать 'BinWidth' и двухэлементный вектор, чтобы настроить ширину интервалов в каждой размерности или 'Normalization' с допустимой опцией ('count', 'probability', 'countdensity', 'pdf', 'cumcount', или 'cdf') использовать другой тип нормализации. Для списка свойств смотрите Histogram2 Properties.

histogram2(ax,___) графики в оси заданы ax вместо в текущую систему координат (gca). Опция ax может предшествовать любой из комбинаций входных аргументов в предыдущих синтаксисах.

пример

h = histogram2(___) возвращает Histogram2 объект. Используйте это, чтобы смотреть и настроить свойства двумерной гистограммы. Для списка свойств смотрите Histogram2 Properties.

Входные параметры

развернуть все

`X,Y` — Данные, чтобы распределить среди интервалов (в качестве отдельных аргументов)
векторы | матрицы | многомерные массивы

Данные, чтобы распределить среди интервалов в виде отдельных аргументов векторов, матриц или многомерных массивов. X и Y должен быть одного размера. Если X и Y не векторы, затем histogram2 обрабатывает их как векторы отдельного столбца, X(:) и Y(:), и строит одну гистограмму.

Соответствующие элементы в X и Y задайте x и координаты y точек 2D данных, [X(k),Y(k)]. Типы данных X и Y может отличаться, но histogram2 конкатенирует эти входные параметры в один N- 2 матрица доминирующего типа данных.

histogram2 игнорирует весь NaN значения. Точно так же histogram2 игнорирует Inf и -Inf значения, если границы интервала явным образом не задают Inf или -Inf как граница интервала. Несмотря на то, что NaNInf, и -Inf значения обычно не строятся, они все еще включены в вычисления нормализации, которые включают общее количество элементов данных, таких как 'probability'.

Примечание

Если X или Y содержите целые числа типа int64 или uint64 это больше, чем flintmax, затем рекомендуется, чтобы вы явным образом задали ребра интервала гистограммы.histogram2 автоматически интервалы входные данные с помощью двойной точности, которая испытывает недостаток в целочисленной точности чисел, больше, чем flintmax.

`nbins` — Количество интервалов в каждой размерности
скаляр | вектор

Количество интервалов в каждой размерности в виде положительного скалярного целого числа или двухэлементного вектора из положительных целых чисел. Если вы не задаете nbinsто histogram2 автоматически вычисляет сколько интервалов, чтобы использовать на основе значений в X и Y.

Если nbins скаляр, затем histogram2 использование, что много интервалов в каждой размерности.
Если nbins вектор, затем nbins(1) задает количество интервалов в x - размерность и nbins(2) задает количество интервалов в y - размерность.

Пример: histogram2(X,Y,20) использование 20 интервалов в каждой размерности.

Пример: histogram2(X,Y,[10 20]) использование 10 интервалов в x- размерность и 20 интервалов в y- размерность.

`Xedges` — Границы интервала в x - размерность
вектор

Границы интервала в x - размерность в виде вектора. Xedges(1) первое ребро первого интервала в x - размерность и Xedges(end) внешний край последнего интервала.

Значение [X(k),Y(k)] находится в (i,j)интервал th, если Xedges(i) ≤ X(k) <Xedges(i+1) и Yedges(j) ≤ Y(k) <Yedges(j+1). Последние интервалы в каждой размерности также включают последнее (внешнее) ребро. Например, [X(k),Y(k)] попадает в iинтервал th в последней строке, если Xedges(end-1) ≤ X(k) ≤ Xedges(end) и Yedges(i) ≤ Y(k) <Yedges(i+1).

`Yedges` — Границы интервала в y - размерность
вектор

Границы интервала в y - размерность в виде вектора. Yedges(1) первое ребро первого интервала в y - размерность и Yedges(end) внешний край последнего интервала.

`counts` bincounts
матрица

Количество интервалов в виде матрицы. Используйте этот вход, чтобы передать количество интервалов histogram2 когда вычисление количества интервалов выполняется отдельно, и вы не хотите histogram2 сделать любое раскладывание данных.

counts должна быть матрица размера [length(XBinEdges)-1 length(YBinEdges)-1] так, чтобы это указало, что интервал значит каждый интервал.

Пример: histogram2('XBinEdges',-1:1,'YBinEdges',-2:2,'BinCounts',[1 2 3 4; 5 6 7 8])

`ax` Объект осей
объект

Объект осей. Если вы не задаете оси, то histogram2 функционируйте использует текущую систему координат (gca).

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: histogram2(X,Y,'BinWidth',[5 10])

Перечисленные здесь свойства являются только подмножеством. Для полного списка смотрите Histogram2 Properties.

`'BinMethod'` — Алгоритм раскладывания
`'auto'` (значение по умолчанию) | `'scott'` | `'fd'` | `'integers'`

Алгоритм раскладывания в виде одного из значений в этой таблице.

Значение	Описание
`'auto'`	`'auto'` по умолчанию алгоритм выбирает, ширина интервала, чтобы покрыть данные располагаются и показывают форму базового распределения.
`'scott'`	Правило Скотта оптимально, если данные близко к тому, чтобы быть совместно нормально распределенным. Это правило подходит для большинства других распределений, также. Это использует размер интервала `[3.5std(X(:))numel(X)^(-1/4), 3.5std(Y(:))numel(Y)^(-1/4)]`.
`'fd'`	Правило Фридмена—Диакониса менее чувствительно к выбросам в данных и может более подойти для данных с распределениями с тяжелым хвостом. Это использует размер интервала `[2IQR(X(:))numel(X)^(-1/4), 2IQR(Y(:))numel(Y)^(-1/4)]`, где `IQR` межквартильный размах.
`'integers'`	Целочисленное правило полезно с целочисленными данными, когда это создает интервалы, сосредоточенные на парах целых чисел. Это использует ширину интервала 1 для каждой размерности и помещает границы интервала на полпути между целыми числами. Чтобы постараться не случайно создавать слишком много интервалов, можно использовать это правило, чтобы создать предел 1 024 интервалов ⁽²¹⁰⁾. Если область значений данных для любой размерности больше 1024, то целочисленное правило использует более широкие интервалы вместо этого.

histogram2 не всегда выбирает количество интервалов с помощью этих точных формул. Иногда количество интервалов настроено немного так, чтобы границы интервала упали на "хорошие" числа.

Примечание

Если вы устанавливаете NumBinsXBinEdges YBinEdges BinWidth , или BinLimits свойство, затем BinMethod свойство установлено в 'manual'.

Пример: histogram2(X,Y,'BinMethod','integers') создает двумерную гистограмму с интервалами, сосредоточенными на парах целых чисел.

`'BinWidth'` — Ширина интервалов в каждой размерности
вектор

Ширина интервалов в каждой размерности в виде двухэлементного вектора из положительных целых чисел, [xWidth yWidth].

Если вы задаете BinWidthто histogram2 может использовать максимум 1 024 интервалов ⁽²¹⁰⁾ по каждому измерению. Если вместо этого заданная ширина интервала требует большего количества интервалов, то histogram2 использует большую ширину интервала, соответствующую максимальному количеству интервалов.

Пример: histogram2(X,Y,'BinWidth',[5 10]) интервалы использования с размером 5 в x- размерность и размер 10 в y- размерность.

`'DisplayStyle'` — Стиль отображения гистограммы
`'bar3'` (значение по умолчанию) | `'tile'`

Стиль отображения гистограммы в виде любого 'bar3' или 'tile'. Задайте 'tile' отобразить гистограмму как прямоугольный массив мозаик с цветами, указывающими на значения интервала.

Значение по умолчанию 'bar3' отображает гистограмму с помощью 3-D панелей.

Пример: histogram2(X,Y,'DisplayStyle','tile') строит гистограмму как прямоугольный массив мозаик.

`'EdgeAlpha'` — Прозрачность ребер панели гистограммы
1 (значение по умолчанию) | скалярное значение между `0` и `1` включительно

Прозрачность ребер панели гистограммы в виде скалярного значения между 0 и 1 включительно. Значение 1 означает полностью непрозрачный и 0 означает абсолютно прозрачная (невидимая операция).

Пример: histogram2(X,Y,'EdgeAlpha',0.5) создает график двумерной гистограммы с полупрозрачными ребрами панели.

`'EdgeColor'` — Цвет обводки гистограммы
[0.15 0.15 0.15] (значение по умолчанию) | `'none'` | `'auto'` | Триплет RGB | шестнадцатеричный цветовой код | название цвета

Цвет обводки гистограммы в виде одного из этих значений:

'none' — Ребра не чертятся.
'auto' — Цвет каждого ребра выбран автоматически.

Триплет RGB, шестнадцатеричный цветовой код или название цвета — Ребра используют заданный цвет.

Триплеты RGB и шестнадцатеричные цветовые коды полезны для определения пользовательских цветов.

Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].
Шестнадцатеричный цветовой код является вектором символов или строковым скаляром, который запускается с символа хеша (#) сопровождаемый тремя или шестью шестнадцатеричными цифрами, которые могут лежать в диапазоне от 0 к F. Значения не являются чувствительными к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Кроме того, вы можете задать имена некоторых простых цветов. Эта таблица приводит опции именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цвета	Краткое название	Триплет RGB	Шестнадцатеричный цветовой код
`'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'`

Вот являются триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию использованием MATLAB^® во многих типах графиков.

Триплет RGB	Шестнадцатеричный цветовой код	Внешний вид
[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'`

Пример: histogram2(X,Y,'EdgeColor','r') создает 3-D график гистограммы с красными ребрами панели.

`'FaceAlpha'` — Прозрачность панелей гистограммы
1 (значение по умолчанию) | скалярное значение между `0` и `1` включительно

Прозрачность панелей гистограммы в виде скалярного значения между 0 и 1 включительно. histogram2 использует ту же прозрачность для всех панелей гистограммы. Значение 1 означает полностью непрозрачный и 0 означает абсолютно прозрачная (невидимая операция).

Пример: histogram2(X,Y,'FaceAlpha',0.5) создает график двумерной гистограммы с полупрозрачными панелями.

`'FaceColor'` — Цвет панели гистограммы
`'auto'` (значение по умолчанию) | `'flat'` | `'none'` | Триплет RGB | шестнадцатеричный цветовой код | название цвета

Панель гистограммы окрашивает в виде одного из этих значений:

'none' — Панели не заполнены.
'flat' — Цвета панели меняются в зависимости от высоты. Панели с различной высотой имеют различные цвета. Цвета выбраны из палитры осей или фигуры.
'auto' — Цвет панели выбран автоматически (по умолчанию).

Триплет RGB, шестнадцатеричный цветовой код или название цвета — Панели заполнены заданным цветом.

Триплеты RGB и шестнадцатеричные цветовые коды полезны для определения пользовательских цветов.

Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].
Шестнадцатеричный цветовой код является вектором символов или строковым скаляром, который запускается с символа хеша (#) сопровождаемый тремя или шестью шестнадцатеричными цифрами, которые могут лежать в диапазоне от 0 к F. Значения не являются чувствительными к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Название цвета	Краткое название	Триплет RGB	Шестнадцатеричный цветовой код
`'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'`

Вот являются триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию использованием MATLAB во многих типах графиков.

Триплет RGB	Шестнадцатеричный цветовой код	Внешний вид
[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'то histogram2 не использует FaceColor свойство.

Пример: histogram2(X,Y,'FaceColor','g') создает 3-D график гистограммы с зелеными панелями.

`'FaceLighting'` — Эффект освещения на панели гистограммы
`'lit'` (значение по умолчанию) | `'flat'` | `'none'`

Эффект освещения на панели гистограммы в виде одного из значений в этой таблице.

Значение Описание

Значение	Описание
`'lit'`	Панели гистограммы отображают псевдоэффект освещения, где стороны панелей используют более темные цвета относительно верхних частей. Панели незатронуты другими источниками света в осях. Это - значение по умолчанию когда `DisplayStyle` `'bar3'`.
`'flat'`	Панели гистограммы не освещены автоматически. В присутствии других световых объектов эффект освещения универсален через поверхности панели.
`'none'`	Панели гистограммы не освещены автоматически, и световые сигналы не влияют на панели гистограммы. `FaceLighting` может только быть `'none'` когда `DisplayStyle` `'tile'`.

'lit'

Панели гистограммы отображают псевдоэффект освещения, где стороны панелей используют более темные цвета относительно верхних частей. Панели незатронуты другими источниками света в осях.

Это - значение по умолчанию когда DisplayStyle 'bar3'.

'flat'

Панели гистограммы не освещены автоматически. В присутствии других световых объектов эффект освещения универсален через поверхности панели.

'none'

Панели гистограммы не освещены автоматически, и световые сигналы не влияют на панели гистограммы.

FaceLighting может только быть 'none' когда DisplayStyle 'tile'.

Пример: histogram2(X,Y,'FaceLighting','none') выключает подсветку панелей гистограммы.

`'LineStyle'` — Стиль линии
`'-'` (значение по умолчанию) | `'--'` | `':'` | `'-.'` | `'none'`

Стиль линии в виде одной из опций перечислен в этой таблице.

Стиль линии	Описание	Получившаяся линия
`'-'`	Сплошная линия
`'--'`	Пунктирная линия
`':'`	Пунктирная линия
`'-.'`	Штрих-пунктирная линия
`'none'`	Никакая линия	Никакая линия

`'LineWidth'` — Ширина основ панели
0.5 (значение по умолчанию) | положительное значение

Ширина панели обрисовывает в общих чертах в виде положительного значения в модулях точки. Один пункт равен 1/72 дюйма.

Пример: 1.5

`'Normalization'` — Тип нормализации
`'count'` (значение по умолчанию) | `'probability'` | `'countdensity'` | `'pdf'` | `'cumcount'` | `'cdf'`

Тип нормализации в виде одного из значений в этой таблице. Для каждого интервала i:

$v_{i}$ значение интервала.
$c_{i}$ число элементов в интервале.
$A_{i} = w_{x i} \cdot w_{y i}$ область каждого интервала, вычисленное использование x и ширин интервала y.
$N$ число элементов во входных данных. Это значение может быть больше сгруппированных данных, если данные содержат NaN значения, или если некоторые данные находятся вне пределов интервала.

Значение	Значения интервала	Примечания
`'count'` (значение по умолчанию)	$v_{i} = c_{i}$	Количество или частота наблюдений. Сумма значений интервала меньше чем или равна `numel(X)` и `numel(y)`. Сумма меньше `numel(X)` и `numel(y)` только, когда некоторые входные данные не включены в интервалы.
`'countdensity'`	$v_{i} = \frac{c_{i}}{A_{i}}$	Количество или частота, масштабируемая областью интервала. Объем (высота * область) каждой панели является количеством наблюдений в интервале. Сумма объемов панели меньше чем или равна `numel(X)` и `numel(y)`.
`'cumcount'`	$v_{i} = \sum_{j = 1}^{i} c_{j}$	Совокупное количество. Каждое значение интервала является совокупным числом наблюдений в каждом интервале и всех предыдущих интервалах и в x и в размерностях y. Высота последней панели меньше чем или равна `numel(X)` и `numel(Y)`.
`'probability'`	$v_{i} = \frac{c_{i}}{N}$	Относительная вероятность. Сумма высот панели меньше чем или равна `1`.
`'pdf'`	$v_{i} = \frac{c_{i}}{N \cdot A_{i}}$	Оценка функции плотности вероятности. Объем каждой панели является относительным количеством наблюдений. Сумма объемов панели меньше чем или равна `1`.
`'cdf'`	$v_{i} = \sum_{j = 1}^{i} \frac{c_{j}}{N}$	Совокупная оценка функции плотности. Высота каждой панели равна совокупному относительному количеству наблюдений в каждом интервале и всех предыдущих интервалах и в x и в размерностях y. Высота последней панели меньше чем или равна `1`.

Пример: histogram2(X,Y,'Normalization','pdf') строит оценку функции плотности вероятности для X и Y.

`'ShowEmptyBins'` — Переключите отображение пустых интервалов
`'off'` (значение по умолчанию) | `'on'`

Переключите отображение пустых интервалов в виде любого 'off' или 'on'. Значением по умолчанию является 'off'.

Пример: histogram2(X,Y,'ShowEmptyBins','on') включает отображение пустых интервалов.

`'XBinLimits'` — Интервал ограничивает в x - размерность
вектор

Интервал ограничивает в x - размерность в виде двухэлементного вектора, [xbmin,xbmax]. Вектор указывает на первые и последние границы интервала в x - размерность.

histogram2 только отображает на графике данные, которые находятся в пределах пределов интервала включительно, Data(Data(:,1)>=xbmin & Data(:,1)<=xbmax).

`'XBinLimitsMode'` — Режим выбора для интервала ограничивает в x - размерность
`'auto'` (значение по умолчанию) | `'manual'`

Режим выбора для интервала ограничивает в x - размерность в виде 'auto' или 'manual'. Значением по умолчанию является 'auto', так, чтобы пределы интервала автоматически настроили к данным вдоль оси X.

Если вы явным образом задаете любой XBinLimits или XBinEdges, затем XBinLimitsMode установлен автоматически в 'manual'. В этом случае задайте XBinLimitsMode как 'auto' перемасштабировать пределы интервала данным.

`'YBinLimits'` — Интервал ограничивает в y - размерность
вектор

Интервал ограничивает в y - размерность в виде двухэлементного вектора, [ybmin,ybmax]. Вектор указывает на первые и последние границы интервала в y - размерность.

histogram2 только отображает на графике данные, которые находятся в пределах пределов интервала включительно, Data(Data(:,2)>=ybmin & Data(:,2)<=ybmax).

`'YBinLimitsMode'` — Режим выбора для интервала ограничивает в y - размерность
`'auto'` (значение по умолчанию) | `'manual'`

Режим выбора для интервала ограничивает в y - размерность в виде 'auto' или 'manual'. Значением по умолчанию является 'auto', так, чтобы пределы интервала автоматически настроили к данным вдоль оси Y.

Если вы явным образом задаете любой YBinLimits или YBinEdges, затем YBinLimitsMode установлен автоматически в 'manual'. В этом случае задайте YBinLimitsMode как 'auto' перемасштабировать пределы интервала данным.

Выходные аргументы

развернуть все

`h` — Двумерная гистограмма
объект

Двумерная гистограмма, возвращенная как объект. Для получения дополнительной информации смотрите Histogram2 Properties.

Свойства

Histogram2 Properties

Внешний вид и поведение Histogram2

Функции объекта

`morebins`	Увеличение числа интервалов гистограммы
`fewerbins`	Сокращение числа интервалов гистограммы

Примеры

свернуть все

Гистограмма векторов

Скрипт Open Live Script

Сгенерируйте 10 000 пар случайных чисел и создайте двумерную гистограмму. histogram2 функция автоматически выбирает соответствующее количество интервалов, чтобы покрыть область значений значений в x и y и покажите форму базового распределения.

x = randn(10000,1);
y = randn(10000,1);
h = histogram2(x,y)

h = 
  Histogram2 with properties:

             Data: [10000x2 double]
           Values: [25x28 double]
          NumBins: [25 28]
        XBinEdges: [1x26 double]
        YBinEdges: [1x29 double]
         BinWidth: [0.3000 0.3000]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0.1500 0.1500 0.1500]

  Show all properties

xlabel('x')
ylabel('y')

Когда вы задаете выходной аргумент histogram2 функция, это возвращает объект histogram2. Можно использовать этот объект смотреть свойства гистограммы, такие как количество интервалов или ширина интервалов.

Найдите количество интервалов гистограммы в каждой размерности.

nXnY = h.NumBins

nXnY = 1×2

    25    28

Определение количества интервалов гистограммы

Скрипт Open Live Script

Постройте двумерную гистограмму 1 000 пар случайных чисел, отсортированных в 25 равномерно распределенных интервалов, с помощью 5 интервалов в каждой размерности.

x = randn(1000,1);
y = randn(1000,1);
nbins = 5;
h = histogram2(x,y,nbins)

h = 
  Histogram2 with properties:

             Data: [1000x2 double]
           Values: [5x5 double]
          NumBins: [5 5]
        XBinEdges: [-4 -2.4000 -0.8000 0.8000 2.4000 4]
        YBinEdges: [-4 -2.4000 -0.8000 0.8000 2.4000 4]
         BinWidth: [1.6000 1.6000]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0.1500 0.1500 0.1500]

  Show all properties

Найдите получившееся количество интервалов.

counts = h.Values

counts = 5×5

     0     2     3     1     0
     2    40   124    47     4
     1   119   341   109    10
     1    32   117    33     1
     0     4     8     1     0

Корректировка количества интервалов гистограммы

Скрипт Open Live Script

Сгенерируйте 1 000 пар случайных чисел и создайте двумерную гистограмму.

x = randn(1000,1);
y = randn(1000,1);
h = histogram2(x,y)

h = 
  Histogram2 with properties:

             Data: [1000x2 double]
           Values: [15x15 double]
          NumBins: [15 15]
        XBinEdges: [1x16 double]
        YBinEdges: [1x16 double]
         BinWidth: [0.5000 0.5000]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0.1500 0.1500 0.1500]

  Show all properties

Используйте morebins функционируйте, чтобы грубо настроить количество интервалов в x размерности.

nbins = morebins(h,'x');
nbins = morebins(h,'x')

nbins = 1×2

    19    15

Используйте fewerbins функция, чтобы настроить количество интервалов в y размерности.

nbins = fewerbins(h,'y');
nbins = fewerbins(h,'y')

nbins = 1×2

    19    11

Настройте количество интервалов на мелкозернистом уровне путем явного определения номера интервалов.

h.NumBins = [20 10];

Цветные панели гистограммы высотой

Скрипт Open Live Script

Создайте двумерную гистограмму с помощью 1 000 нормально распределенных случайных чисел с 12 интервалами в каждой размерности. Задайте FaceColor как 'flat' окрасить панели гистограммы высотой.

h = histogram2(randn(1000,1),randn(1000,1),[12 12],'FaceColor','flat');
colorbar

Мозаичное представление гистограммы

Скрипт Open Live Script

Сгенерируйте случайные данные и постройте двумерную мозаичную гистограмму. Отобразите пустые интервалы путем определения ShowEmptyBins как 'on'.

x = 2*randn(1000,1)+2;
y = 5*randn(1000,1)+3;
h = histogram2(x,y,'DisplayStyle','tile','ShowEmptyBins','on');

Определение краев интервала гистограммы

Скрипт Open Live Script

Сгенерируйте 1 000 пар случайных чисел и создайте двумерную гистограмму. Задайте границы интервала с помощью двух векторов с бесконечно широкими интервалами на контуре гистограммы, чтобы получить все выбросы, которые не удовлетворяют $| x | < 2$ .

x = randn(1000,1);
y = randn(1000,1);
Xedges = [-Inf -2:0.4:2 Inf];
Yedges = [-Inf -2:0.4:2 Inf];
h = histogram2(x,y,Xedges,Yedges)

h = 
  Histogram2 with properties:

             Data: [1000x2 double]
           Values: [12x12 double]
          NumBins: [12 12]
        XBinEdges: [1x13 double]
        YBinEdges: [1x13 double]
         BinWidth: 'nonuniform'
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0.1500 0.1500 0.1500]

  Show all properties

Когда границы интервала бесконечны, histogram2 отображения каждый интервал выброса (вдоль контура гистограммы) как удваивание ширины интервала рядом с ним.

Задайте Normalization свойство как 'countdensity' удалить интервалы, содержащие выбросы. Теперь объем каждого интервала представляет частоту наблюдений в том интервале.

h.Normalization = 'countdensity';

Нормализованная гистограмма

Скрипт Open Live Script

Сгенерируйте 1 000 пар случайных чисел и создайте двумерную гистограмму с помощью 'probability' нормализация.

x = randn(1000,1);
y = randn(1000,1);
h = histogram2(x,y,'Normalization','probability')

h = 
  Histogram2 with properties:

             Data: [1000x2 double]
           Values: [15x15 double]
          NumBins: [15 15]
        XBinEdges: [1x16 double]
        YBinEdges: [1x16 double]
         BinWidth: [0.5000 0.5000]
    Normalization: 'probability'
        FaceColor: 'auto'
        EdgeColor: [0.1500 0.1500 0.1500]

  Show all properties

Вычислите полную сумму высот панели. С этой нормализацией высота каждой панели равна вероятности выбора наблюдения в том интервале интервала и высот всей суммы панелей к 1.

S = sum(h.Values(:))

S = 1

Adjust Histogram Properties

Скрипт Open Live Script

Сгенерируйте 1 000 пар случайных чисел и создайте двумерную гистограмму. Возвратите объект гистограммы настроить свойства гистограммы, не воссоздавая целый график.

x = randn(1000,1);
y = randn(1000,1);
h = histogram2(x,y)

h = 
  Histogram2 with properties:

             Data: [1000x2 double]
           Values: [15x15 double]
          NumBins: [15 15]
        XBinEdges: [1x16 double]
        YBinEdges: [1x16 double]
         BinWidth: [0.5000 0.5000]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0.1500 0.1500 0.1500]

  Show all properties

Окрасьте панели гистограммы высотой.

h.FaceColor = 'flat';

Измените количество интервалов в каждом направлении.

h.NumBins = [10 25];

Отобразите гистограмму как график мозаики.

h.DisplayStyle = 'tile';
view(2)

Сохранение и загрузка объектов Histogram2

Скрипт Open Live Script

Используйте savefig функционируйте, чтобы сохранить фигуру histogram2.

y = histogram2(randn(100,1),randn(100,1));
savefig('histogram2.fig');
clear all
close all

Используйте openfig чтобы загрузить гистограмму фигурируют назад в MATLAB. openfig также возвращает указатель на фигуру, h.

h = openfig('histogram2.fig');

Используйте findobj функция, чтобы определить местоположение указателя правильного объекта от указателя фигуры. Это позволяет, вы, чтобы продолжить управлять исходным объектом гистограммы раньше генерировали фигуру.

y = findobj(h, 'type', 'histogram2')

y = 
  Histogram2 with properties:

             Data: [100x2 double]
           Values: [7x6 double]
          NumBins: [7 6]
        XBinEdges: [-3 -2 -1 0 1 2 3 4]
        YBinEdges: [-3 -2 -1 0 1 2 3]
         BinWidth: [1 1]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0.1500 0.1500 0.1500]

  Show all properties

Советы

Графики гистограммы, созданные с помощью histogram2 имейте контекстное меню в режиме редактирования графика, который включает интерактивные манипуляции в окне рисунка. Например, можно использовать контекстное меню, чтобы в интерактивном режиме изменить количество интервалов, выровнять несколько гистограмм или изменить порядок отображения.

Расширенные возможности

"Высокие" массивы
Осуществление вычислений с массивами, которые содержат больше строк, чем помещается в памяти.

Эта функция поддерживает высокие массивы с ограничениями:

Некоторые входные опции не поддерживаются. Позволенные опции:
- 'BinWidth'
- 'XBinLimits'
- 'YBinLimits'
- 'Normalization'
- 'DisplayStyle'
- 'BinMethod' — 'auto' и 'scott' методы интервала являются тем же самым. 'fd' метод интервала не поддерживается.
- 'EdgeAlpha'
- 'EdgeColor'
- 'FaceAlpha'
- 'FaceColor'
- 'LineStyle'
- 'LineWidth'
- 'Orientation'
Кроме того, существует дно на максимальном количестве панелей. Максимум по умолчанию равняется 100.
morebins и fewerbins методы не поддерживаются.
При редактировании свойств объекта гистограммы, которые требуют, не поддерживается перевычисление интервалов.

Для получения дополнительной информации смотрите Длинные массивы для Данных, которые не помещаются в память.

Введенный в R2015b

Документация

histogram2

Описание

Создание

Синтаксис

Описание

Входные параметры

X,Y — Данные, чтобы распределить среди интервалов (в качестве отдельных аргументов) векторы | матрицы | многомерные массивы

nbins — Количество интервалов в каждой размерности скаляр | вектор

Xedges — Границы интервала в x - размерность вектор

Yedges — Границы интервала в y - размерность вектор

counts bincounts матрица

ax Объект осей объект

'BinMethod' — Алгоритм раскладывания 'auto' (значение по умолчанию) | 'scott' | 'fd' | 'integers'

'BinWidth' — Ширина интервалов в каждой размерности вектор

'DisplayStyle' — Стиль отображения гистограммы 'bar3' (значение по умолчанию) | 'tile'

'EdgeAlpha' — Прозрачность ребер панели гистограммы1 (значение по умолчанию) | скалярное значение между 0 и 1 включительно

'EdgeColor' — Цвет обводки гистограммы[0.15 0.15 0.15] (значение по умолчанию) | 'none' | 'auto' | Триплет RGB | шестнадцатеричный цветовой код | название цвета

'FaceAlpha' — Прозрачность панелей гистограммы1 (значение по умолчанию) | скалярное значение между 0 и 1 включительно

'FaceColor' — Цвет панели гистограммы 'auto' (значение по умолчанию) | 'flat' | 'none' | Триплет RGB | шестнадцатеричный цветовой код | название цвета

'FaceLighting' — Эффект освещения на панели гистограммы 'lit' (значение по умолчанию) | 'flat' | 'none'

'LineStyle' — Стиль линии '-' (значение по умолчанию) | '--' | ':' | '-.' | 'none'

'LineWidth' — Ширина основ панели0.5 (значение по умолчанию) | положительное значение

'Normalization' — Тип нормализации 'count' (значение по умолчанию) | 'probability' | 'countdensity' | 'pdf' | 'cumcount' | 'cdf'

'ShowEmptyBins' — Переключите отображение пустых интервалов 'off' (значение по умолчанию) | 'on'

'XBinLimits' — Интервал ограничивает в x - размерность вектор

'XBinLimitsMode' — Режим выбора для интервала ограничивает в x - размерность 'auto' (значение по умолчанию) | 'manual'

'YBinLimits' — Интервал ограничивает в y - размерность вектор

'YBinLimitsMode' — Режим выбора для интервала ограничивает в y - размерность 'auto' (значение по умолчанию) | 'manual'

Выходные аргументы

h — Двумерная гистограмма объект

Свойства

Функции объекта

Примеры

Гистограмма векторов

Определение количества интервалов гистограммы

Корректировка количества интервалов гистограммы

Цветные панели гистограммы высотой

Мозаичное представление гистограммы

Определение краев интервала гистограммы

Нормализованная гистограмма

Adjust Histogram Properties

Сохранение и загрузка объектов Histogram2

Советы

Расширенные возможности

"Высокие" массивы Осуществление вычислений с массивами, которые содержат больше строк, чем помещается в памяти.

Смотрите также

Документация MATLAB

Поддержка

`X,Y` — Данные, чтобы распределить среди интервалов (в качестве отдельных аргументов)
векторы | матрицы | многомерные массивы

`nbins` — Количество интервалов в каждой размерности
скаляр | вектор

`Xedges` — Границы интервала в x - размерность
вектор

`Yedges` — Границы интервала в y - размерность
вектор

`counts` bincounts
матрица

`ax` Объект осей
объект

`'BinMethod'` — Алгоритм раскладывания
`'auto'` (значение по умолчанию) | `'scott'` | `'fd'` | `'integers'`

`'BinWidth'` — Ширина интервалов в каждой размерности
вектор

`'DisplayStyle'` — Стиль отображения гистограммы
`'bar3'` (значение по умолчанию) | `'tile'`

`'EdgeAlpha'` — Прозрачность ребер панели гистограммы
1 (значение по умолчанию) | скалярное значение между `0` и `1` включительно

`'EdgeColor'` — Цвет обводки гистограммы
[0.15 0.15 0.15] (значение по умолчанию) | `'none'` | `'auto'` | Триплет RGB | шестнадцатеричный цветовой код | название цвета

`'FaceAlpha'` — Прозрачность панелей гистограммы
1 (значение по умолчанию) | скалярное значение между `0` и `1` включительно

`'FaceColor'` — Цвет панели гистограммы
`'auto'` (значение по умолчанию) | `'flat'` | `'none'` | Триплет RGB | шестнадцатеричный цветовой код | название цвета

`'FaceLighting'` — Эффект освещения на панели гистограммы
`'lit'` (значение по умолчанию) | `'flat'` | `'none'`

`'LineStyle'` — Стиль линии
`'-'` (значение по умолчанию) | `'--'` | `':'` | `'-.'` | `'none'`

`'LineWidth'` — Ширина основ панели
0.5 (значение по умолчанию) | положительное значение

`'Normalization'` — Тип нормализации
`'count'` (значение по умолчанию) | `'probability'` | `'countdensity'` | `'pdf'` | `'cumcount'` | `'cdf'`

`'ShowEmptyBins'` — Переключите отображение пустых интервалов
`'off'` (значение по умолчанию) | `'on'`

`'XBinLimits'` — Интервал ограничивает в x - размерность
вектор

`'XBinLimitsMode'` — Режим выбора для интервала ограничивает в x - размерность
`'auto'` (значение по умолчанию) | `'manual'`

`'YBinLimits'` — Интервал ограничивает в y - размерность
вектор

`'YBinLimitsMode'` — Режим выбора для интервала ограничивает в y - размерность
`'auto'` (значение по умолчанию) | `'manual'`

`h` — Двумерная гистограмма
объект

"Высокие" массивы
Осуществление вычислений с массивами, которые содержат больше строк, чем помещается в памяти.