гистограмма

График гистограммы

Описание

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

Создание

Синтаксис

histogram(X)

histogram(X,nbins)

histogram(X,edges)

histogram('BinEdges',edges,'BinCounts',counts)

histogram(C)

histogram(C,Categories)

histogram('Categories',Categories,'BinCounts',counts)

histogram(___,Name,Value)

histogram(ax,___)

h = histogram(___)

Описание

пример

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

пример

histogram(X,nbins) использование много интервалов, заданных скаляром, nbins.

пример

histogram(X,edges) виды X в интервалы с ребрами интервала, заданными вектором, edges. Каждый интервал включает левый край, но не включает правый край, за исключением последнего интервала, который включает оба ребра.

histogram('BinEdges',edges,'BinCounts',counts) вручную задает ребра интервала и сопоставленные количества интервала. histogram строит заданные количества интервала и не делает никакого раскладывания данных.

пример

histogram(C), то, где C является категориальным массивом, строит гистограмму с панелью для каждой категории в C.

histogram(C,Categories) графики только подмножество категорий заданы Categories.

histogram('Categories',Categories,'BinCounts',counts) вручную задает категории и сопоставленные количества интервала. histogram строит заданные количества интервала и не делает никакого раскладывания данных.

пример

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

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

пример

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

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

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

`X` Данные, чтобы распределить среди интервалов
вектор | матрица | многомерный массив

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

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

Примечание

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

`C` Категориальные данные
категориальный массив

Категориальные данные, заданные как категориальный массив. histogram не строит неопределенные категориальные значения. Однако неопределенные категориальные значения все еще включены в вычисления нормализации, которые включают общее количество элементов данных, таких как 'probability'.

Типы данных: categorical

`nbins` Количество интервалов
положительное целое число

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

Пример: histogram(X,15) создает гистограмму с 15 интервалами.

`края` BinEdges
вектор

Ребра интервала, заданные как вектор. edges(1) является левым краем первого интервала, и edges(end) является правым краем последнего интервала.

Значение X(i) находится в k th интервал если edges(k) ≤ X(i) <edges(k+1). Последний интервал также включает правильное ребро интервала, так, чтобы это содержало X(i) если edges(end-1) ≤ X(i) ≤ edges(end).

Для datetime и данных о длительности, edges должен быть datetime или вектором длительности в монотонно увеличивающемся порядке.

`Категории` Категории включены в гистограмму
массив ячеек из символьных векторов | категориальный вектор

Примечание

Эта опция только применяется к категориальным гистограммам.

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

Если вы задаете входной категориальный массив C, то по умолчанию, histogram строит панель для каждой категории в C. В этом случае используйте Categories, чтобы задать уникальное подмножество категорий вместо этого.
Если вы задаете количества интервала, то Categories задает связанные названия категории для гистограммы.

Пример: h = histogram(C,{'Large','Small'}) отображает на графике только категориальные данные в категориях 'Large' и 'Small'.

Пример: histogram('Categories',{'Yes','No','Maybe'},'BinCounts',[22 18 3]) строит гистограмму, которая имеет три категории со связанными количествами интервала.

Пример: h.Categories запрашивает категории, которые находятся в объекте h гистограммы.

Типы данных: cell | categorical

`counts` — Bincounts
вектор

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

Длина counts должна быть равна количеству интервалов.

Для числовых гистограмм количеством интервалов является length(edges)-1.
Для категориальных гистограмм количество интервалов равно количеству категорий.

Пример: histogram('BinEdges',-2:2,'BinCounts',[5 8 15 9])

Пример: histogram('Categories',{'Yes','No','Maybe'},'BinCounts',[22 18 3])

`ax` — Целевые оси
Объект `Axes` | объект `PolarAxes`

Целевые оси, заданные как объект Axes или объект PolarAxes. Если вы не задаете оси и если текущей системой координат являются Оси декартовой системы координат, то функция histogram использует текущую систему координат (gca). Чтобы построить в полярные оси, задайте объект PolarAxes как первый входной параметр или используйте функцию polarhistogram.

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

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

Пример: histogram(X,'BinWidth',5)

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

`BarWidth` Относительная ширина категориальных панелей
`0.9` (значение по умолчанию) | скаляр в области значений `[0,1]`

Примечание

