exponenta event banner

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

Примеры

свернуть все

Создайте вектор значений от 0 до . Создайте гистограмму, на которой будут показаны данные, отсортированные по шести ячейкам.

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