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

polarhistogram

График гистограммы в полярных координатах

свернуть все на странице

Синтаксис

polarhistogram(theta)

polarhistogram(theta,nbins)

polarhistogram(theta,edges)

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

polarhistogram(___,Name,Value)

polarhistogram(pax,___)

h = polarhistogram(___)

Описание

polarhistogram(theta) создает график гистограммы в полярных координатах путем сортировки значений в theta в равномерно распределенные интервалы. Задайте значения в радианах.

polarhistogram(theta,nbins) использует количество интервалов, заданных положительным целым числом, nbins.

polarhistogram(theta,edges) виды theta в интервалы с границами интервала, заданными вектором, edges. Все интервалы включают левый край, но только последний интервал включает правый край. Другими словами, последний интервал включает оба ребра.

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

polarhistogram(___,Name,Value) задает дополнительные опции с помощью одного или нескольких аргументов пары "имя-значение". Например, можно использовать полупрозрачные панели путем определения 'FaceAlpha' и скалярное значение между 0 и 1.

polarhistogram(pax,___) графики в полярные оси заданы pax вместо в текущую систему координат.

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

Примеры

свернуть все

Создавание графика гистограммы в полярных координатах

Скрипт Open Live Script

Создайте вектор из значений между 0 и $2 π$ . Создайте график гистограммы, который показывает данные, отсортированные в шесть интервалов.

theta = [0.1 1.1 5.4 3.4 2.3 4.5 3.2 3.4 5.6 2.3 2.1 3.5 0.6 6.1];
polarhistogram(theta,6)

Figure contains an axes object. The axes object contains an object of type histogram. This object represents theta.

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

Скрипт Open Live Script

Создайте график гистограммы из 100 000 значений между $- π$ и $π$ , и вид данные в 25 интервалов.

theta = atan2(rand(100000,1)-0.5,2*(rand(100000,1)-0.5));
polarhistogram(theta,25);

Figure contains an axes object. The axes object contains an object of type histogram. This object represents theta.

Изменение внешнего вида графика гистограммы

Скрипт Open Live Script

Создайте график гистограммы в полярных координатах, и затем измените его внешний вид. Задайте цвета панели путем установки FaceColor свойство к вектору символов названия цвета, такого как 'red', или триплет RGB. Задайте прозрачность путем установки FaceAlpha свойство к значению между 0 и 1.

theta = atan2(rand(100000,1)-0.5,2*(rand(100000,1)-0.5));
polarhistogram(theta,25,'FaceColor','red','FaceAlpha',.3);

Figure contains an axes object. The axes object contains an object of type histogram. This object represents theta.

Изменение внешнего вида графика гистограммы после создания

Скрипт Open Live Script

Создайте график гистограммы в полярных координатах. Присвойте объект гистограммы переменной h.

theta = atan2(rand(100000,1)-0.5,2*(rand(100000,1)-0.5));
h = polarhistogram(theta,25)

Figure contains an axes object. The axes object contains an object of type histogram. This object represents theta.

h = 
  Histogram with properties:

             Data: [100000x1 double]
           Values: [6232 7236 4699 2717 1908 1641 1622 1755 2207 3463 ... ]
          NumBins: 25
         BinEdges: [-3.1416 -2.8903 -2.6389 -2.3876 -2.1363 -1.8850 ... ]
         BinWidth: 0.2513
        BinLimits: [-3.1416 3.1416]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0 0 0]

  Show all properties

Используйте h получить доступ и изменить свойства объекта гистограммы после того, как это создается. Например, покажите только схему гистограммы путем установки DisplayStyle свойство объекта гистограммы.

h.DisplayStyle = 'stairs';

Figure contains an axes object. The axes object contains an object of type histogram. This object represents theta.

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

свернуть все

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

Данные, чтобы распределить среди интервалов в виде вектора или матрицы. polarhistogram создает одну гистограмму, независимо от того, задаете ли вы вектор или матрицу. Задайте значения в радианах. Чтобы преобразовать степени в радианы, использовать deg2rad.

