polarhistogram

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

Описание

пример

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

пример

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

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

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

пример

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

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

пример

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

Примеры

свернуть все

Создайте вектор значений от 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. The axes contains an object of type histogram. This object represents theta.

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

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

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

Создайте гистограмму, график в полярных координатах, а затем измените ее внешний вид. Задайте штриховые цвета путем установки 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. The axes contains an object of type histogram. This object represents theta.

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

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

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

h = 
  Histogram with properties:

             Data: [100000x1 double]
           Values: [1x25 double]
          NumBins: 25
         BinEdges: [1x26 double]
         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. The axes contains an object of type histogram. This object represents theta.

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

свернуть все

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

Значения, которые соответствуют одному и тому же направлению угла, различаются точно на 2, и сортируются в один и тот же интервал. polarhistogram не включает NaN, Inf, и -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, затем polarhistogram автоматически вычисляет, сколько интервалов использовать на основе значений в theta.

Пример: nbins = 15;

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

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

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

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

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

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

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

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

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

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

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

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

Ширина в верхней части интервалов, заданная как скаляр менее 2,

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

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

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

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

Схема нормализации по умолчанию. Высота каждой полосы - это количество наблюдений в каждом интервале. Сумма высот штриха numel(theta).

'probability'

Высота каждой планки является относительным количеством наблюдений. Каждая высота вычисляется как (количество наблюдений в интервале/общее количество наблюдений). Сумма высот штриха 1.

'countdensity'

Высота каждой полосы - это количество наблюдений в интервале/ширине интервала.

'pdf'

Оценка функции плотности вероятностей. Высота каждой полосы равна (количество наблюдений в интервале )/( общее количество наблюдений * ширина интервала). Площадь каждого бруса является относительным количеством наблюдений. Сумма штриховых областей 1.

'cumcount'

Высота каждой полосы - это совокупное количество наблюдений в каждом интервале и всех предыдущих интервалах. Высота последней полоски numel(theta).

'cdf'

Оценка функции кумулятивной плотности. Высота каждой полосы равна совокупному относительному количеству наблюдений в интервале и всех предыдущих интервалах. Высота последней полоски 1.

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

Стиль отображения гистограммы, заданный как одно из следующих значений:

  • 'stairs' - Отображать только контур гистограммы.

  • 'bar' - Показать каждый отдельный бар с заполненным интерьером.

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

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

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

Цвет гистограммы, заданный как '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 не поддерживает создание гистограмм категориальных данных в полярных осях.

Введенный в R2016b