Эта опция только применяется к гистограммам категориальных данных.

Относительная ширина категориальных панелей, заданных как скалярное значение в области значений [0,1]. Используйте это свойство управлять разделением категориальных панелей в гистограмме. Значением по умолчанию является 0.9, что означает, что ширина панели составляет 90% пробела от предыдущей панели до следующей панели с 5% того пробела на каждой стороне.

Если вы устанавливаете это свойство на 1, то смежное касание панелей.

Пример: 0.5

`'BinLimits'` 'BinLimits'
двухэлементный вектор

Пределы интервала, заданные как двухэлементный вектор, [bmin,bmax]. Эта опция строит гистограмму с помощью значений во входном массиве, X, том падении между bmin и bmax включительно. Таким образом, X(X>=bmin & X<=bmax).

Эта опция не применяется к гистограммам категориальных данных.

Пример: histogram(X,'BinLimits',[1,10]) строит гистограмму с помощью только значения в X, которые являются между 1 и 10 включительно.

`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'`	Правило Фридмена—Диакониса менее чувствительно к выбросам в данных и может более подойти для данных с дистрибутивами с тяжелым хвостом. Это использует ширину интервала `2IQR(X(:))numel(X)^(-1/3)`, где `IQR` является межквартильным размахом `X`.
`'integers'`	Целочисленное правило полезно с целочисленными данными, когда это создает интервал для каждого целого числа. Это использует ширину интервала 1 и помещает ребра интервала на полпути между целыми числами. Чтобы постараться не случайно создавать слишком много интервалов, можно использовать это правило, чтобы создать предел 65 536 интервалов ⁽²¹⁶⁾. Если область значений данных больше, чем 65 536, то целочисленное правило использует более широкие интервалы вместо этого. Примечание `'integers'` не поддерживает данные о длительности или datetime.
`'sturges'`	Правило Стерджеса популярно из-за его простоты. Это выбирает количество интервалов, чтобы быть `ceil(1 + log2(numel(X)))`.
`'sqrt'`	Правило Квадратного корня широко использовано в других пакетах программного обеспечения. Это выбирает количество интервалов, чтобы быть `ceil(sqrt(numel(X)))`.

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

Для данных о datetime метод интервала может быть одним из этих модулей времени:

`'second'`	`'month'`
`'minute'`	`'quarter'`
`'hour'`	`'year'`
`'day'`	`'decade'`
`'week'`	`'century'`

Для данных о длительности метод интервала может быть одним из этих модулей времени:

`'second'`	`'day'`
`'minute'`	`'year'`
`'hour'`

Если вы задаете BinMethod с datetime или данными о длительности, то histogram может использовать максимум 65 536 интервалов (или ²¹⁶). Если заданная длительность интервала требует большего количества интервалов, то histogram использует большую ширину интервала, соответствующую максимальному количеству интервалов.

Эта опция не применяется к гистограммам категориальных данных.

Примечание

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

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

`BinWidth` Ширина интервалов
скаляр

Ширина интервалов, заданных как скаляр. Когда вы задаете BinWidth, затем histogram может использовать максимум 65 536 интервалов (или ²¹⁶). Если вместо этого заданная ширина интервала требует большего количества интервалов, то histogram использует большую ширину интервала, соответствующую максимальному количеству интервалов.

Для datetime и данных о длительности, значение 'BinWidth' может быть скалярной длительностью или календарной длительностью.

Эта опция не применяется к гистограммам категориальных данных.

Пример: histogram(X,'BinWidth',5) использует интервалы с шириной 5.

`DisplayOrder` Порядок отображения категории
`'data'` (значение по умолчанию) | `'ascend'` | `'descend'`

Порядок отображения категории, заданный как 'ascend', 'descend' или 'data'. С 'ascend' или 'descend', гистограмма отображается с увеличением или уменьшением высот панели. Значение 'data' по умолчанию использует порядок категории во входных данных, C.

Эта опция только работает с категориальными данными.

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

Стиль отображения гистограммы, заданный или как 'bar' или как 'stairs'. Задайте 'stairs', чтобы отобразить ступенчатый график, который отображает схему гистограммы, не заполняя внутреннюю часть.

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

Пример: histogram(X,'DisplayStyle','stairs') строит схему гистограммы.

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

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

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

