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-by-2 матрица доминирующего типа данных.

histogram2 игнорирует все значения NaN. Точно так же histogram2 игнорирует Inf и значения -Inf, если края интервала явным образом не задают Inf или -Inf как край интервала. Несмотря на то, что NaN, Inf и значения -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) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: 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` является межквартильным размахом.
`Целые числа`	Целочисленное правило полезно с целочисленными данными, когда это создает интервалы, центрируемые на парах целых чисел. Это использует ширину интервала 1 для каждой размерности и помещает края интервала на полпути между целыми числами. Чтобы постараться не случайно создавать слишком много интервалов, можно использовать это правило, чтобы создать предел 1 024 интервалов ⁽²¹⁰⁾. Если область значений данных для любой размерности больше, чем 1 024, то целочисленное правило использует более широкие интервалы вместо этого.

Примечание

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

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

`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', 'мозаика') строит график гистограммы как прямоугольного массива мозаик.

`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 представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7]. Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены варианты длинного и краткого наименований цветов и их эквивалентные значения RGB.

Опция	Описание	Эквивалентный триплет RGB
`'красный' или 'r'`	Красный	`[1 0 0]`
`'green'` или `'g'`	Зеленый	`[0 1 0]`
`'blue'` или `'b'`	Синий	`[0 0 1]`
`'yellow'` или `'y'`	Желтый	`[1 1 0]`
`'пурпурный' или 'm'`	Пурпурный	`[1 0 1]`
`'голубой' или 'c'`	Голубой	`[0 1 1]`
`'white'` или `'w'`	Белый	`[1 1 1]`
`'black'` или `'k'`	Черный	`[0 0 0]`

Пример: 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
`'красный' или 'r'`	Красный	`[1 0 0]`
`'green'` или `'g'`	Зеленый	`[0 1 0]`
`'blue'` или `'b'`	Синий	`[0 0 1]`
`'yellow'` или `'y'`	Желтый	`[1 1 0]`
`'пурпурный' или 'm'`	Пурпурный	`[1 0 1]`
`'голубой' или 'c'`	Голубой	`[0 1 1]`
`'white'` или `'w'`	Белый	`[1 1 1]`
`'black'` или `'k'`	Черный	`[0 0 0]`

Если вы задаете 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', 'ни один') выключает подсветку панелей гистограммы.

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

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

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

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

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

Пример 1. 5

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

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

$_{vi}$ является значением интервала.
$_{ci}$ является числом элементов в интервале.
$_{}_{}_{Ai=wxi⋅wyi}$ является областью каждого интервала, вычисленное использование ширин интервала x и y.
$N$ является числом элементов во входных данных. Это значение может быть больше, чем сгруппированные данные, если данные содержат значения NaN, или если некоторые данные находятся вне пределов интервала.

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

Пример: histogram2 (X, Y, 'Нормализация', '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.

Свойства

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 = 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.0000

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

Советы

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

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

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

Введенный в R2015b

Документация 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` Двумерная гистограмма
объект

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