Значения, которые соответствуют тому же угловому направлению, отличаются точно 2π и сортируются в тот же интервал. polarhistogram не включает NaNInf, и -Inf значения в любом интервале.

Пример: theta = [0 0.4 0.5 0.7 2.3 3.0 1.7 0.3];

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

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

Пример: nbins = 15;

`edges` BinEdges
вектор

Границы интервала в виде вектора. Различие между минимальными и максимальными значениями ребра должно быть меньше чем или равно 2π.

Пример: polarhistogram('BinEdges',[0 pi/3 pi 3*pi/2 2*pi],'BinCounts',[5 3 4 6])

`counts` bincounts
вектор

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

Пример: polarhistogram('BinEdges',[0 pi/3 pi 3*pi/2 2*pi],'BinCounts',[5 3 4 6])

`pax` `polaraxes` объект
`PolarAxes` объект

PolarAxes объект. Если вы не задаете полярные оси, то polarhistogram использует текущую систему координат. polarhistogram не поддерживает графический вывод в Оси декартовой системы координат.

Аргументы name-value

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

Пример: polarhistogram(theta,'FaceAlpha',0.3) создает график гистограммы с полупрозрачными панелями.

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

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

Интервал ограничивает в виде двухэлементного вектора из формы [bmin,bmax], где bmin меньше bmax.

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

Пример: polarhistogram(theta,'BinLimits',[-pi/2 pi/2]) строит гистограмму с помощью только значения в theta это между -pi/2 и pi/2 включительно.

`BinWidth` — Ширина по верху интервалов
скаляр меньше, чем 2π

Ширина через верхнюю часть интервалов в виде скаляра меньше, чем 2π.

polarhistogram использует максимум 65 536 интервалов (или 2¹⁶). Если заданная ширина интервала требует большего количества интервалов, то polarhistogram использует максимальное количество интервалов, и настройте ширину интервала соответственно.

Пример: polarhistogram(theta,'BinWidth',pi) интервалы использования с шириной π.

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

Тип нормализации в виде одного из значений в этой таблице.

Значение	Описание
`'count'`	Схема нормализации по умолчанию. Высота каждой панели является количеством наблюдений в каждом интервале. Суммой высот панели является `numel(theta)`.
`'probability'`	Высота каждой панели является относительным количеством наблюдений. Каждая высота вычисляется как (количество наблюдений в интервале/общем количестве наблюдений). Суммой высот панели является `1`.
`'countdensity'`	Высота каждой панели является количеством наблюдений в интервале/ширине интервала.
`'pdf'`	Оценка функции плотности вероятности. Высота каждой панели (количество наблюдений в интервале) / (общее количество наблюдений * ширина интервала). Областью каждой панели является относительное количество наблюдений. Суммой баров является `1`.
`'cumcount'`	Высота каждой панели является совокупным числом наблюдений в каждом интервале и всех предыдущих интервалах. Высотой последней панели является `numel(theta)`.
`'cdf'`	Совокупная оценка функции плотности. Высота каждой панели равна совокупному относительному количеству наблюдений в интервале и всех предыдущих интервалах. Высотой последней панели является `1`.

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

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

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

'stairs' — Отобразите схему гистограммы только.
'bar' — Покажите каждую отдельную панель с заполненной внутренней частью.

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

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

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

Пример: polarhistogram(theta,'FaceAlpha',.5) создает график гистограммы с полупрозрачными панелями.

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

Панель гистограммы окрашивает в виде 'auto', триплет RGB, шестнадцатеричный цветовой код, название цвета или краткое название. Значение по умолчанию 'auto' позволяет гистограмме выбрать цвет.

Для пользовательского цвета задайте триплет 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'`
`'none'`	Не применяется	Не применяется	Не применяется	Нет цвета

Вот являются триплеты 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'то polarhistogram не использует FaceColor свойство.

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

Ограничения

polarhistogram не поддерживает гистограммы создания категориальных данных в полярных осях.

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

Функции

polarscatter | polarplot | histogram

Свойства

Histogram Properties | PolarAxes Properties

Введенный в R2017b

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

Поддержка