`'EdgeColor'` Цвет обводки гистограммы
`[0 0 0]` или черное (значение по умолчанию) | `'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'`

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

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

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

Пример: histogram(X,'FaceAlpha',1) создает график гистограммы с полностью непрозрачными панелями.

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

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

'none' Панели не заполнены.
'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', то histogram не использует свойство FaceColor.

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

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

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

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

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

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

Пример: 1.5

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

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

$v_{i}$ значение интервала.
$c_{i}$ число элементов в интервале.
$w_{i}$ ширина интервала.
$N$ число элементов во входных данных. Это значение может быть больше, чем сгруппированные данные, если данные содержат NaN, NaT или значения <undefined>, или если некоторые данные находятся вне пределов интервала.

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

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

`'NumDisplayBins'` Количество категорий, чтобы отобразиться
скаляр

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

Эта опция только работает с категориальными данными.

`'Orientation'` — Ориентация панелей
`'vertical'` (значение по умолчанию) | `'horizontal'`

Ориентация панелей, заданных как 'vertical' или 'horizontal'.

Пример: histogram(X,'Orientation','horizontal') создает график гистограммы с горизонтальными планками.

`'ShowOthers'` Переключите итоговое отображение данных, принадлежащих неотображенным категориям
`'off'` (значение по умолчанию) | `'on'`

Переключите итоговое отображение данных, принадлежащих неотображенным категориям, заданным как 'off' или 'on'. Установите эту опцию на 'on' отображать дополнительную панель в гистограмме с именем 'Others'. Эта дополнительная панель считает все элементы, которые не принадлежат категориям, отображенным в гистограмме.

Можно изменить количество категорий, отображенных в гистограмме, а также их порядке, с помощью опций 'DisplayOrder' и 'NumDisplayBins'.

Эта опция только работает с категориальными данными.

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

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

`h` Гистограмма
объект

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

Свойства

Histogram Properties

Внешний вид и поведение гистограммы

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

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

Примеры

свернуть все

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

Скрипт Open Live Script

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

x = randn(10000,1);
h = histogram(x)

h = 
  Histogram with properties:

             Data: [10000x1 double]
           Values: [1x37 double]
          NumBins: 37
         BinEdges: [1x38 double]
         BinWidth: 0.2000
        BinLimits: [-3.8000 3.6000]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0 0 0]

  Show all properties

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

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

nbins = h.NumBins

nbins = 37

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

Скрипт Open Live Script

Постройте гистограмму 1 000 случайных чисел, отсортированных в 25 равномерно распределенных интервалов.

x = randn(1000,1);
nbins = 25;
h = histogram(x,nbins)

h = 
  Histogram with properties:

             Data: [1000x1 double]
           Values: [1x25 double]
          NumBins: 25
         BinEdges: [1x26 double]
         BinWidth: 0.2800
        BinLimits: [-3.4000 3.6000]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0 0 0]

  Show all properties

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

counts = h.Values

counts = 1×25

     1     3     0     6    14    19    31    54    74    80    92   122   104   115    88    80    38    32    21     9     5     5     5     0     2

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

Скрипт Open Live Script

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

X = randn(1000,1);
h = histogram(X)

h = 
  Histogram with properties:

             Data: [1000x1 double]
           Values: [1x23 double]
          NumBins: 23
         BinEdges: [1x24 double]
         BinWidth: 0.3000
        BinLimits: [-3.3000 3.6000]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0 0 0]

  Show all properties

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

Nbins = morebins(h);
Nbins = morebins(h)

Nbins = 29

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

h.NumBins = 31;

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

Скрипт Open Live Script

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

x = randn(1000,1);
edges = [-10 -2:0.25:2 10];
h = histogram(x,edges);

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

h.Normalization = 'countdensity';

Графическое изображение категориальной гистограммы

Скрипт Open Live Script

Создайте категориальный вектор, который представляет голоса. Категориями в векторе является 'yes', 'no' или 'undecided'.

A = [0 0 1 1 1 0 0 0 0 NaN NaN 1 0 0 0 1 0 1 0 1 0 0 0 1 1 1 1];
C = categorical(A,[1 0 NaN],{'yes','no','undecided'})

