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)

Скрипт Open Live Script

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

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

Скрипт 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);

Скрипт Open Live Script

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

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

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';

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

свернуть все

Данные, чтобы распределить среди интервалов, заданных как вектор или матрица. 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 должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

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

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

Пределы интервала, заданные как двухэлементный вектор формы [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.

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

  • лестница Отобразите схему гистограммы только.

  • панель Покажите каждую отдельную панель с заполненной внутренней частью.

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

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

Функции

Свойства

Введенный в R2017b

Документация MATLAB
Поддержка
Для просмотра документации необходимо авторизоваться на сайте