C = 1x27 categorical array
  Columns 1 through 9

     no      no      yes      yes      yes      no      no      no      no 

  Columns 10 through 16

     undecided      undecided      yes      no      no      no      yes 

  Columns 17 through 25

     no      yes      no      yes      no      no      no      yes      yes 

  Columns 26 through 27

     yes      yes

Постройте категориальную гистограмму голосов, с помощью относительной ширины панели 0.5.

h = histogram(C,'BarWidth',0.5)

h = 
  Histogram with properties:

              Data: [1x27 categorical]
            Values: [11 14 2]
    NumDisplayBins: 3
        Categories: {'yes'  'no'  'undecided'}
      DisplayOrder: 'data'
     Normalization: 'count'
      DisplayStyle: 'bar'
         FaceColor: 'auto'
         EdgeColor: [0 0 0]

  Show all properties

Гистограмма с заданной нормализацией

Скрипт Open Live Script

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

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

h = 
  Histogram with properties:

             Data: [1000x1 double]
           Values: [1x23 double]
          NumBins: 23
         BinEdges: [1x24 double]
         BinWidth: 0.3000
        BinLimits: [-3.3000 3.6000]
    Normalization: 'probability'
        FaceColor: 'auto'
        EdgeColor: [0 0 0]

  Show all properties

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

S = sum(h.Values)

S = 1

Графическое изображение нескольких гистограмм

Скрипт Open Live Script

Сгенерируйте два вектора случайных чисел и постройте гистограмму для каждого вектора в той же фигуре.

x = randn(2000,1);
y = 1 + randn(5000,1);
h1 = histogram(x);
hold on
h2 = histogram(y);

Поскольку объем выборки и ширина интервала гистограмм отличаются, трудно сравнить их. Нормируйте гистограммы так, чтобы все высоты панели добавили к 1 и использовали универсальную ширину интервала.

h1.Normalization = 'probability';
h1.BinWidth = 0.25;
h2.Normalization = 'probability';
h2.BinWidth = 0.25;

Adjust Histogram Properties

Скрипт Open Live Script

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

x = randn(1000,1);
h = histogram(x)

h = 
  Histogram with properties:

             Data: [1000x1 double]
           Values: [1x23 double]
          NumBins: 23
         BinEdges: [1x24 double]
         BinWidth: 0.3000
        BinLimits: [-3.3000 3.6000]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0 0 0]

  Show all properties

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

h.NumBins = 15;

Задайте ребра интервалов с вектором. Первое значение в векторе является левым краем первого интервала. Последнее значение является правым краем последнего интервала.

h.BinEdges = [-3:3];

Измените цвет панелей гистограммы.

h.FaceColor = [0 0.5 0.5];
h.EdgeColor = 'r';

Определение базового распределения вероятностей

Скрипт Open Live Script

Сгенерируйте 5 000 нормально распределенных случайных чисел со средним значением 5 и стандартным отклонением 2. Постройте гистограмму с набором Normalization к 'pdf', чтобы произвести оценку функции плотности вероятности.

x = 2*randn(5000,1) + 5;
histogram(x,'Normalization','pdf')

В этом примере известно базовое распределение для нормально распределенных данных. Можно, однако, использовать график гистограммы 'pdf' определить базовое распределение вероятностей данных путем сравнения его с известной функцией плотности вероятности.

Функция плотности вероятности для нормального распределения со средним значением $μ$ Стандартное отклонение $σ$ , и отклонение $σ^{2}$

$f (x, μ, σ) = \frac{1}{σ \sqrt{2 π}} exp [- \frac{(x - μ)^{2}}{2 σ^{2}}] .$

Наложите график функции плотности вероятности для нормального распределения со средним значением 5 и стандартным отклонением 2.

hold on
y = -5:0.1:15;
mu = 5;
sigma = 2;
f = exp(-(y-mu).^2./(2*sigma^2))./(sigma*sqrt(2*pi));
plot(y,f,'LineWidth',1.5)

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

Скрипт Open Live Script

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

y = histogram(randn(10));
savefig('histogram.fig');

clear all
close all

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

h = openfig('histogram.fig');

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

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

y = 
  Histogram with properties:

             Data: [10x10 double]
           Values: [2 17 28 32 16 3 2]
          NumBins: 7
         BinEdges: [-3 -2 -1 0 1 2 3 4]
         BinWidth: 1
        BinLimits: [-3 4]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0 0 0]

  Show all properties

Советы

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

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

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

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

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

Для получения дополнительной информации см. Раздел "Высокие массивы".

Массивы графического процессора
Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.

Указания и ограничения по применению:

Эта функция принимает массивы графического процессора, но не работает на графическом процессоре.

Для получения дополнительной информации смотрите функции MATLAB Выполнения на графическом процессоре (Parallel Computing Toolbox).

Распределенные массивы
Большие массивы раздела через объединенную память о вашем кластере с помощью Parallel Computing Toolbox™.

Указания и ограничения по применению:

Эта функция работает с распределенными массивами, но выполняет в клиенте MATLAB.

Для получения дополнительной информации смотрите функции MATLAB Выполнения с Распределенными Массивами (Parallel Computing Toolbox).

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

гистограмма

Описание

Создание

Синтаксис

Описание

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

X Данные, чтобы распределить среди интервалов вектор | матрица | многомерный массив

Примечание

C Категориальные данные категориальный массив

nbins Количество интервалов положительное целое число

края BinEdges вектор

Категории Категории включены в гистограмму массив ячеек из символьных векторов | категориальный вектор

Примечание

counts — Bincounts вектор

ax — Целевые оси Объект Axes | объект PolarAxes

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

BarWidth Относительная ширина категориальных панелей 0.9 (значение по умолчанию) | скаляр в области значений [0,1]

Примечание

'BinLimits' 'BinLimits' двухэлементный вектор

BinLimitsMode Режим выбора для пределов интервала 'auto' (значение по умолчанию) | 'manual'

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

Примечание

Примечание

BinWidth Ширина интервалов скаляр

DisplayOrder Порядок отображения категории 'data' (значение по умолчанию) | 'ascend' | 'descend'

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

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

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

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

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

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

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

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

Примечание

Примечание

'NumDisplayBins' Количество категорий, чтобы отобразиться скаляр

'Orientation' — Ориентация панелей 'vertical' (значение по умолчанию) | 'horizontal'

'ShowOthers' Переключите итоговое отображение данных, принадлежащих неотображенным категориям 'off' (значение по умолчанию) | 'on'

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

h Гистограмма объект

Свойства

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

Примеры

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

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

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

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

Графическое изображение категориальной гистограммы

Гистограмма с заданной нормализацией

Графическое изображение нескольких гистограмм

Adjust Histogram Properties

Определение базового распределения вероятностей

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

Советы

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

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

Массивы графического процессора Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.

Распределенные массивы Большие массивы раздела через объединенную память о вашем кластере с помощью Parallel Computing Toolbox™.

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

Темы

Введенный в R2014b

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

Поддержка

`X` Данные, чтобы распределить среди интервалов
вектор | матрица | многомерный массив

`C` Категориальные данные
категориальный массив

`nbins` Количество интервалов
положительное целое число

`края` BinEdges
вектор

`Категории` Категории включены в гистограмму
массив ячеек из символьных векторов | категориальный вектор

`counts` — Bincounts
вектор

`ax` — Целевые оси
Объект `Axes` | объект `PolarAxes`

`BarWidth` Относительная ширина категориальных панелей
`0.9` (значение по умолчанию) | скаляр в области значений `[0,1]`

`'BinLimits'` 'BinLimits'
двухэлементный вектор

`BinLimitsMode` Режим выбора для пределов интервала
`'auto'` (значение по умолчанию) | `'manual'`

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

`BinWidth` Ширина интервалов
скаляр

`DisplayOrder` Порядок отображения категории
`'data'` (значение по умолчанию) | `'ascend'` | `'descend'`

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

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

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

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

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

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

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

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

`'NumDisplayBins'` Количество категорий, чтобы отобразиться
скаляр

`'Orientation'` — Ориентация панелей
`'vertical'` (значение по умолчанию) | `'horizontal'`

`'ShowOthers'` Переключите итоговое отображение данных, принадлежащих неотображенным категориям
`'off'` (значение по умолчанию) | `'on'`

`h` Гистограмма
объект

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

Массивы графического процессора
Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.

Распределенные массивы
Большие массивы раздела через объединенную память о вашем кластере с помощью Parallel Computing Toolbox™.